Skip to main content

openframe-protocol-http

HTTP/ASGI server binding. Wires a QueryHandler/CommandHandler/UseCase (openframe.core.inbound) to a FastAPI route through the shared error mapper and RequestContext builder in openframe-protocol-base, instead of each route hand-mapping HTTPExceptions itself.

Install the [server] extra for the FastAPI/ASGI dependencies — openframe-protocol-http[server].

Wiring example

from openframe.protocol.http import bind_query, bind_command, install_error_handlers

router = APIRouter(prefix="/items")

bind_query(
    router, "/{item_id}",
    handler_dep=get_get_item_handler,
    path_param=("item_id", str),
    response_model=Item,
    not_found_when=lambda item: item is None,
)

bind_command(
    router, "", method="POST",
    handler_dep=get_create_item_handler,
    body_model=Item,
    status_code=201,
    response_model=Item,
)

install_error_handlers(app)

Status

Experimental, M1 of the project's own build plan — proves the inbound handler contract survives a real transport before anything else (HTTP client, gRPC, sessions) is attempted.

Metadata

Release files for openframe-protocol-http 0.5.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-http 0.5.0
File Size Uploaded Provenance
openframe_protocol_http-0.5.0.tar.gz 18.6 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for openframe-protocol-http 0.5.0
File Interpreter ABI Platform
openframe_protocol_http-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 31.3 kB

Release files / openframe_protocol_http-0.5.0.tar.gz

Download URL openframe_protocol_http-0.5.0.tar.gz
Size 18.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9b0e542fb045d99fc927c82cf0654702b5bb46e841edf174217c34cdb5ae0afc
BLAKE2b-256 checksum
How to use checksums
c9f45dffb7b20c70002cf22db809b7b0af092d6bc234f3c83b92b900cb22633b
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_http-0.5.0-py3-none-any.whl

Download URL openframe_protocol_http-0.5.0-py3-none-any.whl
Size 12.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
18451408dbe3a4503681d353d16105be26a3d040eb1e24b6a26506c39aab3ddd
BLAKE2b-256 checksum
How to use checksums
1f237718e5e534cb4d5324ac7d24fbdfb917813e76ece95292df250a891b00a7
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-http 0.5.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