behavior-contracts (Python)
The COMMON "thin core" runtime primitives from
runtime-boundary.md, ported to Python from the
TypeScript reference implementation (ts/src/*) with identical semantics.
This package contains only the DSL-agnostic primitives that WS1 classified as COMMON. It has zero backend (DynamoDB / graphddb) dependencies — no boto3, no key marshalling, no retry tuning, no hydrate, no bundle format. Those stay in the consumer (graphddb).
Public API
from behavior_contracts import (
validate_envelope, # spec-version fail-closed check
evaluate_expression, # expression-ir.md evaluator (i64-checked, truncated %, code-point cmp)
render_template, # {param} rendering (strict, Python str() parity)
run_plan, final_tree, # execution-plan skeleton (stage / Skip propagation / Policy Kind)
canonical_value, # key identity (top-level key sort)
canonical_json, # fingerprint (recursive key sort)
py_float_repr, # CPython repr(float) canonical decimal
assert_portable, # Portability Guard
decode_value, deep_equals, # conformance runner adapter (int/float type distinction)
encode_value, resolve_partial, cmp_code_points,
SPEC_VERSIONS, ENVELOPE_SPEC_VERSION,
)
Each COMMON primitive raises a typed *Failure exception carrying a .code
string matching the conformance protocol's failure-code set.
§8 cross-language traps this port handles
%sign: normative mod is truncated (dividend sign). Python's native%returns the divisor sign, soevaluate_expression({"mod":[-7,2]}) == -1(native-7 % 2 == 1). Implemented via truncated-quotient correction; float mod viamath.fmod.- int is checked i64: Python
intis arbitrary-precision, so i64 bounds are enforced manually; overflow →INT_OVERFLOW. - string comparison: code-point order. Python
strcompares by code point already (no UTF-16 surrogate hazard) — verified in tests. - NaN/Inf → Failure;
divalways float with|int| > 2^53widening →PRECISION_LOSS;py_float_reprmatches CPythonrepr(float)byte-for-byte (parametrized parity tests). - bool is not int:
isinstance(x, bool)is checked beforeinteverywhere (Python'sbool <: int).
Conformance
Runs the 8 shared suites (173 vectors) from ../conformance/vectors/*.json
through this package per ../conformance/PROTOCOL.md,
including the pre-flight version fail-closed sweep.
python -m behavior_contracts.conformance # → "173 passed, 0 failed / 173 vectors across 8 suites"
# or the console script:
behavior-contracts-conformance
Override the vectors location with DSL_CONTRACTS_VECTORS=/path/to/vectors.
Tests
pip install -e ".[test]"
python -m pytest # unit tests over the public API + the conformance runner as a test
Docker integration: N/A
This package has no external service dependency (no database, no network) — it is pure in-process logic over JSON-shaped values. There is therefore nothing for a docker-compose integration harness to stand up; the conformance runner and pytest exercise the full surface in-process. (The graphddb adapter PoC in WS4 Part B is where docker-backed integration applies, because graphddb talks to DynamoDB Local.)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file behavior_contracts-0.9.3.tar.gz.
File metadata
- Download URL: behavior_contracts-0.9.3.tar.gz
- Upload date:
- Size: 61.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d6ed84a71dfd2cb3bd1be530a6ac2d188c5de4edb520614baa2c2e416bd039ef
|
|
| MD5 |
6c8990730fdcfa8c99db8ee0680d62db
|
|
| BLAKE2b-256 |
58b3a56caad3e87ad604d02bf7c62837a111563f2e89f304c9f1a6a7cbbbe287
|
File details
Details for the file behavior_contracts-0.9.3-py3-none-any.whl.
File metadata
- Download URL: behavior_contracts-0.9.3-py3-none-any.whl
- Upload date:
- Size: 53.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f8c01181c02152f8141f72bc3ace3cd34350b2b1caa17e58fe39ae0162f5a896
|
|
| MD5 |
0ce3c8616f7c66a33d372bafc39cdbb8
|
|
| BLAKE2b-256 |
3df6a6795478ff601705b242e607f34fe433f915e1f3bed0a1d9ec16c1dbef63
|
