secretspec (Python SDK)
Python bindings for SecretSpec, a declarative secrets
manager. This package is a thin client over a pyo3 extension that calls
secretspec::resolve_json directly: resolution (providers, chains, profiles,
generation, as_path) happens in the Rust core, so the SDK inherits every
provider with no Python-side logic.
from secretspec import SecretSpec
resolved = (
SecretSpec.builder()
.with_provider("keyring://")
.with_profile("production")
.with_reason("boot web app")
.load()
)
print(resolved.provider, resolved.profile)
db = resolved.secrets["DATABASE_URL"]
print(db.get) # the value, or the file path for as_path secrets
resolved.set_as_env() # export everything into os.environ
A missing required secret raises MissingRequiredError; any other failure
raises SecretSpecError (with a stable .kind).
Scopes (0.17+)
Use .with_scope("api") to resolve only a named [scopes.api] subset. Both
resolved.scope and report.scope return the selected scope:
resolved = SecretSpec.builder().with_scope("api").load()
Cleanup
as_path secrets are materialized to temp files that outlive the call. Use the
result as a context manager (with SecretSpec.builder()...load() as resolved:)
or call resolved.close() when done so the secret files do not accumulate.
Value-free report
report() returns the inventory/preflight view: per-secret status and
provenance, never a value. Unlike load(), it does not raise when a required
secret is missing — it appears as a SecretReport with status
"missing_required".
report = SecretSpec.builder().with_profile("production").report()
for s in report.secrets:
print(s.name, s.status, s.required)
Native library
The Rust resolver is statically linked into a compiled pyo3 extension
(secretspec._native, built from the secretspec-py-native crate) inside the
installed wheel, so there is nothing to locate at runtime. The prebuilt abi3
wheels are self-contained (pip install secretspec). From a source checkout
the extension is built on demand by the test harness via maturin develop,
which needs maturin and a Rust toolchain on PATH.
Metadata
Release files for secretspec 0.21.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| secretspec-0.21.1-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details for secretspec-0.21.1-cp39-abi3-win_amd64.whl |
| secretspec-0.21.1-cp39-abi3-manylinux_2_28_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ x86-64 | Details for secretspec-0.21.1-cp39-abi3-manylinux_2_28_x86_64.whl |
| secretspec-0.21.1-cp39-abi3-manylinux_2_28_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ ARM64 | Details for secretspec-0.21.1-cp39-abi3-manylinux_2_28_aarch64.whl |
| secretspec-0.21.1-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details for secretspec-0.21.1-cp39-abi3-macosx_11_0_arm64.whl |
Total release size: 74.9 MB
Release files / secretspec-0.21.1-cp39-abi3-win_amd64.whl
| Download URL | secretspec-0.21.1-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 15.9 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
867fea1b1bf04c83b69fe77f0db76c8d8032ffb49d7d8fe5a1d78e050e8ed322
|
|
BLAKE2b-256 checksum How to use checksums |
258c2bfb605cc3f24a36ba332cde2ddb2ba6ccaa02acb21f7971c703a2b50f5e
|
| 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 Sep 27, 2026.
Transparency logRelease files / secretspec-0.21.1-cp39-abi3-manylinux_2_28_x86_64.whl
| Download URL | secretspec-0.21.1-cp39-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 20.9 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
946af4b7c08ccf5db805aac4f1593794874b0a66e12854e842539f8ae8ad2e81
|
|
BLAKE2b-256 checksum How to use checksums |
a25b5cbaceaf5028568fe359897d069b0dcb583442d70ea0b7d53b62c0f06b47
|
| 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 Sep 27, 2026.
Transparency logRelease files / secretspec-0.21.1-cp39-abi3-manylinux_2_28_aarch64.whl
| Download URL | secretspec-0.21.1-cp39-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 20.5 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
5cce022334416815cdd86770d95fae0d849ad62ef03ce2ed75e31756bd975a0a
|
|
BLAKE2b-256 checksum How to use checksums |
5caee2222e962dfea3f721937092ac2a7e1f611643d6af675c26564314184e98
|
| 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 Sep 27, 2026.
Transparency logRelease files / secretspec-0.21.1-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | secretspec-0.21.1-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 17.5 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f6716cfdf4cb6ecf2c3e04e6132ec6e5eeac4fab4c124a01abc20f5d7ebb46ff
|
|
BLAKE2b-256 checksum How to use checksums |
16f19690888c863b342b201aad9fa46298b8d68b4ebfb20b4fa90b41e83ca828
|
| 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 Sep 27, 2026.
Transparency logSecurity for secretspec 0.21.1
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
All 4 files in this release have been uploaded with provenance metadata.
Attestation for secretspec-0.21.1-cp39-abi3-win_amd64.whl
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 Sep 27, 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.