span-panel-api-schema-0

The flat-schema parser for span-panel-api: the single-device Homie model published by SPAN firmware r202603 through r202627, which carries no data-model-version.

Why this is a separate distribution

span-panel-api is a transport and a dispatcher. It knows how to connect to a panel's MQTT broker, route messages, and choose a parser — but it contains no parsing code and no Homie type strings. Each wire format ships as its own distribution and registers itself under the span_panel_api.schema_adapters entry-point group.

That split exists because the two halves break on different axes. The wire format changes when SPAN ships firmware; the library API changes when we do. Separate distributions let each carry its own version, so a consumer can pin them independently and add support for a new panel schema by installing a package rather than by upgrading the transport.

Installation

pip install span-panel-api span-panel-api-schema-0

Installing this package is what makes flat-schema panels work. span-panel-api on its own will connect and then raise SpanPanelAdapterMissingError naming the adapter it could not find.

A consumer that wants to support panels on either schema installs both adapters:

pip install span-panel-api span-panel-api-schema-0 span-panel-api-schema-1

Dispatch happens at runtime, per panel, from the data-model-version the panel reports.

Retirement

SPAN retires the flat schema in the same release that introduces the parent/child model (r202633, fleet rollout projected for early September 2026). When the fleet has moved, consumers drop this package from their requirements. Published versions stay on PyPI for anyone still running older firmware.