brokkr-client

Ergonomic Python client for the Brokkr broker API.

pip install brokkr-client

The import name is brokkr (from brokkr import BrokkrClient); the PyPI distribution name is brokkr-client.

Versions track the broker release in lockstep — brokkr-client 0.3.x is the canonical client for broker 0.3.x.

This is a thin wrapper around the auto-generated brokkr-client-generated package (produced by openapi-python-client from the broker's OpenAPI spec). The wrapper adds:

A single-credential constructor that injects the Authorization header on every request. The three security schemes the spec declares (admin_pak / agent_pak / generator_pak) all map to the same header and the broker disambiguates at runtime — the wrapper hides that detail.
BrokkrError, a single exception type that wraps the generated typed ErrorResponse and exposes .code for stable pattern-matching.
An opt-in retry(...) helper with exponential backoff for transient transport / 5xx failures. Retry is per-call so callers decide which operations (typically idempotent GETs) are safe.

Pagination iterators are intentionally absent: the v1 broker API returns full collections without cursor tokens. Stream-style adapters belong here when the API adds pagination.

The wrapper is intentionally small. Most of the surface is the generated client; reach for it via client.api when the wrapper doesn't cover what you need.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brokkr_client-0.9.1.tar.gz (7.0 kB view details)

Uploaded Aug 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

brokkr_client-0.9.1-py3-none-any.whl (8.1 kB view details)

Uploaded Aug 2, 2026 Python 3

File details

Details for the file brokkr_client-0.9.1.tar.gz.

File metadata

Download URL: brokkr_client-0.9.1.tar.gz
Upload date: Aug 2, 2026
Size: 7.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for brokkr_client-0.9.1.tar.gz
Algorithm	Hash digest
SHA256	`9dc3facb5bedca6405bdd68ce9cb75c1e712e72af5eada893a6326f896f37321`
MD5	`5866cd4f91b182a112a1113546b4d578`
BLAKE2b-256	`835c4dd387a9ec395fb5e8d75207e7965bbd2649f1ab3222100fbd456aa0d016`

See more details on using hashes here.

Provenance

The following attestation bundles were made for brokkr_client-0.9.1.tar.gz:

Publisher: release-sdks.yml on colliery-io/brokkr

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: brokkr_client-0.9.1.tar.gz
- Subject digest: 9dc3facb5bedca6405bdd68ce9cb75c1e712e72af5eada893a6326f896f37321
- Sigstore transparency entry: 2327559893
- Sigstore integration time: Aug 2, 2026
Source repository:
- Permalink: colliery-io/brokkr@9940d84588b63228acc3f59663e87c23bab7a867
- Branch / Tag: refs/tags/v0.9.1
- Owner: https://github.com/colliery-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-sdks.yml@9940d84588b63228acc3f59663e87c23bab7a867
- Trigger Event: push