SchemaIR for Python

This directory will contain the Python implementation of the language-independent SchemaIR protocol. The package is intended for Python tools that need to construct, validate, compare, and interpret SchemaIR data without coupling the wire model to a Python runtime object graph.

The protocol is the source of truth. Python APIs are bindings and authoring conveniences; their serialized output must remain compatible with the shared vectors in ../conformance/.

Development

Python 3.11 or newer is required. Create an environment and install the package with its development dependencies using your preferred workflow. With uv:

uv sync
uv run pytest
uv run ruff check .

The initial package is a scaffold. Implementation work should proceed from the protocol models, then definition and payload validation, SchemaNode relations, and the type interpreter. Host reference resolution, semantic and constraint providers, native type relations, graph scheduling, and execution remain caller owned.

Package layout

schemair/
  spec/              # Python bindings for protocol data
  core/              # definition, payload, and SchemaNode relation APIs
  type_interpreter/  # authoring-time expression interpreter
tests/               # unit and shared conformance-vector tests

See the repository contribution guide for protocol and conformance change rules.