fix(ffi): return parser status and isolate thread errors

This commit is contained in:
Jan Petykiewicz 2026-11-14 14:23:13 -08:00
commit 24438c4840

View file

@ -20,4 +20,14 @@ A fast GDSII parser and writer in Rust, with Apache Arrow integration for effici
## Usage
(To be added)
`read_path` exports a library through the Arrow C Data Interface. Allocate
initialized `ArrowArray` and `ArrowSchema` output structures, then check the
returned status: `0` means success and `-1` means failure. Only import the Arrow
outputs after success; the caller owns their release callbacks. Failed calls
leave the outputs unchanged. See `test.py` for a Python CFFI example.
`last_error_message()` returns a UTF-8, null-terminated error string, or null
after a successful parser call. Errors belong to the calling thread. Copy the
message before making another parser call on that thread, and before the thread
exits; calls on other threads do not invalidate it. Parser panics that unwind
are converted into errors.