riotskillissue 0.1.3

Production-ready, auto-updating Riot API wrapper.

RiotSkillIssue

Production-ready, auto-updating, and fully typed Python wrapper for the Riot Games API.

Documentation · Examples · API Reference

---

Features

Feature	Description
Type-Safe	100% Pydantic models for all requests and responses
Auto-Updated	Generated daily from the Official OpenAPI Spec
Resilient	Built-in exponential backoff, circuit breakers, and Retry-After handling
Distributed	Pluggable Redis support for shared rate limiting and caching
Multi-Game	Full support for LoL, TFT, LoR, and VALORANT APIs

Installation

Requires Python 3.8+.

pip install riotskillissue

Quick Start

import asyncio
from riotskillissue import RiotClient, Platform, Region

async def main():
    async with RiotClient() as client:
        # Look up account by Riot ID
        account = await client.account.get_by_riot_id(
            region=Platform.EUROPE,
            gameName="Agurin",
            tagLine="EUW"
        )
        print(f"Found: {account.gameName}#{account.tagLine}")
        
        # Get summoner data
        summoner = await client.summoner.get_by_puuid(
            region=Region.EUW1,
            encryptedPUUID=account.puuid
        )
        print(f"Level: {summoner.summonerLevel}")

if __name__ == "__main__":
    asyncio.run(main())

Set your API key via environment variable:

export RIOT_API_KEY="RGAPI-your-key-here"

Or pass it directly:

async with RiotClient(api_key="RGAPI-...") as client:
    ...

Configuration

from riotskillissue import RiotClient, RiotClientConfig
from riotskillissue.core.cache import RedisCache

config = RiotClientConfig(
    api_key="RGAPI-...",
    max_retries=5,
    redis_url="redis://localhost:6379/0"  # Distributed rate limiting
)

cache = RedisCache("redis://localhost:6379/1")

async with RiotClient(config=config, cache=cache) as client:
    ...

Documentation

Full documentation is available at demoen.github.io/riotskillissue.

• Getting Started
• Configuration
• Examples
• API Reference
• CLI

Legal

RiotSkillIssue is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.