Metadata-Version: 2.4
Name: cloudraker
Version: 0.2.0
Summary: Python SDK for the CloudRaker API
Requires-Python: >=3.9
Requires-Dist: httpx>=0.21.2
Requires-Dist: pydantic>=1.9.2
Requires-Dist: typing-extensions>=4.0.0
Description-Content-Type: text/markdown

# cloudraker

The official Python SDK for the [CloudRaker](https://cloudraker.com) API.

## Installation

```sh
pip install cloudraker
```

## Usage

```python
from cloudraker.client import CloudRaker

client = CloudRaker(token="YOUR_API_KEY")
spaces = client.spaces.list_spaces()
```

Authenticate with an organization API key or a user access token as the
bearer `token`.

An async client is included:

```python
from cloudraker.client import AsyncCloudRaker

client = AsyncCloudRaker(token="YOUR_API_KEY")
spaces = await client.spaces.list_spaces()
```

## Error handling

Failed requests raise `cloudraker.core.ApiError` with `status_code` and `body`.

## Reference

Per-endpoint documentation with usage snippets ships with the package —
see `reference.md` inside the installed `cloudraker` package.
