Metadata-Version: 2.4
Name: serva
Version: 0.1.0
Summary: Official Python client for the Serva encode/decode API
Author: Servamind
License: Proprietary - All Rights Reserved
Project-URL: Homepage, https://serva.servamind.com
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Dynamic: license-file

# serva

Official Python client for the Serva encode/decode API.

## Install

```bash
pip install serva
```

## Usage

Generate an API key from [serva.servamind.com](https://serva.servamind.com), then:

```python
from serva import Serva

client = Serva(api_key="sk_live_...")   # or set SERVA_API_KEY

# Encode a file to the .serva format
result = client.encode("photo.raw", password="my-secret")
print(result.output_path, result.savings_percent)

# Decode it back
client.decode("photo.serva", password="my-secret", output="photo.raw")
```

## Configuration

| Setting | How | Default |
|---|---|---|
| API key | `Serva(api_key=...)` or `SERVA_API_KEY` | — (required) |
| Base URL | `Serva(base_url=...)` or `SERVA_BASE_URL` | `https://serva.servamind.com` |



## Errors

All failures raise a subclass of `ServaError`: `AuthError` (401),
`PaymentRequiredError` (403), `FileTooLargeError` (413), `RateLimitError` (429).

## Versioning

Semantic versioning. The current version is available as `serva.__version__`.
