raptor.conformance.interop

raptor.conformance.interop#

The interop certification declaration and reusable matrix-hygiene scanners.

raptor is the framework-free contract owner: this module names every framework the family will ever bridge to (UNIVERSE), which subset is certified today (CERTIFIED) vs. declared-but-not-yet-built (ROADMAP), and the row-level ROWS catalogue, declared here in full ahead of the packages that write the matrix tests — so that assert_rows_complete() has a real gap to catch instead of declared and collected always landing together. Framework objects NEVER enter raptor — pointers and callables are passed in duck-typed; this module itself imports no framework, ever (find_spec never imports).

Pure-Python, numpy-free by design — raptor has zero hard dependencies.

Module Attributes

UNIVERSE

every framework the family will ever bridge to, day-0 and roadmap together.

CERTIFIED

frameworks with an executable, certified round-trip today.

ROADMAP

frameworks declared absent-by-design — no row certifies them yet.

ROW_KINDS

the vocabulary a RowDecl may declare for how a row moves data.

ROWS

row_id -> RowDecl — the full row catalogue, declared here ahead of the packages that write the tests.

Functions

assert_doc_rows_match(…)

Assert the doc's row IDs and rows's keys are the same set.

assert_no_skip_machinery(…)

Assert every DISCOVERED matrix row (any @register_row-decorated function in any .py under test_dir) is free of skip machinery: zero pytest.skip/skipif/importorskip tokens in its body, AND zero conftest availability-marker decorators (banned_markers, default the cross-repo union) on the registered function itself.

assert_no_skip_tokens(…)

Assert zero pytest.skip/skipif/importorskip tokens.

assert_rows_complete(…)

Assert every ROWS entry owned by owner_repo was collected.

certified_framework(…)

Assert fw (a name in CERTIFIED) is importable here.

discover_matrix_modules(…)

Every .py file under test_dir that calls register_row() (AST-detected, not textually grepped) — the matrix modules a repo actually ships, DISCOVERED rather than hand-passed.

register_row(…)

Decorator marking a matrix test as covering declared row row_id.

roadmap_framework(…)

Assert fw (a name in ROADMAP) is ABSENT here.

Classes

RowDecl

One declared interop-matrix row.