Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

bella-baxter-fastapi

FastAPI integration for the Bella Baxter secrets management platform. Provides a BellaDepends dependency annotation for injecting a BaxterClient into route handlers.

Installation

pip install --pre bella-baxter-fastapi

Quickstart

from contextlib import asynccontextmanager
from fastapi import FastAPI
from bella_baxter_fastapi import init_bella, BellaDepends

@asynccontextmanager
async def lifespan(app: FastAPI):
    init_bella(api_key="bax-...")
    yield

app = FastAPI(lifespan=lifespan)

@app.get("/health")
async def health(bella: BellaDepends):
    secrets = await bella.get_all_secrets_async()
    return {"database": secrets.secrets.get("DATABASE_URL")}

init_bella()

Call once at startup (inside a lifespan handler or module level) to initialise the shared client:

from bella_baxter_fastapi import init_bella

init_bella(
    api_key="bax-...",
    baxter_url="https://api.bella-baxter.io",  # optional
)

BellaDepends

A typed Annotated dependency that injects the shared BaxterClient:

from bella_baxter_fastapi import BellaDepends

@app.get("/secrets")
async def get_secrets(bella: BellaDepends):
    resp = await bella.get_all_secrets_async()
    return resp.secrets

Configuration via environment variables

import os
from bella_baxter_fastapi import init_bella

init_bella(
    api_key=os.environ["BELLA_BAXTER_API_KEY"],
    baxter_url=os.environ.get("BELLA_BAXTER_URL", "https://api.bella-baxter.io"),
)

Authentication

Generate an API key via the CLI or the Bella WebApp:

bella api-keys create --env production --name "FastAPI Production"

Using secrets at startup (before first request)

@asynccontextmanager
async def lifespan(app: FastAPI):
    init_bella(api_key=os.environ["BELLA_BAXTER_API_KEY"])

    # Pre-fetch secrets to warm the cache
    from bella_baxter_fastapi import _get_bella_client
    client = _get_bella_client()
    secrets = await client.get_all_secrets_async()
    app.state.db_url = secrets.secrets["DATABASE_URL"]
    yield

Release files for bella-baxter-fastapi 0.1.1rc112

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

Source distribution (sdist)

Source distribution for bella-baxter-fastapi 0.1.1rc112
File Size Uploaded
bella_baxter_fastapi-0.1.1rc112.tar.gz 3.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bella-baxter-fastapi 0.1.1rc112
File Interpreter ABI Platform
bella_baxter_fastapi-0.1.1rc112-py3-none-any.whl Python 3 none any Details

Total release size: 6.6 kB

Release files / bella_baxter_fastapi-0.1.1rc112.tar.gz

Download URL bella_baxter_fastapi-0.1.1rc112.tar.gz
Size 3.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a2ddfc2f4b51d6340f4ea76a766ea44a7873b5672f96561d49cfe173383eba79
BLAKE2b-256 checksum
How to use checksums
ebcfb68825641f064b75742afe02e4cbffa4c195a3e7be2e75f36748b3d4606b
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 21, 2026.

Transparency log

Release files / bella_baxter_fastapi-0.1.1rc112-py3-none-any.whl

Download URL bella_baxter_fastapi-0.1.1rc112-py3-none-any.whl
Size 3.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8131f2db0dc20433393c87e7f453a1f699fa7b7dbedaea90d426685cf98d46a8
BLAKE2b-256 checksum
How to use checksums
ad2d69b0d4dbc9491a53cba7d5ea03a2bd8619b44351c2ba9de45bab1a5962e5
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 21, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.1rc112 This release

2 release files

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