Metadata-Version: 2.4
Name: valaw
Version: 0.1.12.dev1
Summary: Async Python wrapper for the Official VALORANT API (Riot Games). Fast, typed, and easy to use.
Author: Jet612
License: MIT
Project-URL: Source, https://github.com/Jet612/valaw
Project-URL: Documentation, https://valaw.madebyjet.dev
Project-URL: Issue Tracker, https://github.com/Jet612/valaw/issues
Project-URL: Chat/Support, https://discord.gg/mVXpvunBbF
Keywords: valorant,riot-games,api-wrapper,python-valorant,async,gaming
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dataclass_wizard==0.39.1
Requires-Dist: aiohttp==3.13.3
Provides-Extra: dev
Requires-Dist: python-dotenv; extra == "dev"
Dynamic: license-file

![Valaw Banner](https://raw.githubusercontent.com/Jet612/valaw/main/assets/banner.png)

[![PyPI Version](https://img.shields.io/pypi/v/valaw?style=for-the-badge)](https://pypi.org/project/valaw/)
[![GitHub Issues](https://img.shields.io/github/issues/jet612/valaw?style=for-the-badge)](https://github.com/Jet612/valaw/issues)
[![PyPI Downloads](https://img.shields.io/pypi/dm/valaw?style=for-the-badge)](https://pypi.org/project/valaw/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/valaw?style=for-the-badge)](https://pypi.org/project/valaw/)

# valaw — Async Python Wrapper for the VALORANT API

**valaw** is a fast, typed, asynchronous Python wrapper for the [Official VALORANT API](https://developer.riotgames.com/) by Riot Games. It supports all official endpoints including match history, leaderboards, content, platform status, and console endpoints.

## Features

- **Async-first** — built on `aiohttp` for non-blocking requests
- **Typed responses** — returns typed objects instead of raw JSON (opt-out available)
- **Full endpoint coverage** — PC and console match, ranked, content, account, and status endpoints
- **Python 3.9–3.14** support

## Installation

```bash
pip install valaw
```

Or with [uv](https://github.com/astral-sh/uv):

```bash
uv add valaw
```

## Quick Start

```python
import valaw
import asyncio

async def main():
    client = valaw.Client("YOUR_RIOT_API_TOKEN", "americas")
    try:
        content = await client.GET_getContent("na", "en-US")
        print(content)
    finally:
        await client.close()

asyncio.run(main())
```

## Documentation

Full documentation including all endpoints, parameters, and examples can be found at [valaw.madebyjet.dev](https://valaw.madebyjet.dev/).

## Help & Support

- Join the [Discord Server](https://discord.gg/mVXpvunBbF) for help and support
- Open an [issue on GitHub](https://github.com/Jet612/valaw/issues) if you encounter a bug

## Quick Links

- [Documentation](https://valaw.madebyjet.dev/)
- [PyPI](https://pypi.org/project/valaw/)
- [GitHub](https://github.com/Jet612/valaw)
- [Discord](https://discord.gg/mVXpvunBbF)

---

Maintained by [Jet612](https://github.com/Jet612). Contributors can be found [here](https://github.com/Jet612/valaw/graphs/contributors).
