Metadata-Version: 2.1
Name: ballchaser
Version: 0.4.1
Summary: Unofficial Python API client for the ballchasing.com API.
Home-page: https://github.com/tom-boyes-park/ballchaser
License: MIT
Author: Tom Boyes-Park
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: requests (>=2.27.1,<3.0.0)
Project-URL: Repository, https://github.com/tom-boyes-park/ballchaser
Description-Content-Type: text/markdown

# ballchaser ⚽️🚗
Unofficial Python API client for the ballchasing.com API.

# Getting Started
```commandline
pip install ballchaser
```

All API requests are exposed via the `BallChaser` class which is initialised with a [ballchasing.com API token](https://ballchasing.com/doc/api#header-authentication).

```python
import os
from ballchaser.client import BallChaser

ball_chaser = BallChaser(os.getenv("BALLCHASING_API_TOKEN"))

# search and retrieve replay metadata
replays = [
    replay
    for replay in ball_chaser.get_replays(player_name="GarrettG", replay_count=10)
]

# retrieve replay statistics
relay_stats = [
    ball_chaser.get_replay(replay["id"])
    for replay in replays
]
```

