v0.6.0 d5cc8fe

refspage.go RawHistoryFolder

1// SPDX-License-Identifier: AGPL-3.0-or-later
2
3package web
4
5import (
6	"context"
7	"net/http"
8	"sort"
9
10	"github.com/a-h/templ"
11
12	pb "bnema.dev/ermite-api/gen/ermite"
13)
14
15// refs lists the branches and the tags of a repository with the commit each
16// designates: branches by name with the default first, tags newest first.
17func (s *Server) refs(ctx context.Context, r *http.Request) (templ.Component, int, error) {
18	d, err := s.loadRepo(ctx, r.PathValue("repo"))
19	if err != nil {
20		return nil, 0, err
21	}
22	p := s.refsPage(ctx, d)
23
24	l := s.repoLayout(ctx, d, "refs")
25	l.Title = "refs · " + d.name() + " · " + s.instance
26	l.Live, l.LiveURL = true, liveURL("repo:"+d.name(), "view=refs")
27	l.Crumbs[0].Current = false
28	l.Crumbs = append(l.Crumbs, Crumb{Label: "refs", Current: true})
29	l.HasRail = true
30	return Refs(l, p), http.StatusOK, nil
31}
32
33// refsPage is the content of the refs page, which the live updates of the
34// page render again.
35func (s *Server) refsPage(ctx context.Context, d *repoData) RefsPage {
36	commits := s.commitsOf(ctx, d.name(), d.allRefs())
37
38	def := d.repo.GetDefaultBranch()
39	p := RefsPage{Default: def}
40	branches := append([]*pb.Ref(nil), d.branches...)
41	sort.SliceStable(branches, func(i, j int) bool {
42		a, b := branches[i].GetShortName() == def, branches[j].GetShortName() == def
43		return a && !b
44	})
45	for i, b := range branches {
46		p.Branches = append(p.Branches, s.refRow(d, b, commits, b.GetShortName() == def, i == 0))
47	}
48	tags := append([]*pb.Ref(nil), d.tags...)
49	sort.SliceStable(tags, func(i, j int) bool {
50		return commits[tags[i].GetCommitId()].at > commits[tags[j].GetCommitId()].at
51	})
52	for i, t := range tags {
53		p.Tags = append(p.Tags, s.refRow(d, t, commits, false, len(p.Branches) == 0 && i == 0))
54	}
55	if len(tags) > 0 {
56		p.Latest = tags[0].GetShortName()
57	}
58	if d.cut {
59		p.Note = "this repository has more refs than are listed here."
60	}
61	return p
62}
63
64func (s *Server) refRow(d *repoData, r *pb.Ref, commits map[string]refCommit, isDefault, cursor bool) RefRow {
65	c := commits[r.GetCommitId()]
66	row := RefRow{
67		Name: r.GetShortName(), Href: repoHref(d.name(), "tree", r.GetShortName()),
68		Short: short(r.GetCommitId()), Subject: c.subject, When: c.when, WhenAt: c.whenAt,
69		Default: isDefault, Cursor: cursor,
70	}
71	if r.GetCommitId() != "" {
72		row.CHref = repoHref(d.name(), "commit", r.GetCommitId())
73	}
74	return row
75}

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 4

Tags 45

↑↓ moveenter openesc close