Metadata-Version: 2.4
Name: airena-player-client
Version: 0.1.0
Summary: Add your description here
Author-email: Henry Jones <henryivesjones@gmail.com>
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic-settings>=2.9.1
Requires-Dist: pydantic>=2.11.4
Description-Content-Type: text/markdown

# Airena Python Player Client

`airena-player-client` is a python package for interacting with the airena game server, allowing you to queue for games, manage game state, and submit moves programmatically.

## Features
- Queue for games and manage matchmaking
- Fetch and update game state
- Submit moves and handle game progression
- Typed models for game state and moves

## Installation

```bash
pip install airena-player-client
uv add airena-player-client
```

## Quick Start

```python
from airena_player_client import AirenaPlayerClient

client = AirenaPlayerClient()

# Enter the matchmaking queue
client.enter_queue(game_type="your_game_type_id")

# Wait for a match
client.wait_for_match()

# Main game loop
while True:
    # Wait for your next action.
	client.wait_for_next_action()
    # Exit this loop if the game is over.
	if client.is_game_over():
		break
    # Inspect the new game state
    client.state.game_state
    # Submit a move
    client.make_move({"foo": "bar"}) 

```

## Environment Configuration

You can configure the client using environment variables:

- `AIRENA_UGI_URL` — Airena game server URL
- `AIRENA_API_KEY` — Your API key

## License

MIT

## Author

Henry Jones (<henryivesjones@gmail.com>)
