Skip to content

AlxLib 1.5.0

Choose a tag to compare

@AlexisVon AlexisVon released this 05 Nov 05:51
· 1 commit to main since this release

Minor release — asynchronous delivery gains a delay, a management clear and nested service, with the host's priority band reserved.

Deliveries can be delayed: engine::yield and fwrap::callback::call take _delay_ms. A delayed delivery is stamped with its not-before time at enqueue, cannot be taken before it, and is made eligible by the heartbeat pass — which now also wakes a waiting yield(ms) window, so the window picks the delivery up at the delay instead of its own deadline. Expiry still counts from submission and can end a delivery before its delay does; timer precision is the heartbeat's period (no earlier than the delay, typically within 50 ms of it).

Queue management: engine::clr_yield(_priority, _maxcnt) settles queued deliveries without running them — oldest first, priority <= _priority, at most _maxcnt (0 = unlimited), each as YieldError("cleared"), and only while a run is in progress. The in-flight delivery is unaffected. The currying handle exposes the same clear as drop, clamped to the host-reserved band.

Nested service: a serviced call may call yield() itself and service the queue — the Qt processEvents pattern. Each level saves and restores the previous frame stack, so the caller's locals survive and the nested call still runs root-pose; each level keeps its own window, maxcnt and return count. engine_config::yield_nest caps the levels (default 64; 0 = unlimited); the level past the cap is the catchable script-level YieldError("nested yield").

The host's band is reserved: engine_config::yield_rsvprio marks every priority above it as host-only; a currying handle clamps both its delivery priority and its drop threshold down to it (default max_uint_32, so nothing is reserved until the host asks). The engine's own yield / clr_yield are unclamped, and fwrap itself carries no queue management.

Renames: engine_config::max_yield / set_max_yield are now yield_limit / set_yield_limit.

No opcode or AST change: vtype is untouched and .axp products need no recompilation. The minor release moves the SONAME to .so.1.5, so every host and link module must be rebuilt.

Build packages — AlxLib-1.5.0-linux-x64-geb3a68e-slim.tar.gz (+ .sha256): the public headers, the merged static library (lib/libalxlib.a) and the notices; the shared libraries and per-module archives stay in the developer package and are not published. No Windows packages accompany this release.