Metadata-Version: 2.4
Name: cora-vault
Version: 0.1.0
Summary: Minimal Python client for Cora Vault secret engines
Author: mentor
License: MIT
Project-URL: Homepage, https://github.com/kenmentor/cora-vault
Project-URL: Repository, https://github.com/kenmentor/cora-vault
Keywords: vault,secrets,key-management,devops
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# cora-vault-client

Minimal Python client for [Cora Vault](https://github.com/kenmentor/cora-vault)
secret engines. Stdlib only — no dependencies.

## Install

```bash
pip install cora-vault-client
```

## Use

```python
import os
from cora_vault import Vault

vault = Vault(endpoint="http://localhost:3000")  # https in production
secret = vault.load_cluster("shop/prod", api_key="cv_...")
print(secret["token_value"])   # or os.environ["TOKEN_VALUE"]
```

`load_cluster` returns `{"token_value", "label", "cluster", "expires_at"}`
and mirrors the fields into `os.environ` (upper-cased) for drop-in config
use. Raises `VaultError` with a plain-English reason on 401/403/404/429.

Generate the per-engine API key in the vault dashboard
(engine → Settings → API keys). Service keys are presented as the
`x-api-key` header.
