tetration 0.1.9

Chunked tensor .tet format, tet CLI, and optional C ABI (tetration-ffi)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# `ffi` — C ABI (feature `tetration-ffi`)

Stable C entrypoints for embedders who cannot use Rust directly. Built as `cdylib` + `rlib`; headers in [`include/tetration.h`](../../include/tetration.h).

Enable: `cargo build --features tetration-ffi`

Docs: [`docs/ffi.md`](../../docs/ffi.md)

## Symbols

| C API                                | Rust backing                                |
| ------------------------------------ | ------------------------------------------- |
| `tet_abi_version`                    | `TET_ABI_VERSION`                           |
| `tet_open` / `tet_close`             | `TetFile` boxed handle                      |
| `tet_summary_json`                   | `TetFile::summary()` → JSON                 |
| `tet_query_json`                     | `execute_query_json` → `QueryResponse` JSON |
| `tet_verify_json`                    | `verify_tet_bytes` (no handle)              |
| `tet_last_error` / `tet_clear_error` | Thread-local error string                   |
| `tet_string_free`                    | Free JSON return buffers                    |

## Files

| File       | Role                                       |
| ---------- | ------------------------------------------ |
| `mod.rs`   | `#[no_mangle]` exports, panic guard        |
| `error.rs` | Thread-local `last_error` for failed calls |

## Contract

- Returned `char*` JSON must be freed with `tet_string_free`
- Handles are opaque; do not use after `tet_close`
- ABI version bumps on breaking C layout/symbol changes

## Example

[`examples/ffi_query.c`](../../examples/ffi_query.c)