Reference¶
The pages below document the full surface of binoc's APIs and configuration formats. If you need a concrete walkthrough, see the tutorial. If you want to understand the design, see the architecture overview.
Start by role¶
- Anyone driving the CLI — start with CLI.
- Pipeline integrator — start with Changeset JSON schema and Dataset config.
- Python plugin author — start with Python API.
- Rust plugin author — start with Rust SDK and Plugin discovery.
- Plugin consumer — start with Third-party plugins.
CLI and APIs¶
binocCLI — every subcommand and option, generated from the Rust source.- Python API — the
binocPython package, generated from docstrings. - Rust SDK —
binoc-sdkcrate, generated bycargo doc.
Data contracts¶
- Changeset JSON schema — the canonical contract for pipeline integrators.
- Dataset config — every key in a dataset YAML config and what it does.
- Plugin discovery — entry-point spec for Python and Rust plugins.
- Third-party plugins — add-on plugins by file
format; generated from
third_party_plugins.json.