osp-provider-runtime 0.1.1

Thin runtime harness for OSP providers (RabbitMQ transport + contract execution).

osp-provider-runtime

Thin, boring runtime harness for OSP providers.

This package handles RabbitMQ message plumbing so provider implementations can focus on business logic.

What it does (v0.1)

• Parses a versioned request envelope.
• Builds provider RequestContext/ProviderRequest and calls execute(...).
• Serializes a standard response envelope.
• Applies explicit ack/requeue/dead-letter decisions.
• Emits structured logs for delivery decisions.
• Supports explicit runtime knobs for prefetch/concurrency/retries/timeouts/DLQ.

What it does not do

• No provider framework.
• No plugin system.
• No workflow orchestration.

Install

pip install osp-provider-runtime

Development

env -u VIRTUAL_ENV uv sync --extra dev
hatch shell
hatch run check
hatch run build
hatch run verify

Note: before osp-provider-contracts is published to your index, use uv for local checks in this monorepo:

env -u VIRTUAL_ENV uv run ruff check .
env -u VIRTUAL_ENV uv run mypy src tests
env -u VIRTUAL_ENV uv run pytest

Runtime Knobs

• OSP_RUNTIME_PREFETCH_COUNT (default 1)
• OSP_RUNTIME_CONCURRENCY (default 1)
• OSP_RUNTIME_MAX_ATTEMPTS (default 5)
• OSP_RUNTIME_HANDLER_TIMEOUT_SECONDS (optional)
• OSP_RUNTIME_DEAD_LETTER_EXCHANGE (optional)
• OSP_RUNTIME_DEAD_LETTER_ROUTING_KEY (optional)
• OSP_RUNTIME_HEARTBEAT_SECONDS (default 60)
• OSP_RUNTIME_BLOCKED_CONNECTION_TIMEOUT_SECONDS (default 30)

Tag and push:

git tag v0.1.0
git push origin v0.1.0