mirror of https://github.com/logos-messaging/nim-ffi.git synced 2026-06-21 08:49:34 +00:00

History

fix(codegen): emit 3-arg async destroy ABI in C++/Rust bindings

The recycle/async-destroy work changed the Nim `ffiDtor` export from
`int destroy(ctx)` to `int destroy(ctx, callback, userData)`, but the C++
and Rust generators still emitted the 1-arg signature. Foreign callers
therefore passed only `ctx`; inside Nim, `callback`/`userData` held
uninitialised register garbage. `requestRecycle` stored the garbage
callback and the recycle handler later invoked it — a jump through a wild
pointer that segfaulted in every C++ E2E / ASan / TSan job (the crash
surfaced at teardown, after each test's assertions had already passed).

Generate the 3-arg ABI and have the destructor/Drop block on the recycle
callback via the existing sync-call helper, so the pool slot is fully
drained and parked before the handle goes away — otherwise rapid
create/destroy churn (StressShortLivedPerThreadContext, ThreadedHammer)
could outrun the recycle and exhaust the pool.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-12 16:12:33 +02:00

examples

refactor(ffi): event thread scaffolding + FFIContext lifecycle split (#71 )

2026-06-08 11:46:16 -03:00

src

fix(codegen): emit 3-arg async destroy ABI in C++/Rust bindings

2026-06-12 16:12:33 +02:00

build.rs

fix(ffi): set up foreign-thread GC in entry procs; recycle/event cleanup

2026-06-12 11:28:48 +02:00

Cargo.lock

Rust event examples (#53 )

2026-06-01 13:34:56 -03:00

Cargo.toml

Rust event examples (#53 )

2026-06-01 13:34:56 -03:00

README.md

Add basic cpp e2e tests (#27 )

2026-05-19 12:43:34 +02:00

README.md

Rust Bindings for nim-timer

Purpose

This folder contains auto-generated Rust bindings (the my_timer crate) for the my_timer Nim library. It is generated from ../timer.nim and provides:

src/lib.rs: Main library exposing high-level Rust types and the MyTimerCtx API
src/api.rs: High-level async/sync wrapper around the FFI
src/ffi.rs: Raw extern "C" declarations for the Nim library
src/types.rs: Serializable Rust types matching the Nim FFI types
build.rs: Build script that compiles the Nim library to libmy_timer.dylib (or .so/.dll)
Cargo.toml: Package manifest with serde and serde_json dependencies

How It's Generated

Generate or regenerate these bindings by running from the parent directory:

cd examples/timer
nimble genbindings_rust

This command:

Invokes the Nim compiler with -d:targetLang:rust flag
Triggers genBindings("examples/timer/rust_bindings", "../timer.nim") in timer.nim
Creates/updates the generated binding files

Using as a Dependency

The rust_client example consumes this crate:

[dependencies]
my_timer = { path = "../rust_bindings" }

Do Not Edit

The generated files in this folder are overwritten each time nimble genbindings_rust runs. Any manual changes will be lost.