proofline-sdk

Typed synchronous and asynchronous Python clients for the Proofline review API. They read and request reviews with a scoped API token, and add pagination, waiting for a review, retries and typed errors. The import package is proofline. Python 3.11 or newer is required.

pip install proofline-sdk

import os
from proofline import ProoflineClient

with ProoflineClient(os.environ["PROOFLINE_TOKEN"]) as client:
    ...

The clients read PROOFLINE_TOKEN when no token is passed, keep the token in memory and redact it from diagnostic output. AsyncProoflineClient has the same methods as coroutines. The SDK guide and API reference cover every operation.

Licensed under the Apache License, Version 2.0. The generated models under proofline/_generated carry the MIT license of the generator templates.

Development

The repository bundles its public API contract in openapi.public.json. Run python3 scripts/check.py to install pinned tools, regenerate the client, run checks and verify built packages.

Publishing

GitHub Actions runs the checks on pull requests and main. The Release workflow builds checked artifacts without publishing credentials. Run it on main with publish=false to verify the release path. A vX.Y.Z tag matching the package version, or a main-branch dispatch with publish=true, publishes after the pypi environment approves the job. Release commits must belong to main.

Publishing uses GitHub OIDC and the repository's release.yml trusted publisher. No registry token is stored in GitHub.