Metadata-Version: 2.4
Name: secretcarousel
Version: 1.0.0
Summary: Python SDK for SecretCarousel — the agent-native secret vault
Author-email: Joe Wee <joe@tyga.cloud>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://secretcarousel.com
Project-URL: Documentation, https://secretcarousel.com/docs/quickstart.html
Keywords: secrets,secret-management,api-client,vault,agent-first,encryption
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# secretcarousel

Python SDK for SecretCarousel — the agent-native secret vault.

## Install

```bash
pip install secretcarousel
```

## Quick Start

```python
from secretcarousel import SecretCarouselClient

sc = SecretCarouselClient(
    api_key="sc_free_...",
    base_url="https://secretcarousel.com"
)

# Store a secret (AES-256-GCM encrypted at rest)
secret = sc.create_secret(
    name="DATABASE_URL",
    value="postgres://user:pass@host/db",
    secret_type="database-credentials"
)

# Retrieve (decrypted on demand)
result = sc.get_secret(secret["secretId"])
print(result["value"])

# List all
secrets = sc.list_secrets()
```

## Features

- Zero dependencies (stdlib urllib only)
- Full type hints (mypy compatible)
- AES-256-GCM encrypted storage
- Secret versioning and rotation
- Time-limited share links
- Complete audit trail

## API

| Method | Description |
|--------|-------------|
| `list_secrets(query?)` | List secrets (metadata only) |
| `get_secret(id)` | Get secret with decrypted value |
| `create_secret(**data)` | Create new secret |
| `update_secret(id, **data)` | Update (creates new version) |
| `delete_secret(id)` | Delete secret |
| `rotate_secret(id)` | Rotate secret |
| `export_env(query)` | Export as .env format |
| `get_audit_logs(query)` | Query audit trail |
| `create_backup(**data)` | Create encrypted backup |

## Links

- Quick Start: https://secretcarousel.com/docs/quickstart.html
- API Reference: https://secretcarousel.com/api
- CLI: https://www.npmjs.com/package/secretcarousel

## License

Proprietary — Tyga.Cloud Ltd. See LICENSE file.
