cabina

What it is and what it does

Cabina is a Python library for building typed, hierarchical configurations driven by environment variables. It lets you define config as nested classes with type annotations, automatically parsing environment variables into the correct types (string, int, bool, etc.) with sensible defaults. You can also define computed properties that derive values from other config fields, and use custom parsers for special formats like JSON or duration strings.

The library is designed to reduce boilerplate in configuration setup—instead of manually reading os.environ and casting values, you declare your config structure once as a class hierarchy and cabina handles parsing, validation, and access. It supports flat configs (inheriting both Config and Section), prefixed environment variables to avoid collisions, lazy evaluation of variables, and inheritance patterns for specializing configs across environments.

Use it for

• Define a web service config with typed host, port, and timeout settings parsed from environment variables with sensible defaults.
• Build a hierarchical config for a microservice with separate sections for database, cache, and API settings, each with their own env var prefix.
• Create computed config values like a full API URL derived from separate host and port variables, updated automatically if either changes.
• Implement environment-specific configs (dev, staging, prod) by subclassing a base Config and overriding section values.
• Parse complex JSON or custom-format config from environment variables using custom parser functions.
• Defer config parsing until first access using lazy_env to handle variables that may not exist at import time.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

cabina on PyPI

Before you install

Low install friction with a pure-Python wheel. Maintenance is dormant—last release was 584 days ago, though the repository remains active with a recent commit on 2025-01-07. No known vulnerabilities.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install cabina

import cabina
from cabina import env, computed

class Config(cabina.Config, cabina.Section):
    API_HOST = env.str("API_HOST", default="localhost")
    API_PORT = env.int("API_PORT", default=8080)
    
    @computed
    def API_URL(cls) -> str:
        return f"http://{cls.API_HOST}:{cls.API_PORT}"

print(Config.API_URL)  # http://localhost:8080

Package facts

Evidence: cabina-1.1.2-py3-none-any.whl

Tags

More Software Development packages

See also environs · envparse · config · hierarchical-conf · python-json-config · load-dotenv · databind · overrides · pydantic-settings · consulate