pocketvault-client 0.1.1

Python client for PocketVault secret manager

pocketvault-client

Python client for PocketVault — a lightweight self-hosted secret manager.

Features

• Zero external dependencies (stdlib only)
• In-memory cache with optional auto-refresh
• Thread-safe
• Inject secrets directly into os.environ

Installation

pip install pocketvault-client

Usage

from pocketvault import PocketVault

vault = PocketVault(
    url="https://vault.example.com",
    token="your-project-api-token",
    environment="production",
    refresh_interval=60,  # optional: re-fetch every 60 seconds
)

# Get a single secret
db_url = vault.get("DATABASE_URL")

# Get with default value
redis_url = vault.get("REDIS_URL", "redis://localhost:6379")

# Get all secrets as dict
all_secrets = vault.all()

# Inject all secrets into os.environ
vault.to_env()

# Force reload
vault.load()

API

Method	Description
get(key, default=None)	Get a single secret value
all()	Get all secrets as dict
load()	Force fetch from PocketVault API
to_env()	Inject all secrets into os.environ

Requirements

• Python 3.7+
• A running PocketVault instance

License

MIT