Metadata-Version: 2.3
Name: pixivutil-server-client
Version: 0.1.0
Summary: Async aiohttp client SDK for PixivUtil Server
Author: psilabs-dev
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: pydantic>=2.12.4
Requires-Dist: pixivutil-server-common>=0.1.0
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# pixivutil-server-client

Async `aiohttp` client SDK for PixivUtil Server.

## Example

```python
import asyncio

from pixivutil_client import PixivAsyncClient


async def main() -> None:
    async with PixivAsyncClient(
        base_url="http://localhost:8000",
        api_key="your-api-key",
    ) as client:
        health = await client.health()
        print(health)

        queued = await client.queue_download_artwork(123456)
        print(queued.task_id)


asyncio.run(main())
```

## Install

From PyPI:

```sh
uv pip install pixivutil-server-client
```

From the `pixivutil-server` project root:

```sh
uv pip install -e ./PixivUtilClient
```

From Git (published as a subdirectory):

```sh
uv pip install "git+https://github.com/psilabs-dev/pixivutil-server.git@dev-2.4.0/main#subdirectory=PixivUtilClient"
```

## Test

From the `pixivutil-server` project root:

```sh
uv run --package pixivutil-server-client pytest PixivUtilClient/tests
```
