Acme-Parataxis
view release on metacpan or search on metacpan
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [v0.1.4] - 2026-11-19
### Added
- Native AArch64 ELF and Mach-O fiber context-switch backends. Windows ARM64 continues to use the OS fiber API which is architecture-neutral.
### Fixed
- Android/Termux builds: removed a duplicate `PARA_HIDDEN` definition, switched CPU affinity to Bionic's `sched_setaffinity()` with a kernel TID, and stopped falling through to `getcontext`/`makecontext`/`swapcontext`, which Bionic does not expose.
- Removed the `endbr64` workaround from the x86-64 trampoline. I misunderstood how it addressed CET/IBT rather than OpenBSD Retguard and seems have only worked by coincidence. The supported Retguard and BTI linker flags remain in place.
- Fixed the shared-CV pad collision behind `Perl_pp_entersub` assertion failures (`AvFILLp(av) == -1`) on real concurrent HTTP tests. Parataxis now swaps per-fiber padlists at every context switch instead of trying to make one global `CvDEPTH` safe f...
- `t/255_http_mock_pool.t` no longer wraps pad-collision failures in a TODO block (let's see how far that gets me...)
## [v0.1.3] - 2026-10-28
### Fixed
- Silly compiler fluff.
## [v0.1.2] - 2026-10-27
Trying to get 100% of CPAN smokers to pass tests I've run on a dozen other setups without failure because a solid green bar matters.
### Changed
- Only consider zombies within our parent pid in `t/031_spawn_blocking_fork.t`.
### Fixed
- Deal with Retguard on OpenBSD/clang with an `endbr64` instruction and proper compile and linker flags. The instruction is treated like a no-op on x64 CPUs without IBT.
## [v0.1.1] - 2026-10-25
Borrowing patterns from Rust, Erlang, Java, etc. to bring more familiar concurrency primitives to Parataxis. No real changes to the core this time.
### Added
- `Acme::Parataxis::Blocking`: CPU offloading onto a bounded pool of cloned interpreters via `spawn_blocking` (lazily loads threads/shared modules on first use).
- `spawn_blocking_fork`: Process-based CPU offloading for non-ithreads Perls with IPC via `Storable`, bounded worker pools, and signal-based cancellation via `kill_blocking_fork`.
- `Acme::Parataxis::Actor`: Mailbox-driven actors with bounded queues, backpressure, `ask` (returning a `Future`), `send`, and graceful teardown.
- `Acme::Parataxis::Supervisor`: OTP-style supervision trees supporting `OneForOne`, `OneForAll`, and `RestForOne` restart strategies with configurable restart budgets.
- Synchronization primitives:
- `Acme::Parataxis::Sync::Mutex`: Non-reentrant lock with strict FIFO hand-off and ownership tracking.
- `Acme::Parataxis::Sync::RwLock`: Writer-preferring, reentrant read/write lock.
- `Acme::Parataxis::Sync::WaitGroup`: Fiber job counter (`add`, `done`, `wait`).
- `Acme::Parataxis::Sync::Barrier`: Reusable phase rendezvous point.
- `Acme::Parataxis::Sync::Once`: Race-safe, single-execution initializer.
- Structured concurrency & flow control:
- `nursery( sub ($n) { ... } )`: Structured fiber scopes where child errors cancel siblings and propagate outward.
- `pmap( { concurrency => $n, }, sub ( $item ) { ... }, @items )`: Parallel list mapping over a bounded fiber pool.
- `with_timeout( $ms, [ $token, ] $code )` and `with_cancel( $code )`: Cooperative deadline and cancellation scopes.
- `Acme::Parataxis::CancellationToken`: Cooperative park-interrupt token.
- `Acme::Parataxis::Local`: Fiber-local ambient storage.
- `Acme::Parataxis::Generator`: Stackful, lazy pull iterator.
- `Acme::Parataxis::Monitor`: Non-owning fiber observer.
- Channels & Streams:
- `Acme::Parataxis::Channel::select`: CSP-style waiting across multiple channels with random case selection to prevent starvation.
- `try_get` / `try_put` non-blocking channel operations and per-channel timeout configurations.
- `Acme::Parataxis::Stream`: Backpressure-driven channel pipelines (`map`, `filter`, `batch`, `batch_time`, `throttle`).
- `Acme::Parataxis::Ticker`: Drift-free interval timer.
- `Acme::Parataxis::RateLimiter`: Token bucket limiter driven by `Ticker`.
- Software Transactional Memory (STM): `Acme::Parataxis::TVar` cells and `atomically` transactions with conflict detection and `retry()`.
- Future combinators: `wait_all` and `wait_any`.
- Event loop & OS integration:
- Event loop drivers: `Acme::Parataxis::Driver::Mojo` and `Acme::Parataxis::Driver::IOAsync`.
- Transparent unblocking (`Acme::Parataxis::Compat`): Opt-in cooperative `CORE::GLOBAL` overrides for `sleep`, `read`, and `sysread`.
- Deterministic virtual clock via `run( virtual => 1 )` and `advance( $ms )`.
- Graceful shutdown handlers via `run( on_shutdown => ... )` for `SIGINT`/`SIGTERM`.
- `fd_setsize()` introspection helper.
- Diagnostics & Introspection:
( run in 0.654 second using v1.01-cache-2.11-cpan-1bcd28dbaf1 )