Metadata-Version: 2.4
Name: secenvvault
Version: 1.0.2
Summary: Zero-Knowledge .env & secret orchestration CLI and SDK for developers and teams.
Author: SecEnvVault Team
Author-email: SecEnvVault Team <support@secenvvault.com>
License-Expression: MIT
Keywords: secrets,env,dotenv,vault,zero-knowledge,security,credentials
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: requires-python

# SecEnvVault Python SDK & CLI

> Zero-Knowledge .env & secret orchestration CLI and SDK for Python developers, teams, and CI/CD pipelines.

[![PyPI version](https://img.shields.io/pypi/v/secenvvault.svg)](https://pypi.org/project/secenvvault/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

SecEnvVault eliminates plaintext `.env` files floating across developer machines and repositories. Secrets are injected directly into process memory with **zero disk writes**.

---

## 📦 Installation

```bash
pip install secenvvault
```

---

## 🚀 Quickstart

### 1. Python SDK Usage

#### Automatic `os.environ` Injection at Startup (Django, FastAPI, Flask):
```python
import os
from secenvvault import load_secrets

# Loads secrets into os.environ before app initialization:
load_secrets(environment="production")

print(os.getenv("DATABASE_URL"))
```

#### Scoped Sandbox Execution (Context Manager):
```python
from secenvvault import with_secrets

# Temporarily injects secrets and restores previous environment on exit:
with with_secrets(environment="staging"):
    run_database_migrations()
```

#### Programmatic Client:
```python
from secenvvault import SecEnvVaultClient

client = SecEnvVaultClient()
stripe_key = client.get_secret("STRIPE_SECRET_KEY", environment="production")
```

---

## ⚡ CLI Runner

The Python package includes the CLI runner for Python-only environments:

```bash
secenvvault run -e production -- python main.py
# or shorthand:
sev run -- uvicorn app.main:app --port 8000
```

---

## 🛡️ Security
* **Zero Third-Party Dependencies**: Built exclusively with Python standard library.
* **In-Memory Injection**: Process environment variables never touch disk.
* **Encrypted API Communication**: Direct HTTPS with SecEnvVault backend.

---

## 📄 License
MIT © SecEnvVault
