API reference
Every stable operation of the three EarthSciIO bindings, side by side.
EarthSciIO has three bindings — Python, Julia and Rust — that download data into one shared content-addressed cache and read it as native-grid arrays. This reference has one page per stable operation, with a tab for each binding showing its spelling, signatures and documentation, taken from the binding’s own documentation tooling, along with runnable examples. The examples run in CI, so what is shown here is what the code does.
The surface has two tiers. Stable names are harmonized across bindings and break only at a major version. Extension names are a binding’s own documented seams; they may differ between bindings and may change in a minor release, and each binding lists them on one page.
Guides
- Getting started — Fetch a file into the shared cache, read it back offline, and decode it into native-grid arrays.
Topics
- Cache (10) — Fetching a resolved URL into the shared content-addressed cache, validating what is stored, and reading it back offline.
- Providers (10) — Binding a data source to the cache and a reader, and getting native-grid arrays out at the simulation’s cadence.
- Native arrays and readers (9) — The raw native-grid arrays a provider returns, and the format readers that decode cached files into them.
- Errors (3) — What fails and how: offline misses, integrity failures and the general error.
Or browse all stable operations A–Z .
Bindings
| Binding | Package | Version | Docs from | Stable | Extension |
|---|---|---|---|---|---|
| Python | earthsciio | 0.1.4 | griffe 2.3.2 | 25 | 6 |
| Julia | EarthSciIO | 0.1.4 | Base.Docs (Julia 1.13.3) | 26 | 6 |
| Rust | earthsciio | 0.1.4 | rustdoc JSON (rustdoc 1.101.0-nightly (21b707e3f 2026-09-30)), format_version 61 | 23 | 1 |
Documentation coverage lists the stable names each binding has not documented yet.