Skip to main content

grow-openbao (Python)

Python SDK for OpenBao by Grow Codes. Unofficial and community maintained; "OpenBao" is a trademark of OpenBao a Series of LF Projects, LLC.

pip install grow-openbao
from grow_openbao import OpenBaoClient, OpenBaoConfig

# Reads GROW_OPENBAO_URL, GROW_OPENBAO_TOKEN, ... from the environment.
with OpenBaoClient.from_env() as client:
    print(client.health())
    print(client.server_version())

The async client has the same methods:

import asyncio
from grow_openbao import AsyncOpenBaoClient

async def main() -> None:
    async with AsyncOpenBaoClient.from_env() as client:
        print(await client.health())

asyncio.run(main())

Service modules hang off the client (the async client mirrors every one of them):

from grow_openbao import AppRoleAuth, OpenBaoClient

with OpenBaoClient.from_env() as client:
    client.auth.login(AppRoleAuth(role_id, secret_id), auto_renew=True)   # TokenRenewer
    client.kv().write("app/db", {"password": "s3cret"})                    # KV v1/v2 auto-detected
    print(client.kv().read("app/db").metadata)
    ct = client.transit().encrypt("my-key", "hello")                       # transit
    lease = client.database().get_credentials("readonly")                  # dynamic credentials
    client.leases.manage(lease, on_expire=lambda: print("expired"))       # LeaseManager
    cert = client.pki().issue_certificate("web", "app.example.com")        # PKI
    token = client.wrapping.wrap({"one-time": "value"}, ttl_s=60).token    # response wrapping
    client.sys.write_policy("app", 'path "secret/data/app/*" { capabilities = ["read"] }')
    print(client.secrets(path="app").get_string("db"))                     # SecretsProvider
Module Accessor Functions
Auth client.auth login(TokenAuth / AppRoleAuth / KubernetesAuth / JwtAuth / UserpassAuth), lookup_self, renew_self, revoke_self, create_token, start_renewer (TokenRenewer)
KV client.kv(mount), kv_v1, kv_v2 read, write, patch, delete, delete_versions, undelete, destroy, list, read_metadata, write_metadata, delete_metadata
Transit client.transit(mount) create_key, read_key, list_keys, rotate_key, update_key_config, delete_key, encrypt, decrypt, rewrap, encrypt_batch, decrypt_batch, generate_data_key, hmac, sign, verify, hash, random_bytes
Database client.database(mount) get_credentials → Lease, configure_connection, read_connection, delete_connection, create_role, read_role, delete_role
Leases client.leases renew, revoke, revoke_prefix, lookup, manage (auto-renew + on_expire), stop_all
PKI client.pki(mount) issue_certificate, sign_csr, revoke_certificate, read_ca_chain, read_certificate, list_certificates, tidy, tidy_status
System client.sys health, seal_status, leader, version, policies, secrets engines, auth methods, AppRole admin (create_app_role, read_role_id, generate_secret_id …)
Wrapping client.wrapping wrap, unwrap, lookup_wrapping
Secrets client.secrets(mount, path=…) the shared SecretsProvider (get, set, list, delete, metadata, load_env, watch …)
Testing grow_openbao.testing.lifecycle init, unseal, seal, init_status, wait_for_active (+ a… async forms)

Durations are float seconds (…_s parameters, timedelta accepted); timestamps are aware UTC datetimes; tokens, keys and passwords are Secret values.

  • Python 3.10 or newer, typed (py.typed), httpx based, environment proxies ignored unless configured.
  • Retries with full-jitter backoff and Retry-After, connect/request/total timeouts, cancellation, hooks and a silent-by-default logging logger named grow_openbao.
  • Credentials are wrapped in Secret and never appear in repr(), logs or error messages.
  • grow_openbao.testing ships in-memory fakes and the conformance runner.

Documentation: https://grow-codes-packages.github.io/openbao/ · Source: https://github.com/grow-codes-packages/openbao · Licence: Apache-2.0

Metadata

Release files for grow-openbao 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for grow-openbao 0.1.1
File Size Uploaded Provenance Actions
grow_openbao-0.1.1.tar.gz 159.9 kB Without provenance Details for grow_openbao-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for grow-openbao 0.1.1
File Interpreter ABI Platform Actions
grow_openbao-0.1.1-py3-none-any.whl Python 3 none any Details for grow_openbao-0.1.1-py3-none-any.whl

Total release size: 272.2 kB

Release files / grow_openbao-0.1.1.tar.gz

Download URL grow_openbao-0.1.1.tar.gz
Size 159.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b8d2df6b8b309fc921ffa10c42c59c148f14b460a6d37b100071da1f30c33127
BLAKE2b-256 checksum
How to use checksums
7df8af0c2628cef8779ffa335e6c8a24eb592d408882d396842e08956bee6cac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / grow_openbao-0.1.1-py3-none-any.whl

Download URL grow_openbao-0.1.1-py3-none-any.whl
Size 112.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
189b89cd7469dbe837334efd864d0d0e5f2760e5d8b5ace9a498c07a392ad581
BLAKE2b-256 checksum
How to use checksums
daa0ebbcbff781740f0a6c59d0c733b098804d0f4acbf7ff68605ea5f21bd5b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Security for grow-openbao 0.1.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page