1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
## Publishing a new version
- Push the code
- Once the pipeline is green, `git tag vx.x.x`
- `git push --tags`
## kdev
`go run github.com/martinlehoux/kagamigo/cmd/kdev --repo=<repo>`
- [ ] Ignore bin files or too large
- [ ] Ignore regex
- [ ] Parallel
- [ ] Log level
## ki18n
- [ ] Add gettext to CI
- [ ] Add time handling
### Setup
1. Call `ki18n.Init(localesFS)` at startup with a filesystem containing `<lang>/*.yml` translation files.
2. Register `ki18n.LangMiddleware(...)` on your router, passing one or more strategies in priority order.
3. Run `go run github.com/martinlehoux/kagamigo/cmd/gettext -write` to generate translation files.
4. Complete the generated files.
### Language detection strategies
```go
// Detect from a cookie named "lang", then fall back to Accept-Language header
ki18n.LangMiddleware(
ki18n.CookieStrategy("lang"),
ki18n.AcceptLanguageStrategy,
)
```
Built-in strategies:
- `ki18n.CookieStrategy(name string)` — reads the named cookie
- `ki18n.AcceptLanguageStrategy` — parses the `Accept-Language` request header
If no strategy resolves a language, the middleware falls back to `en-GB`.
### Translating in templ files
```go
// ctx is the context passed to your templ component
@ki18n.Tr(ctx, "Hello %s", userName)
```
If the key is not found in the resolved language, the format string itself is returned.
## web
- [ ] Use reflection add startup time to add metadata to logging
- [ ] Save aggregate + an event with time & actor (event streaming)
## kcore
```go
handler.HandleFunc("GET /", func(w http.ResponseWriter, r *http.Request) {
kcore.RenderPage(r.Context(), pages.HomePage(), w)
})
```
```go
block, err := aes.NewCipher(secret)
kcore.Expect(err, "error creating AES cipher")
```
## kauth
- [ ] Auto logout for some errors (unreachable user, expired)
- [ ] Revisit the login and signup flow
|
