Metadata-Version: 2.4
Name: kuro.py
Version: 0.6.1
Summary: Async API wrapper for KuroBBS written in Python.
Project-URL: Homepage, https://github.com/Wuthery/kuro.py
Project-URL: Repository, https://github.com/Wuthery/kuro.py
Project-URL: Documentation, https://github.com/Wuthery/kuro.py
Author-email: JokelBaf <jokelbaf@gmail.com>
Maintainer-email: JokelBaf <jokelbaf@gmail.com>, seriaati <seria.ati@gmail.com>
License-Expression: GPL-3.0
License-File: LICENSE
Keywords: api,kuro,kurobbs,wraper,wuwa
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.8.4
Requires-Dist: pydantic>=2.0.1
Provides-Extra: caching
Requires-Dist: aiocache; extra == 'caching'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-asyncio; extra == 'test'
Requires-Dist: python-dotenv; extra == 'test'
Description-Content-Type: text/markdown

# kuro.py

Async API wrapper for KuroBBS and Waves game written in Python

## Usage

Basic usage example:

```python
import asyncio
import kuro

async def main() -> None:
    client = kuro.Client()
    login_result = await client.game_login("email@example.com", "password")
    print(login_result)

asyncio.run(main())
```

See [tests](tests) for more examples.

## Setting up the development environment

```bash
# Clone the repo
git clone https://github.com/Wuthery/kuro.py
cd kuro.py

# Install the dependencies
uv sync

# Install pre-commit
pre-commit install
```

## Running tests

1. Create a `.env` file in the root directory of the project and add your test account credentials:
    ```env
    TEST_EMAIL=""
    TEST_PASSWORD=""
    ```
2. Run the tests using pytest:
    ```bash
    pytest
    ```
