feat(stdlib): Jobs, Promises & opt-in Sync concurrency (#14)
A layered concurrency library, safe by default. The recommended tier is Job.* / Promise.*: a Job is a future — Job.run(kind, arg) starts a cooperative background compute that advances each Job.pump(budget) and finishes after enough frames (heavy work spreads out instead of hitching), or Job.defer + Job.fulfill/fail/cancel drives one by hand. Poll with done/ok/failed/cancelled, read result/error, count outstanding work with Job.pending. Promise.all/race combine handle lists into a group job resolved on the main thread; Promise.count_done/all_done power a loading bar. The advanced, opt-in Sync.* tier (mutex/atomic/channel + cpu_count) is the "here be dragons" surface for engine-level message passing. The whole thing is a deterministic cooperative scheduler: results are collected on the main thread and a Job never touches the ECS world, so lockstep and replays stay bit-exact — same jobs + same budget reproduce byte-for-byte on every target, and a preemptive OS-thread backend can slot behind this same API later. Ludic has no closures, so a Job carries a compute kind + int arg (or a hand-driven defer) rather than fn()->…, and Promise progress is polled rather than chained through then. Written in Ludic and spliced on demand (like Regex/Dict/Numeric): a program that never mentions Job.*/Promise.*/Sync.* compiles byte-identically and the C-free bootstrap fixpoint is untouched. New: runtime/native/jobs.ludic, emit_ns_call dispatch, parse-time splice, examples/library/jobs.ludic (31 self-asserting checks), 33 docs pages + inventory, changeset. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
872f458cb2
commit
50ecb8472f
44 changed files with 25637 additions and 22806 deletions
|
|
@ -437,6 +437,45 @@
|
|||
"set-clear",
|
||||
"set-members"
|
||||
],
|
||||
"job": [
|
||||
"job-defer",
|
||||
"job-run",
|
||||
"job-fulfill",
|
||||
"job-fail",
|
||||
"job-cancel",
|
||||
"job-pump",
|
||||
"job-done",
|
||||
"job-ok",
|
||||
"job-failed",
|
||||
"job-cancelled",
|
||||
"job-result",
|
||||
"job-error",
|
||||
"job-pending",
|
||||
"job-free"
|
||||
],
|
||||
"promise": [
|
||||
"promise-all",
|
||||
"promise-race",
|
||||
"promise-count_done",
|
||||
"promise-all_done"
|
||||
],
|
||||
"sync": [
|
||||
"sync-mutex",
|
||||
"sync-lock",
|
||||
"sync-unlock",
|
||||
"sync-try_lock",
|
||||
"sync-atomic",
|
||||
"sync-get",
|
||||
"sync-set",
|
||||
"sync-add",
|
||||
"sync-cas",
|
||||
"sync-channel",
|
||||
"sync-send",
|
||||
"sync-recv",
|
||||
"sync-can_recv",
|
||||
"sync-len",
|
||||
"sync-cpu_count"
|
||||
],
|
||||
"huge": [
|
||||
"huge-from",
|
||||
"huge-add",
|
||||
|
|
|
|||
|
|
@ -196,6 +196,7 @@ function cmd_test() -> int {
|
|||
feat_case("library/bignum", "", "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16", "bignum.ludic (BigInt arbitrary-precision + Decimal exact base-10 money)")
|
||||
feat_case("library/containers", "", "1 2 3 4 5 6 7 8 9 10 11 12 13 14", "containers.ludic (Dict string-keyed hash map + Set string set)")
|
||||
feat_case("library/numeric", "", "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20", "numeric.ludic (Huge idle big-numbers + Angle wrapping radians + Percent clamped [0,1])")
|
||||
feat_case("library/jobs", "", "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", "jobs.ludic (Job background compute/defer/fulfill/cancel + Promise all/race/progress + Sync mutex/atomic/channel; issue #14)")
|
||||
feat_case("library/optionresult", "", "1 2 3 4 5 6 7 8 9 10 11 12", "optionresult.ludic (option some/none + result ok/err/try safety types)")
|
||||
feat_case("library/regex", "", "1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18", "regex.ludic (Regex match/find/groups/classes/quantifiers/replace + linear-time safety)")
|
||||
feat_case("library/grid", "", "1 2 3 4 5 6 7 8 9 10 11 12 13", "grid.ludic (Grid line/flood/line_of_sight + A* pathfinding over the tilemap)")
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue