mirror of https://github.com/logos-messaging/nim-ffi.git synced 2026-06-20 16:29:31 +00:00

History

feat(ffi): native event delivery + dual-ABI event symbol naming

Events now mirror the native/CBOR split already in place for requests, with the
same symbol-naming convention:

- `<lib>_add_event_listener`      -> NATIVE listener (typed `<T>Pod` by pointer)
- `<lib>_add_event_listener_cbor` -> CBOR listener (EventEnvelope bytes)

Framework: `FFIEventListener` gains a `native` flag; `addEventListener` a
`native` param; a new `dispatchFFIEventDual` template builds the `<T>Pod` once
for native listeners (`nimToPod`/`freePod`) and the CBOR envelope once for the
rest, fanning each out — so a single `{.ffiEvent.}` dispatch serves both kinds.
`declareLibrary` exports both registration entry points.

Generators: the bare `<lib>_add_event_listener` is the native symbol; every
CBOR consumer (C/C++/Go/Rust) now targets `<lib>_add_event_listener_cbor`. The
rename and the generator updates ship together so the bare name is never briefly
broken. Bindings regenerated.

Validated: native-event unit test (typed POD to native + CBOR to cbor listener,
orc/refc/ASAN); full unit suite; C++ e2e 19/19; Go example; existing event
tests unchanged. The per-event *typed* native callback + wildcard router (the
ergonomic consumer surface) is a follow-up.

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

2026-05-31 18:37:27 +02:00

CMakeLists.txt

Cpp typed event listeners (#51 )

2026-05-28 22:40:33 +02:00

main.cpp

chore: avoid throwing exceptions in C++ bindings (#46 )

2026-05-29 12:35:49 -03:00

my_timer.hpp

feat(ffi): native event delivery + dual-ABI event symbol naming

2026-05-31 18:37:27 +02:00

README.md

Add basic cpp e2e tests (#27 )

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

README.md

C++ Bindings for nim-timer

Purpose

This folder contains auto-generated C++ bindings for the my_timer Nim library. It is generated from ../timer.nim and provides:

my_timer.hpp: High-level C++ class (MyTimerCtx) wrapping the FFI interface
main.cpp: Example executable demonstrating how to use the bindings
CMakeLists.txt: Build configuration that compiles the Nim library and links the C++ example

How It's Generated

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

cd examples/timer
nimble genbindings_cpp

This command:

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

Building the Example

cd examples/timer/cpp_bindings
cmake -S . -B build
cmake --build build
./build/example

Do Not Edit

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