v0.2.0 6e0cddc

keyboard_test.go RawHistoryFolder

1package keyboard
2
3import (
4	"os"
5	"testing"
6	"time"
7
8	"github.com/bnema/purego-xkbcommon/raw"
9)
10
11func TestLayoutsAndRepeat(t *testing.T) {
12	k := requiredKeyboard(t, "en_US.UTF-8")
13	defer k.Close()
14	now := time.Now()
15	for _, tc := range []struct {
16		layout string
17		code   uint32
18		want   string
19	}{{"us", 16, "q"}, {"fr", 16, "a"}, {"de", 21, "z"}} {
20		if err := k.Rules(tc.layout, ""); err != nil {
21			t.Fatal(err)
22		}
23		key, err := k.Event(tc.code, true, now)
24		if err != nil || key.Text != tc.want || key.Physical != tc.code || key.Logical == 0 {
25			t.Fatalf("%s: %+v %v", tc.layout, key, err)
26		}
27		k.Event(tc.code, false, now)
28	}
29	if err := k.Rules("de", ""); err != nil {
30		t.Fatal(err)
31	}
32	idx, err := k.keymap.ModIndex("Mod5")
33	if err != nil {
34		t.Fatal(err)
35	}
36	if err := k.Mask(1<<idx, 0, 0, 0, 0, 0); err != nil {
37		t.Fatal(err)
38	}
39	key, err := k.Event(18, true, now)
40	if err != nil || key.Text != "€" {
41		t.Fatalf("AltGr: %+v %v", key, err)
42	}
43	k.Event(18, false, now)
44	k.Mask(0, 0, 0, 0, 0, 0)
45	k.RepeatInfo(20, 300*time.Millisecond)
46	k.Event(16, true, now)
47	if _, ok := k.Tick(now.Add(299 * time.Millisecond)); ok {
48		t.Fatal("early repeat")
49	}
50	if _, ok := k.Tick(now.Add(300 * time.Millisecond)); !ok {
51		t.Fatal("missing repeat")
52	}
53	k.Focus(false)
54	if _, ok := k.Tick(now.Add(time.Second)); ok {
55		t.Fatal("repeat after focus loss")
56	}
57	k.Focus(true)
58	k.Event(16, true, now)
59	k.Event(16, false, now)
60	if _, ok := k.Tick(now.Add(time.Second)); ok {
61		t.Fatal("repeat after release")
62	}
63}
64func TestComposeAndGroups(t *testing.T) {
65	k := requiredKeyboard(t, "en_US.UTF-8")
66	var err error
67	defer k.Close()
68	if err = k.Rules("de", ""); err != nil {
69		t.Fatal(err)
70	}
71	now := time.Now()
72	dead, err := k.Event(41, true, now)
73	if err != nil || dead.Logical != raw.XKB_KEY_dead_circumflex || dead.Text != "" {
74		t.Fatalf("dead: %+v %v", dead, err)
75	}
76	k.Event(41, false, now)
77	composed, err := k.Event(18, true, now)
78	if err != nil || composed.Text != "ê" {
79		t.Fatalf("compose: %+v %v", composed, err)
80	}
81	if err = k.Rules("us,fr", ""); err != nil {
82		t.Fatal(err)
83	}
84	if err = k.Mask(0, 0, 0, 0, 0, 1); err != nil {
85		t.Fatal(err)
86	}
87	grouped, err := k.Event(16, true, now)
88	if err != nil || grouped.Text != "a" || grouped.Group != 1 {
89		t.Fatalf("group: %+v %v", grouped, err)
90	}
91}
92
93func TestKeymapFDReplacement(t *testing.T) {
94	k := requiredKeyboard(t, "")
95	var err error
96	defer k.Close()
97	if err = k.Rules("us", ""); err != nil {
98		t.Fatal(err)
99	}
100	// A malformed regular file must be consumed without discarding the old map.
101	f, err := os.CreateTemp(t.TempDir(), "bad-keymap")
102	if err != nil {
103		t.Fatal(err)
104	}
105	if _, err = f.WriteString("bad keymap"); err != nil {
106		t.Fatal(err)
107	}
108	if err = k.ReplaceFD(int(f.Fd()), len("bad keymap")); err == nil {
109		t.Fatal("bad keymap accepted")
110	}
111	if _, err = f.Stat(); err == nil {
112		t.Fatal("keymap FD not closed")
113	}
114	if err = k.ReplaceFD(-1, 0); err == nil {
115		t.Fatal("invalid fd accepted")
116	}
117	key, err := k.Event(16, true, time.Now())
118	if err != nil || key.Text != "q" {
119		t.Fatalf("old map lost: %+v %v", key, err)
120	}
121	k.Event(16, false, time.Now())
122}
123
124func TestValidFDReplacementCancelsRepeat(t *testing.T) {
125	k := requiredKeyboard(t, "")
126	defer k.Close()
127	if err := k.Rules("us", ""); err != nil {
128		t.Fatal(err)
129	}
130	now := time.Now()
131	k.RepeatInfo(20, 100*time.Millisecond)
132	press, err := k.Event(16, true, now)
133	if err != nil || press.Text != "q" {
134		t.Fatalf("old map press: %+v %v", press, err)
135	}
136	data, err := os.ReadFile("testdata/fr.xkb")
137	if err != nil {
138		t.Fatal(err)
139	}
140	file, err := os.CreateTemp(t.TempDir(), "keymap")
141	if err != nil {
142		t.Fatal(err)
143	}
144	if _, err = file.Write(append(data, 0)); err != nil {
145		t.Fatal(err)
146	}
147	if err = k.ReplaceFD(int(file.Fd()), len(data)+1); err != nil {
148		t.Fatal(err)
149	}
150	if _, err = file.Stat(); err == nil {
151		t.Fatal("FD not consumed")
152	}
153	if _, ok := k.Tick(now.Add(time.Second)); ok {
154		t.Fatal("repeat survived keymap replacement")
155	}
156	if _, ok := k.NextRepeat(); ok {
157		t.Fatal("repeat deadline survived replacement")
158	}
159	key, err := k.Event(16, true, now)
160	if err != nil || key.Text != "a" {
161		t.Fatalf("new map press: %+v %v", key, err)
162	}
163}
164
165// Required offline gate: only explicitly opted-out hosts may skip libxkbcommon.
166func requiredKeyboard(t *testing.T, locale string) *Keyboard {
167	t.Helper()
168	k, err := New(locale)
169	if err != nil {
170		if os.Getenv("NEFERGUI_SKIP_XKB") == "1" {
171			t.Skipf("xkb unavailable: %v", err)
172		}
173		t.Fatal(err)
174	}
175	return k
176}
177
178func TestRepeatTracksCurrentMaskAndCompose(t *testing.T) {
179	k := requiredKeyboard(t, "en_US.UTF-8")
180	defer k.Close()
181	if err := k.Rules("us,fr", ""); err != nil {
182		t.Fatal(err)
183	}
184	now := time.Now()
185	k.RepeatInfo(10, 100*time.Millisecond)
186	press, err := k.Event(16, true, now)
187	if err != nil || press.Text != "q" {
188		t.Fatalf("press: %+v %v", press, err)
189	}
190	shift, err := k.keymap.ModIndex("Shift")
191	if err != nil {
192		t.Fatal(err)
193	}
194	if err = k.Mask(1<<shift, 0, 0, 0, 0, 0); err != nil {
195		t.Fatal(err)
196	}
197	rep, ok := k.Tick(now.Add(100 * time.Millisecond))
198	if !ok || rep.Text != "Q" || rep.Logical != raw.XKB_KEY_Q || !rep.Repeat || !rep.Shift || rep.Ctrl {
199		t.Fatalf("shift repeat: %+v %t", rep, ok)
200	}
201	if err = k.Mask(0, 0, 0, 0, 0, 1); err != nil {
202		t.Fatal(err)
203	}
204	rep, ok = k.Tick(now.Add(200 * time.Millisecond))
205	if !ok || rep.Text != "a" || rep.Group != 1 {
206		t.Fatalf("layout repeat: %+v %t", rep, ok)
207	}
208	k.Focus(false)
209	k.Focus(true)
210	if err = k.Rules("de", ""); err != nil {
211		t.Fatal(err)
212	}
213	k.Event(41, true, now)
214	k.Event(41, false, now)
215	// A repeat must not replay the composed press-time character.
216	composed, err := k.Event(18, true, now)
217	if err != nil || composed.Text != "ê" {
218		t.Fatalf("compose press: %+v %v", composed, err)
219	}
220	rep, ok = k.Tick(now.Add(100 * time.Millisecond))
221	if !ok || rep.Text != "e" {
222		t.Fatalf("post-compose repeat: %+v %t", rep, ok)
223	}
224}

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 1

Tags 12

↑↓ moveenter openesc close