Maturity and compatibility¶
Evaluator cheat-sheet for the three label axes. Builders can skip this page and use What’s ready today.
Builders usually need two answers:
- Can I use this capability for a pinned application today?
- How much compatibility does its public API promise?
The first answer is on What’s ready today. The second is in the API stability catalog.
| Capability readiness | Meaning | Application decision |
|---|---|---|
| Supported | Tested for the stated host and constraints | May be used in a pinned production application; not an SLA |
| Experimental | Shipped, but operational or compatibility evidence is incomplete | Evaluate explicitly and keep the documented fallback |
| Deferred | Designed or tracked, but not offered for adoption | Do not depend on it |
| API level | Compatibility promise |
|---|---|
stable |
Compatibility-protected throughout 1.x; an incompatible change requires a new major release plus migration guidance |
beta |
Public and supported where the capability table says so; may change at a documented minor-train boundary |
experimental |
May change or be removed at a minor boundary |
internal / deferred |
Not a public application contract |
Package classifiers provide additional context: hedron-core, hedron, edron, hedron-data,
hedron-charts, and hedron-maps are
Stable packages in 1.0, while satellites retain Beta or tooling-grade maturity. Always
pin package versions. Package maturity does not override the two application questions above.
Example¶
Polling job status is a Supported capability with a documented public API. SSE and
WebSocket helpers are Experimental, so production applications should retain the
polling fallback. A particular callable may be API stable or beta; check its
reference page before treating its signature as compatibility-protected.
Current release¶
The current published train is the 1.1.x release (v1.1.2). PyPI serves Hedron and Edron
1.1.2. Install from PyPI:
Pins: Installation.
There is no commercial SLA. See Evaluate Hedron for the adoption checklist and Glossary for project terminology.