Skip to main content

openframe-protocol-base

Shared, transport-neutral mechanics every openframe-protocol-* binding package builds on. No transport dependencies of its own.

  • errors.py — categorize(exc) -> ErrorCategory and build_envelope(exc), the one place every transport maps OpenFrameError (and anything else) to a caller-safe error shape.
  • context.py — build_request_context(headers), building openframe.core.inbound.RequestContext consistently across transports (trace id, then a correlation header, then a generated uuid4).
  • testing.py — TransportConformanceTests + TransportDriver, the suite every binding proves itself against.

Wiring example

from openframe.protocol.base import build_envelope, build_request_context

context = build_request_context(request.headers)
try:
    result = await handler.execute(command, context)
except Exception as exc:
    envelope = build_envelope(exc, correlation_id=context.correlation_id)
    # serialise envelope in whatever shape this transport uses

Status

Experimental — incubating the inbound conformance suite here until two transports (HTTP, gRPC) both pass it for real, per the project's own rule-of-three discipline for promoting shared infrastructure into openframe-core.

Metadata

Release files for openframe-protocol-base 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openframe-protocol-base 0.4.0
File Size Uploaded Provenance
openframe_protocol_base-0.4.0.tar.gz 22.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for openframe-protocol-base 0.4.0
File Interpreter ABI Platform
openframe_protocol_base-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 41.2 kB

Release files / openframe_protocol_base-0.4.0.tar.gz

Download URL openframe_protocol_base-0.4.0.tar.gz
Size 22.4 kB
Tags Source
SHA-256 checksum
How to use checksums
409259d8386bc582a5de696d1bc7d57fb22e702d2807213675bea24e085ccad6
BLAKE2b-256 checksum
How to use checksums
dbac05fc070f4a7a215a404418465c64ac6b34ae0bd2ab096834a3d38d0dd463
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / openframe_protocol_base-0.4.0-py3-none-any.whl

Download URL openframe_protocol_base-0.4.0-py3-none-any.whl
Size 18.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
93fa2028518bc4521083198b8ad63e97951f4d11eb2c50beb21a0d23097566a1
BLAKE2b-256 checksum
How to use checksums
14832ad06fbdb77010b3c30577dbfd9743e9294b3c96c283a67170dca250f36b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for openframe-protocol-base 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page