bella-baxter-django

Django integration for the Bella Baxter secrets management platform. Automatically loads secrets from Bella Baxter and makes them available throughout your Django app.

Installation

pip install --pre bella-baxter-django

Quickstart

# settings.py
INSTALLED_APPS = [
    ...
    'bella_baxter_django',
]

BELLA_BAXTER_API_KEY = 'bax-...'
BELLA_BAXTER_URL = 'https://api.bella-baxter.io'  # optional, this is the default

# anywhere in your code
from bella_baxter_django import get_bella

client = get_bella()
secrets = client.get_all_secrets()
db_url = secrets.secrets['DATABASE_URL']

How it works

get_bella() returns a shared BaxterClient instance, initialised lazily on first call and cached for the lifetime of the process. Adding 'bella_baxter_django' to INSTALLED_APPS triggers eager initialisation at Django startup via BellaBaxterConfig.ready(), so the first request doesn't bear the connection cost.

Configuration

Setting	Required	Default	Description
`BELLA_BAXTER_API_KEY`	✅	—	API key (`bax-...`)
`BELLA_BAXTER_URL`	❌	`https://api.bella-baxter.io`	Base URL of the Baxter API

Using secrets in views

from django.http import JsonResponse
from bella_baxter_django import get_bella

def health(request):
    bella = get_bella()
    secrets = bella.get_all_secrets()
    return JsonResponse({'db': secrets.secrets.get('DATABASE_URL', 'not set')})

Using secrets in settings.py

# settings.py — bootstrap secrets before Django fully loads
import os
from bella_baxter import BaxterClient, BaxterClientOptions

_bella = BaxterClient(BaxterClientOptions(
    baxter_url=os.environ.get('BELLA_BAXTER_URL', 'https://api.bella-baxter.io'),
    api_key=os.environ['BELLA_BAXTER_API_KEY'],
))
_secrets = _bella.get_all_secrets().secrets

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'HOST': _secrets['DB_HOST'],
        'NAME': _secrets['DB_NAME'],
        'USER': _secrets['DB_USER'],
        'PASSWORD': _secrets['DB_PASSWORD'],
    }
}

Authentication

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

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

Set it in your environment and reference it in settings.py:

export BELLA_BAXTER_API_KEY="bax-..."

Release files for bella-baxter-django 0.1.1rc113

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-django 0.1.1rc113
File	Size	Uploaded
bella_baxter_django-0.1.1rc113.tar.gz	3.4 kB	Sep 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bella-baxter-django 0.1.1rc113
File	Interpreter	ABI	Platform	Reset
bella_baxter_django-0.1.1rc113-py3-none-any.whl 3.7 kB Sep 21, 2026	Python 3	none	any	Details

Total release size: 7.1 kB

Release files / bella_baxter_django-0.1.1rc113.tar.gz

Download URL	bella_baxter_django-0.1.1rc113.tar.gz
Size	3.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`8d51de9b731c2c8a4e4bdfbb0404b5a8b5c646e8cf4138ee5c2e698eea54eccb`
BLAKE2b-256 checksum How to use checksums	`f23455923fb08c687e72edab4c226df7153bbf3e1b62ea53ed677803046014af`
Upload date	Sep 21, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Cosmic-Chimps/bella-baxter-python
Publishing commit: github.com/Cosmic-Chimps/bella-baxter-python/tree/27311e5233b2ed4c396f9d60a8a4e82450a14237

Workflow

Publishing configuration: github.com/Cosmic-Chimps/bella-baxter-python/blob/27311e5233b2ed4c396f9d60a8a4e82450a14237/.github/workflows/publish.yml
Publishing logs: github.com/Cosmic-Chimps/bella-baxter-python/actions/runs/35664794409/attempts/1

Artifact

Subject: bella_baxter_django-0.1.1rc113.tar.gz
SHA-256 checksum: 8d51de9b731c2c8a4e4bdfbb0404b5a8b5c646e8cf4138ee5c2e698eea54eccb Verifying attestations

Release files / bella_baxter_django-0.1.1rc113-py3-none-any.whl

Download URL	bella_baxter_django-0.1.1rc113-py3-none-any.whl
Size	3.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d7d70dde0897f8d9db3ca1bd14d4c04d2fa54935cce5f46e45a8c9282b1b527e`
BLAKE2b-256 checksum How to use checksums	`eff010a4aadc476fe3f3df3780cd562dc08fe76ffd96e24dbdb6d2462d26dc93`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Cosmic-Chimps/bella-baxter-python
Publishing commit: github.com/Cosmic-Chimps/bella-baxter-python/tree/27311e5233b2ed4c396f9d60a8a4e82450a14237

Workflow

Publishing configuration: github.com/Cosmic-Chimps/bella-baxter-python/blob/27311e5233b2ed4c396f9d60a8a4e82450a14237/.github/workflows/publish.yml
Publishing logs: github.com/Cosmic-Chimps/bella-baxter-python/actions/runs/35664794409/attempts/1

Artifact

Subject: bella_baxter_django-0.1.1rc113-py3-none-any.whl
SHA-256 checksum: d7d70dde0897f8d9db3ca1bd14d4c04d2fa54935cce5f46e45a8c9282b1b527e Verifying attestations