SDK Python

Carga secretos directamente en una aplicación Python al iniciarse.

Python SDK

Carga secretos directamente en tu aplicación Python al inicio. Configuración en una línea o control detallado con el constructor fluido.

📦 PyPI v0.5.0

Instalación

uv add envilder
# or
pip install envilder

Inicio rápido: una línea

Carga secretos desde un archivo de mapeo e inyéctalos en el entorno:

from envilder import Envilder

Envilder.load('envilder.json')

Carga basada en entorno

Recomendado para aplicaciones multi-entorno. Mapea cada entorno a su archivo de secretos:

from envilder import Envilder
import os

env = os.getenv('APP_ENV', 'development')

Envilder.load(env, {
    'production': 'prod-secrets.json',
    'development': 'dev-secrets.json',
    'test': None,
})

Resolver sin inyectar

Obtén secretos como un diccionario sin modificar el entorno:

secrets = Envilder.resolve_file('envilder.json')

Constructor fluido con sobreescrituras

Sobreescribe la configuración del proveedor de forma programática con la API fluida:

from envilder import Envilder, SecretProviderType

secrets = (
    Envilder.from_map_file('envilder.json')
    .with_provider(SecretProviderType.AZURE)
    .with_vault_url('https://my-vault.vault.azure.net')
    .resolve()
)

Validación de secretos

Validación opcional que asegura que todos los secretos resueltos tienen valores no vacíos:

from envilder import Envilder, validate_secrets

secrets = Envilder.resolve_file('envilder.json')
validate_secrets(secrets)  # raises SecretValidationError if any value is empty

Documentación completa →