riotskillissue 0.1.0__tar.gz

riotskillissue-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/riotskillissue
+    permissions:
+      contents: read
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: pip install hatch
+
+      - name: Build
+        run: hatch build
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

riotskillissue-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "${{ matrix.python-version }}"
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Run Tests
+        run: |
+          pytest tests/

riotskillissue-0.1.0/.github/workflows/update_sdk.yml

@@ -0,0 +1,50 @@
+name: Update SDK
+
+on:
+  schedule:
+    - cron: '0 0 * * 0' # Weekly
+  workflow_dispatch:
+
+jobs:
+  update-sdk:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: |
+          pip install -e .
+          pip install deepdiff rich # Extra dev tools for manager
+
+      - name: Fetch Spec & Generate Code
+        run: |
+          python tools/manager.py
+          python tools/generator/core.py
+
+      - name: Check for changes
+        id: git-diff
+        run: |
+          git diff --exit-code || echo "changes=true" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        if: steps.git-diff.outputs.changes == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "feat: update riot api spec"
+          title: "feat: Update Riot API Spec"
+          body: |
+            This PR updates the Riot API SDK based on the latest OpenAPI spec.
+            
+            See the diff report in `reports/` (if generated).
+          branch: update-sdk-spec
+          base: main

riotskillissue-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+.env
+.venv/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+coverage.xml
+.coverage
+/spec/

riotskillissue-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Demoen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

riotskillissue-0.1.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: riotskillissue
+Version: 0.1.0
+Summary: Production-ready, auto-updating Riot API wrapper.
+Author-email: Antigravity <bot@example.com>
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.8
+Requires-Dist: frozendict>=2.4.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: msgspec>=0.18.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: redis>=5.0.0
+Requires-Dist: tenacity>=8.2.0
+Provides-Extra: dev
+Requires-Dist: deepdiff>=6.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Requires-Dist: rich>=13.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: typer>=0.12.0; extra == 'dev'
+Requires-Dist: types-redis; extra == 'dev'
+Requires-Dist: types-requests; extra == 'dev'

riotskillissue-0.1.0/README.md

@@ -0,0 +1,171 @@
+# Riot API Wrapper
+
+Production-ready, auto-updating, and fully typed Python wrapper for the Riot Games API.
+
+## 🚀 Features
+
+- **100% Coverage**: Auto-generated from the [Official OpenAPI Spec](https://github.com/MingweiSamuel/riotapi-schema). Supports League of Legends, TFT, LoR, and VALORANT.
+- **Type-Safe**: All requests and responses use **Pydantic** models. No more `KeyError` or dictionary guessing.
+- **Resilient**: Built-in **Exponential Backoff**, **Circuit Breakers** (for 5xx), and **Rate Limiting** (Respects `Retry-After`).
+- **Distributed Ready**: Pluggable **Redis Rate Limiting** (Lua Scripted) and **Caching**.
+- **Developer Experience**: Includes **CLI**, **Smart Pagination**, **Data Dragon** helpers, and **Hooks**.
+
+---
+
+## 📦 Installation
+
+This package requires **Python 3.8+**.
+
+```bash
+# Install from source
+pip install -e .
+```
+
+---
+
+## ⚡ Quickstart
+
+```python
+import asyncio
+from riotskillissue import RiotClient, Region
+
+async def main():
+    # 1. Initialize Client (Auto-loads RIOT_API_KEY from env)
+    async with RiotClient() as client:
+    
+        # 2. Call API (Type-hinted!)
+        # Automatically converts "getByPUUID" -> "get_by_puuid"
+        summoner = await client.summoner.get_by_puuid(
+             region=Region.NA1,
+             encryptedPUUID="<YOUR_PUUID>"
+        )
+        
+        print(f"Level: {summoner.summonerLevel}")
+        
+        # 3. Match History (with Pagination)
+        from riotskillissue import paginate
+        async for match_id in paginate(client.match.get_ids_by_puuid, puuid=summoner.puuid, count=20):
+             print(f"Match: {match_id}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## 🛠 Configuration
+
+The client is highly configurable via `RiotClientConfig`.
+
+```python
+from riotskillissue import RiotClientConfig, RiotClient
+
+config = RiotClientConfig(
+    api_key="RGAPI-...",          # Or set RIOT_API_KEY env var
+    connect_timeout=5.0,          # Initial connection timeout (s)
+    read_timeout=10.0,            # Response read timeout (s)
+    max_retries=3,                # Max attempts for 5xx/Connectivity errors
+    redis_url="redis://localhost" # Enable Distributed Rate Limiting
+)
+```
+
+| Parameter | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `api_key` | `str` | `None` | Riot API Key. Defaults to `os.environ["RIOT_API_KEY"]`. |
+| `redis_url` | `str` | `None` | Connection string for Redis (e.g. `redis://127.0.0.1:6379`). Required for **Distributed Rate Limiting**. |
+| `max_retries` | `int` | `3` | Attempts for network/server errors. |
+| `connect_timeout` | `float` | `5.0` | Headers wait timeout. |
+| `read_timeout` | `float` | `10.0` | Body wait timeout. |
+
+---
+
+## 🧠 Advanced Features
+
+### 1. Caching
+Reduce API usage by enabling the caching layer.
+
+```python
+from riotskillissue.core.cache import RedisCache, MemoryCache
+
+# In-Memory (Single Process)
+cache = MemoryCache()
+
+# Redis (Distributed)
+cache = RedisCache("redis://localhost:6379/1")
+
+async with RiotClient(cache=cache) as client:
+    # 200 OK GET requests are cached automatically (Default TTL: 60s)
+    # Static Data is cached longer (versions: 1h, champions: 24h)
+    ...
+```
+
+### 2. Static Data (Data Dragon)
+Auto-fetch champion info without managing version strings.
+
+```python
+# Fetches latest version -> fetches champion.json -> caches it
+annie = await client.static.get_champion(1)
+print(annie["name"]) # "Annie"
+```
+
+### 3. Riot Sign-On (RSO)
+OAuth2 helper for web apps.
+
+```python
+from riotskillissue.auth import RsoClient, RsoConfig
+
+rso = RsoClient(RsoConfig(
+    client_id="...", 
+    client_secret="...", 
+    redirect_uri="http://localhost/callback"
+))
+
+# 1. Redirect user here
+auth_url = rso.get_auth_url() 
+
+# 2. Exchange code for tokens
+tokens = await rso.exchange_code("authorization_code")
+```
+
+### 4. CLI Tool
+Quick debug from terminal.
+
+```bash
+# Basic Lookup
+riotskillissue-cli summoner "Faker#SKT" --region kr
+
+# Match Details
+riotskillissue-cli match "KR_1234567890"
+
+# Help
+riotskillissue-cli --help
+```
+
+---
+
+## 🧪 Testing
+
+This repo comes with a comprehensive test suite.
+
+```bash
+# Run all tests (Unit + Integration + Mocked Edge Cases)
+pytest tests/
+
+# Run specific suite
+pytest tests/test_resiliency.py
+```
+
+## 🤖 Automation
+
+How this library stays up to date:
+1. **Weekly Action**: `.github/workflows/update_sdk.yml` runs.
+2. **Fetch**: Downloads `openapi.json` from [MingweiSamuel/riotapi-schema](https://github.com/MingweiSamuel/riotapi-schema).
+3. **Diff**: Compares with current generated definitions.
+4. **Generate**: Re-runs `tools/generator/core.py`.
+5. **PR**: Opens a Pull Request with the changes and a changelog.
+
+---
+
+## 📄 License
+
+MIT

riotskillissue-0.1.0/docs/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+## Development Setup
+
+1. Clone the repo.
+2. Install dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   pip install httpx pydantic redis tenacity jinja2 frozendict msgspec deepdiff rich typer
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   # Or manual verification
+   python tests/manual_test.py
+   ```
+
+## Code Generation
+
+The SDK is generated from the OpenAPI spec. To regenerate:
+
+```bash
+# Fetch latest spec
+python tools/manager.py
+
+# Generate code
+python tools/generator/core.py
+```
+
+## Release Process
+
+1. **Tag**: Create a new GitHub release with a tag (e.g., `v0.1.0`).
+2. **Publish**: The GitHub Action `.github/workflows/publish.yml` will automatically build and push to PyPI using Trusted Publishing.
+3. **Verify**: Check [PyPI project page](https://pypi.org/p/riot-wrapper).

riotskillissue-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project.scripts]
+riotskillissue-cli = "riotskillissue.cli:main"
+
+[project]
+name = "riotskillissue"
+version = "0.1.0"
+description = "Production-ready, auto-updating Riot API wrapper."
+authors = [{ name = "Antigravity", email = "bot@example.com" }]
+requires-python = ">=3.8"
+dependencies = [
+    "httpx>=0.27.0",
+    "pydantic>=2.7.0",
+    "redis>=5.0.0",
+    "tenacity>=8.2.0",
+    "jinja2>=3.1.0",
+    "frozendict>=2.4.0",  # For immutable specs
+    "msgspec>=0.18.0",    # Fast JSON parsing for large specs
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.13",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
+    "respx>=0.21.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "typer>=0.12.0",     # For CLI tools
+    "rich>=13.7.0",      # For pretty CLI output
+    "types-redis",
+    "types-requests",
+    "deepdiff>=6.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/riotskillissue"]
+
+[tool.mypy]
+strict = true
+ignore_missing_imports = true
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]

riotskillissue-0.1.0/src/riotskillissue/__init__.py

@@ -0,0 +1,5 @@
+from .core.client import RiotClient, RiotClientConfig
+from .core.types import Region, Platform
+from .core.pagination import paginate
+
+__all__ = ["RiotClient", "RiotClientConfig", "Region", "Platform", "paginate"]

riotskillissue-0.1.0/src/riotskillissue/api/client_mixin.py

@@ -0,0 +1,131 @@
+# Generated Code. Do not edit.
+from riotskillissue.core.http import HttpClient
+
+from riotskillissue.api.endpoints.lol_challenges import Lol_challengesApi
+
+from riotskillissue.api.endpoints.champion_mastery import Champion_masteryApi
+
+from riotskillissue.api.endpoints.clash import ClashApi
+
+from riotskillissue.api.endpoints.league_exp import League_expApi
+
+from riotskillissue.api.endpoints.league import LeagueApi
+
+from riotskillissue.api.endpoints.match import MatchApi
+
+from riotskillissue.api.endpoints.champion import ChampionApi
+
+from riotskillissue.api.endpoints.lol_rso_match import Lol_rso_matchApi
+
+from riotskillissue.api.endpoints.spectator_tft import Spectator_tftApi
+
+from riotskillissue.api.endpoints.spectator import SpectatorApi
+
+from riotskillissue.api.endpoints.lol_status import Lol_statusApi
+
+from riotskillissue.api.endpoints.summoner import SummonerApi
+
+from riotskillissue.api.endpoints.tournament_stub import Tournament_stubApi
+
+from riotskillissue.api.endpoints.tournament import TournamentApi
+
+from riotskillissue.api.endpoints.lor_deck import Lor_deckApi
+
+from riotskillissue.api.endpoints.lor_inventory import Lor_inventoryApi
+
+from riotskillissue.api.endpoints.lor_match import Lor_matchApi
+
+from riotskillissue.api.endpoints.lor_ranked import Lor_rankedApi
+
+from riotskillissue.api.endpoints.lor_status import Lor_statusApi
+
+from riotskillissue.api.endpoints.riftbound_content import Riftbound_contentApi
+
+from riotskillissue.api.endpoints.account import AccountApi
+
+from riotskillissue.api.endpoints.tft_league import Tft_leagueApi
+
+from riotskillissue.api.endpoints.tft_match import Tft_matchApi
+
+from riotskillissue.api.endpoints.tft_status import Tft_statusApi
+
+from riotskillissue.api.endpoints.tft_summoner import Tft_summonerApi
+
+from riotskillissue.api.endpoints.val_console_ranked import Val_console_rankedApi
+
+from riotskillissue.api.endpoints.val_content import Val_contentApi
+
+from riotskillissue.api.endpoints.val_console_match import Val_console_matchApi
+
+from riotskillissue.api.endpoints.val_match import Val_matchApi
+
+from riotskillissue.api.endpoints.val_ranked import Val_rankedApi
+
+from riotskillissue.api.endpoints.val_status import Val_statusApi
+
+
+class GeneratedClientMixin:
+    def __init__(self, http: HttpClient):
+        
+        self.lol_challenges = Lol_challengesApi(http)
+        
+        self.champion_mastery = Champion_masteryApi(http)
+        
+        self.clash = ClashApi(http)
+        
+        self.league_exp = League_expApi(http)
+        
+        self.league = LeagueApi(http)
+        
+        self.match = MatchApi(http)
+        
+        self.champion = ChampionApi(http)
+        
+        self.lol_rso_match = Lol_rso_matchApi(http)
+        
+        self.spectator_tft = Spectator_tftApi(http)
+        
+        self.spectator = SpectatorApi(http)
+        
+        self.lol_status = Lol_statusApi(http)
+        
+        self.summoner = SummonerApi(http)
+        
+        self.tournament_stub = Tournament_stubApi(http)
+        
+        self.tournament = TournamentApi(http)
+        
+        self.lor_deck = Lor_deckApi(http)
+        
+        self.lor_inventory = Lor_inventoryApi(http)
+        
+        self.lor_match = Lor_matchApi(http)
+        
+        self.lor_ranked = Lor_rankedApi(http)
+        
+        self.lor_status = Lor_statusApi(http)
+        
+        self.riftbound_content = Riftbound_contentApi(http)
+        
+        self.account = AccountApi(http)
+        
+        self.tft_league = Tft_leagueApi(http)
+        
+        self.tft_match = Tft_matchApi(http)
+        
+        self.tft_status = Tft_statusApi(http)
+        
+        self.tft_summoner = Tft_summonerApi(http)
+        
+        self.val_console_ranked = Val_console_rankedApi(http)
+        
+        self.val_content = Val_contentApi(http)
+        
+        self.val_console_match = Val_console_matchApi(http)
+        
+        self.val_match = Val_matchApi(http)
+        
+        self.val_ranked = Val_rankedApi(http)
+        
+        self.val_status = Val_statusApi(http)
+