Metadata-Version: 2.4
Name: valopy
Version: 0.2.0
Summary: An async Python wrapper for the unofficial Valorant API.
Author: Vinc0739
Maintainer: Vinc0739
License: MIT
Project-URL: Homepage, https://github.com/Vinc0739/valopy
Project-URL: Documentation, https://valopy.readthedocs.io/
Project-URL: Repository, https://github.com/Vinc0739/valopy.git
Project-URL: Bug Tracker, https://github.com/Vinc0739/valopy/issues
Project-URL: Source Code, https://github.com/Vinc0739/valopy
Keywords: valorant,api,async,wrapper,aiohttp,python,gaming,riot-games
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Games/Entertainment :: First Person Shooters
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.13.2
Dynamic: license-file

<div align="center">
    
# Valopy

![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
[![Tests](https://github.com/Vinc0739/valopy/actions/workflows/jobs.yml/badge.svg?branch=main)](https://github.com/Vinc0739/valopy/actions/workflows/jobs.yml)

An async Python wrapper for the unofficial Valorant API.

[Documentation](https://valopy.readthedocs.io) • [PyPI](https://pypi.org/project/valopy) • [Issues](https://github.com/Vinc0739/valopy/issues) • [Discussions](https://github.com/Vinc0739/valopy/discussions)

</div>

> **Note:** ValoPy is an unofficial wrapper. It is not affiliated with or endorsed by Riot Games. Use at your own risk and ensure compliance with the unofficial Valorant API's terms of service.

> **Warning:** Since the API changes frequently and this is a typed wrapper, it may not always work when the API updates. Currently compatible with **API v4.5.0**.

## About

ValoPy is an async Python wrapper designed specifically for the **[Unofficial Valorant API](https://github.com/Henrik-3/unofficial-valorant-api)** created by **[Henrik-3](https://github.com/Henrik-3)**.

Before using this wrapper, you'll need to:
1. Create an API Key from the **[API Dashboard](https://api.henrikdev.xyz/dashboard)**
2. Read the *Before using this API* from the API Github Repository

For help with the API itself, visit the **[Discord Server](https://discord.com/invite/X3GaVkX2YN)** or check the **[API Status](https://status.henrikdev.xyz)**.

## Key Features

- 🚀 Simple async/await interface powered by asyncio
- 📦 Automatic JSON parsing for all responses
- 🔄 Built-in error handling and resilience
- 📚 Full type hints for better IDE support

## Installation

**ValoPy** is compatible **Python 3.11+**.

```bash
pip install valopy
```

### Optional Dependencies

```bash
# Development (testing, linting, type checking)
pip install valopy[dev]

# Documentation (Sphinx and related tools)
pip install valopy[docs]

```

# Quick Start

```python
import asyncio

from valopy import Client


async def get_account_info():
    async with Client(api_key="your-api-key") as client:
        # Fetch account information
        account = await client.get_account_v1("PlayerName", "TAG")

        print(f"Player: {account.name}#{account.tag}")
        print(f"PUUID: {account.puuid}")
        print(f"Region: {account.region}")
        print(f"Level: {account.account_level}")
        print(f"Last Update: {account.last_update}")


asyncio.run(get_account_info())
```


For additional examples and use cases, check out the:
- **[/examples](/examples)** directory with complete examples
- **[Documentation](https://valopy.readthedocs.io/en/latest/examples/index.html)** with more details

## Links

### ValoPy
- [Documentation](https://valopy.readthedocs.io)
- [PyPI Package](https://pypi.org/project/valopy)

### Unofficial Valorant API
- [Repository](https://github.com/Henrik-3/unofficial-valorant-api)
- [Dashboard](https://api.henrikdev.xyz/dashboard)
- [Documentation](https://docs.henrikdev.xyz)
- [Status](https://status.henrikdev.xyz)
- [Discord](https://discord.com/invite/X3GaVkX2YN)
