v0.3.0 9fdf386

features.go RawHistoryFolder

1// SPDX-License-Identifier: AGPL-3.0-or-later
2
3package client
4
5import "slices"
6
7// Contract features this client relies on, as listed by
8// ServerService.GetVersion. A server without one still works for everything
9// else: the CLI warns instead of failing.
10const (
11	// FeatureRepoUpdate is RepoService.UpdateRepo (`ermite repo edit`).
12	FeatureRepoUpdate = "repo.update"
13	// FeatureEventsResume is EventService.Watch with resume_after, which
14	// `ermite watch` uses to continue after a reconnection.
15	FeatureEventsResume = "events.resume"
16	// FeatureMergeRequests is MergeRequestService (`ermite mr`).
17	FeatureMergeRequests = "merge_requests"
18	// FeatureSigningKey is ServerService.GetSigningKey (`ermite signing-key`).
19	FeatureSigningKey = "signing_key"
20	// FeatureSession is SessionService (`ermite web login`, `web logout`).
21	FeatureSession = "session"
22)
23
24// UsedFeatures lists the features the CLI uses, in the order they are reported.
25func UsedFeatures() []string {
26	return []string{FeatureRepoUpdate, FeatureEventsResume, FeatureMergeRequests, FeatureSigningKey, FeatureSession}
27}
28
29// MissingFeatures returns the features the CLI uses that have is lacking.
30func MissingFeatures(have []string) []string {
31	var missing []string
32	for _, f := range UsedFeatures() {
33		if !slices.Contains(have, f) {
34			missing = append(missing, f)
35		}
36	}
37	return missing
38}

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 45

↑↓ moveenter openesc close