CodaPact
Contracts into callable tools.
This first iteration generates an installable, typed Python client and a
scriptable CLI from a local or remote OpenAPI contract. The package, module, and
generator CLI are named codapact. Install a published release with
uv tool install codapact, or use the source workflow below.
uv sync
uv run codapact generate examples/pets.yaml --output .tmp/pets-client --package pets_client
uv build
uv pip install --no-deps .tmp/pets-client
uv run pets-client --config examples/runtime.json get-pet --arg-pet-id 7
The example server address is intentionally inert. Override base_url with your
own trusted endpoint and set the environment variable referenced by the runtime
configuration. Tests use isolated loopback HTTP servers and synthetic credentials.
from pets_client import Client
client = Client(settings={"auth": {"token": {"env": "PETS_TOKEN"}}})
pet = client.get_pet(parameters={"pet_id": 7})
Reusable generation values are supported with uv run codapact generate --manifest examples/pets.codapact.yaml. The resulting pets command discovers
config.json and auth.json in $XDG_CONFIG_HOME/pets or ~/.config/pets.
Override its directory with pets --config-dir PATH .... See the configuration
guide for precedence, credential-file permissions, and every generation override.
Generate a specialized surface with --preset read and operation ID, path,
method, or domain-tag rules. Preview the selected operations without writes:
uv run codapact generate --manifest examples/pets-read.codapact.yaml --dry-run
The read preset selects GET/HEAD/OPTIONS by name; it is not a safety or authorization guarantee. The generated library and CLI share the same selection.
- Architecture and extension contracts
- Supported features and safety boundaries
- CLI definition and runtime configuration
- Endpoint selection and domain profiles
- Release process
- Security analysis
- Verification evidence and limits
- Asynchronous mutation testing and open alerts
Run uv run poe check for formatting, lint, type checking, and tests. Generated
packages depend on this runtime at the exact generator version. For unreleased
source changes, install the local runtime wheel and generated wheel together.
The end-to-end test proves that workflow in a fresh environment.
Metadata
Release files for codapact 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| codapact-0.2.0.tar.gz | 176.7 kB | With provenance | Details for codapact-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| codapact-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for codapact-0.2.0-py3-none-any.whl |
Total release size: 212.9 kB
Release files / codapact-0.2.0.tar.gz
| Download URL | codapact-0.2.0.tar.gz |
|---|---|
| Size | 176.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
531fb24c491b63638eaadabc2ddcf042e1dacc8c8127510cf9b88b1e2f162ff6
|
|
BLAKE2b-256 checksum How to use checksums |
29d0507abb927ff73a32c8a1ed78953b906b143a09859bedccdd64fa9e361a26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logRelease files / codapact-0.2.0-py3-none-any.whl
| Download URL | codapact-0.2.0-py3-none-any.whl |
|---|---|
| Size | 36.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
52cf3293750a61a1aba7e302474a003f081be25f8ab1ec8f1289ddb902c601ca
|
|
BLAKE2b-256 checksum How to use checksums |
4b737c23757b35819648ee780bce64ac28c45f22c9e529089cc575162ff7d52c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logSecurity for codapact 0.2.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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for codapact-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logA 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.