Metadata-Version: 2.4
Name: outline-vpn-api-client
Version: 1.3.1
Summary: Python client for the Outline VPN Management API. Manage access keys, server settings, and metrics programmatically.
License-File: LICENSE
Keywords: outline,vpn,api,client,shadowsocks
Author: zeph1rr
Author-email: grianton535@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Provides-Extra: async
Requires-Dist: httpx[http2] (>=0.28.1,<0.29.0) ; extra == "async"
Requires-Dist: pydantic (>=2.10.4,<3.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Project-URL: Documentation, https://outline-vpn-api-client.readthedocs.io/en/latest/
Project-URL: Homepage, https://github.com/Zeph1rr/outline-vpn-api-client
Project-URL: Repository, https://github.com/Zeph1rr/outline-vpn-api-client
Description-Content-Type: text/markdown

# OUTLINE-VPN-API-CLIENT

[![PyPI - Version](https://img.shields.io/pypi/v/outline-vpn-api-client?style=plastic)](https://pypi.org/project/outline-vpn-api-client/)
![PyPI - Format](https://img.shields.io/pypi/format/outline-vpn-api-client?style=plastic)
![GitHub Release](https://img.shields.io/github/v/release/Zeph1rr/outline-vpn-api-client?style=plastic)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Zeph1rr/outline-vpn-api-client/tests.yml?style=plastic&label=tests)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/outline-vpn-api-client?style=plastic)
![GitHub License](https://img.shields.io/github/license/zeph1rr/outline-vpn-api-client?style=plastic)
[![Documentation Status](https://readthedocs.org/projects/outline-vpn-api-client/badge/?version=latest&style=plastic)](https://outline-vpn-api-client.readthedocs.io/en/latest/)


## DESCRIPTION

Python client for the [Outline VPN Management API](https://github.com/OutlineFoundation/outline-server). Manage access keys, configure server settings, and retrieve metrics — both synchronously and asynchronously.

## INSTALLATION

```bash
pip install outline-vpn-api-client
```

For async support:

```bash
pip install outline-vpn-api-client[async]
```

## QUICK START

```python
from outline_vpn_api_client import OutlineClient

client = OutlineClient(management_url="your.management.url")

# Get server info
print(client.get_information().model_dump())

# Create an access key
key = client.access_keys.create(name="Alice", limit=10**9)
print(key.accessUrl)
```

For full usage examples and API reference, see the [documentation](https://outline-vpn-api-client.readthedocs.io/en/latest/).

## HANDLING ERRORS

```python
from outline_vpn_api_client import OutlineClient, ResponseNotOkException

try:
    client.access_keys.get(999)
except ResponseNotOkException as e:
    print(e)
```

## AUTHOR

Created by **zeph1rr**  
Email: [grianton535@gmail.com](mailto:grianton535@gmail.com)
