Metadata-Version: 2.4
Name: frontier-security
Version: 0.1.1
Summary: Python SDK for the Frontier Security platform API
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: pydantic<3,>=2.0
Description-Content-Type: text/markdown

# Frontier Security Python SDK

Python client for the [Frontier Security](https://frontier.security) platform API.

## Installation

```bash
pip install frontier-security
```

## Usage

```python
from frontier_security import FrontierSecurity

client = FrontierSecurity(api_key="sk_live_...")

# Verify your API key is valid
identity = client.verify_auth()
print(identity.tenant_id)
print(identity.permissions)
```

Or use the `FRONTIER_API_KEY` environment variable:

```python
client = FrontierSecurity()  # reads from FRONTIER_API_KEY
```

The client supports context manager usage:

```python
with FrontierSecurity(api_key="sk_live_...") as client:
    identity = client.verify_auth()
```

## Retries

Connection errors and transient HTTP responses (408, 429, and 5xx) are
retried automatically with exponential backoff, honoring the `Retry-After`
header when present. 409 Conflict is treated as a deterministic error and is
not retried. The default is 2 retries; configure it with `max_retries`
(set to `0` to disable):

```python
client = FrontierSecurity(api_key="sk_live_...", max_retries=5)
```

## Requirements

- Python 3.10+
