envv 1.0.0

Official EnvVault Python SDK — centralized secrets management

envvault (Python SDK)

Official Python SDK for EnvVault — centralized secrets management.

Installation

pip install envvault

Requires Python >= 3.10.

Quick Start

from envvault import EnvVaultClient

client = EnvVaultClient(
    api_url="https://api.envvault.example.com",
    token="your-token",
)

# Or rely on env vars: ENVVAULT_API_URL, ENVVAULT_TOKEN
# Or config file: ~/.envv/config.json

value = client.get_secret("DATABASE_URL")
secrets = client.list_secrets()
client.set_secret("API_KEY", "sk-...")
client.delete_secret("OLD_KEY")

Configuration Priority

Priority	Source
1 (highest)	Constructor args (api_url, token)
2	Environment variables (ENVVAULT_API_URL, ENVVAULT_TOKEN)
3 (lowest)	Config file (~/.envv/config.json)

Error Handling

from envvault import EnvVaultClient, AuthenticationError, NotFoundError

client = EnvVaultClient(api_url="...", token="...")

try:
    value = client.get_secret("MY_KEY")
except AuthenticationError:
    print("Invalid token")
except NotFoundError:
    print("Secret not found")

License

MIT