File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change 1+ // SPDX-License-Identifier: PMPL-1.0-or-later
2+ // Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+ = LOL v-gateway — V-lang Deprecated (2026-04-12)
4+ :toc:
5+
6+ == Status
7+
8+ The V-lang implementation in `src/` is *deprecated* as of 2026-04-12
9+ following the estate-wide V-lang ban (2026-04-10).
10+
11+ == Migration Target: Zig
12+
13+ The canonical replacement is the Zig gateway at `../zig-gateway/`:
14+
15+ [source,bash]
16+ ----
17+ # From standards/lol/api/zig-gateway/
18+ zig build
19+ ./zig-out/bin/lol-gateway
20+ ----
21+
22+ The Zig gateway is a three-port listener matching the V layout:
23+
24+ [cols="1,1,1"]
25+ |===
26+ | Mount | Port | V source
27+
28+ | REST | `LOL_PORT` (default 7800) | `src/main.v` (REST routes)
29+ | gRPC | `LOL_PORT+1` (default 7801) | `src/main.v` (gRPC listener)
30+ | GraphQL | `LOL_PORT+2` (default 7802) | `src/main.v` (GraphQL listener)
31+ |===
32+
33+ == Next Steps
34+
35+ . Confirm `zig-gateway` handles `/api/v1/languages`, `/api/v1/corpus`,
36+ `/api/v1/crawl`, and `/api/v1/health`.
37+ . Update `compose.yml` (if any) to replace the V container.
38+ . Once confirmed healthy, delete `src/*.v` and `v.mod`.
Original file line number Diff line number Diff line change 1+ // SPDX-License-Identifier: PMPL-1.0-or-later
2+ // Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+ = LOL v-lol — V-lang Deprecated (2026-04-12)
4+ :toc:
5+
6+ == Status
7+
8+ The V-lang LOL API bindings in `src/` are *deprecated* as of 2026-04-12
9+ following the estate-wide V-lang ban (2026-04-10).
10+ The source was already sidelined (see `src/SIDELINED.adoc`).
11+
12+ == Migration Target: Zig FFI
13+
14+ `v-lol` wrapped `liblol` (the LOL i18n Zig FFI library) with idiomatic V types.
15+ The canonical replacement is the Zig FFI directly at `../zig-gateway/` which
16+ links `liblol` without a V shim layer.
17+
18+ [cols="1,1"]
19+ |===
20+ | V module (deprecated) | Replacement
21+
22+ | `src/lol.v` | `../zig-gateway/src/lol_ffi.zig` (direct Zig call)
23+ | `src/types.v` | `../zig-gateway/src/types.zig`
24+ | `src/ffi.v` | `../zig-gateway/src/` (FFI inlined)
25+ |===
26+
27+ == Next Steps
28+
29+ . Confirm `zig-gateway` compiles and links `liblol` successfully.
30+ . Delete `src/*.v` and `v.mod` once zig-gateway is healthy.
You can’t perform that action at this time.
0 commit comments