riotskillissue 0.1.0__py3-none-any.whl

riotskillissue/core/types.py

@@ -0,0 +1,57 @@
+from typing import NewType, Dict
+
+try:
+    from enum import StrEnum
+except ImportError:
+    from enum import Enum
+    class StrEnum(str, Enum):
+        pass
+
+class Region(StrEnum):
+
+    BR1 = "br1"
+    EUN1 = "eun1"
+    EUW1 = "euw1"
+    JP1 = "jp1"
+    KR = "kr"
+    LA1 = "la1"
+    LA2 = "la2"
+    NA1 = "na1"
+    OC1 = "oc1"
+    TR1 = "tr1"
+    RU = "ru"
+    PH2 = "ph2"
+    SG2 = "sg2"
+    TH2 = "th2"
+    TW2 = "tw2"
+    VN2 = "vn2"
+
+class Platform(StrEnum):
+    AMERICAS = "americas"
+    ASIA = "asia"
+    EUROPE = "europe"
+    SEA = "sea"
+
+# Helper to map Region -> Platform
+REGION_TO_PLATFORM: Dict[Region, Platform] = {
+    Region.BR1: Platform.AMERICAS,
+    Region.NA1: Platform.AMERICAS,
+    Region.LA1: Platform.AMERICAS,
+    Region.LA2: Platform.AMERICAS,
+    Region.KR: Platform.ASIA,
+    Region.JP1: Platform.ASIA,
+    Region.EUN1: Platform.EUROPE,
+    Region.EUW1: Platform.EUROPE,
+    Region.TR1: Platform.EUROPE,
+    Region.RU: Platform.EUROPE,
+    Region.OC1: Platform.SEA,
+    Region.PH2: Platform.SEA,
+    Region.SG2: Platform.SEA,
+    Region.TH2: Platform.SEA,
+    Region.TW2: Platform.SEA,
+    Region.VN2: Platform.SEA,
+}
+
+Puuid = NewType("Puuid", str)
+SummonerId = NewType("SummonerId", str)
+AccountId = NewType("AccountId", str)

riotskillissue/core/utils.py

@@ -0,0 +1,25 @@
+import asyncio
+from typing import TypeVar, Iterable, Awaitable, List
+
+T = TypeVar("T")
+
+async def gather_limited(tasks: Iterable[Awaitable[T]], limit: int = 10) -> List[T]:
+    """
+    Run tasks concurrently with a limit on the number of active tasks.
+    Useful for batching requests without overwhelming the local event loop or 
+    exceeding simplified concurrency limits.
+    
+    Args:
+        tasks: Iterable of awaitables.
+        limit: Max concurrent tasks.
+        
+    Returns:
+        List of results in order.
+    """
+    sem = asyncio.Semaphore(limit)
+
+    async def run_with_sem(task: Awaitable[T]) -> T:
+        async with sem:
+            return await task
+
+    return await asyncio.gather(*(run_with_sem(t) for t in tasks))

riotskillissue/static.py

@@ -0,0 +1,71 @@
+from typing import Optional, Dict, Any, List
+import httpx
+from .core.cache import AbstractCache, NoOpCache
+
+class DataDragonClient:
+    """
+    Client for Riot's Data Dragon static data service.
+    Automatically handles versioning and caching.
+    """
+    params = {} # No auth needed
+
+    def __init__(self, cache: Optional[AbstractCache] = None):
+        self.base_url = "https://ddragon.leagueoflegends.com"
+        self.http = httpx.AsyncClient()
+        self.cache = cache or NoOpCache()
+        self.version: Optional[str] = None
+    
+    async def get_latest_version(self) -> str:
+        """Fetch the latest version of Data Dragon."""
+        if self.version:
+            return self.version
+            
+        cache_key = "ddragon:version"
+        cached = await self.cache.get(cache_key)
+        if cached:
+            self.version = cached
+            return cached
+            
+        resp = await self.http.get(f"{self.base_url}/api/versions.json")
+        versions = resp.json()
+        latest = versions[0]
+        
+        await self.cache.set(cache_key, latest, ttl=3600) # Cache for 1 hour
+        self.version = latest
+        return latest
+
+    async def get_champion(self, champion_key: int) -> Optional[Dict[str, Any]]:
+        """
+        Get champion data by ID (key).
+        e.g. 1 -> Annie
+        """
+        version = await self.get_latest_version()
+        
+        # We need to fetch the full champion list to map ID -> Data
+        # Ideally we cache this heavy object
+        cache_key = f"ddragon:{version}:champions"
+        
+        champions_map = await self.cache.get(cache_key)
+        if not champions_map:
+            resp = await self.http.get(f"{self.base_url}/cdn/{version}/data/en_US/champion.json")
+            data = resp.json()["data"]
+            
+            # Map by "key" (ID) which is string in JSON but usually treated as int
+            champions_map = {int(c["key"]): c for c in data.values()}
+            await self.cache.set(cache_key, champions_map, ttl=86400) # Cache for 24h
+            
+        return champions_map.get(champion_key)
+    
+    async def get_item(self, item_id: int) -> Optional[Dict[str, Any]]:
+        """Get item data by ID."""
+        version = await self.get_latest_version()
+        cache_key = f"ddragon:{version}:items"
+        
+        items_map = await self.cache.get(cache_key)
+        if not items_map:
+            resp = await self.http.get(f"{self.base_url}/cdn/{version}/data/en_US/item.json")
+            data = resp.json()["data"]
+            items_map = {int(k): v for k, v in data.items()}
+            await self.cache.set(cache_key, items_map, ttl=86400)
+            
+        return items_map.get(item_id)

riotskillissue/testing.py

@@ -0,0 +1,46 @@
+from contextlib import asynccontextmanager
+import respx
+from httpx import Response
+from typing import Dict, Any, Union, Optional
+from .core.client import RiotClient
+
+class RiotMock:
+    """
+    Mock server utility for testing Riot API integrations.
+    Wraps respx for easier Riot-specific mocking.
+    """
+    def __init__(self):
+        self.mocker = respx.mock
+        
+    @asynccontextmanager
+    async def configure(self, base_url: str = "https://na1.api.riotgames.com"):
+        """
+        Context manager to mock API calls.
+        
+        Usage:
+            mock = RiotMock()
+            async with mock.configure() as m:
+                m.get("/lol/summoner/v4/summoners/by-name/Faker").respond(200, json={...})
+                # run client code
+        """
+        async with self.mocker(base_url=base_url) as mock:
+            yield mock
+            
+    # Helpers for common mocks
+    @staticmethod
+    def mock_summoner(mock: respx.MockRouter, puuid: str, region: str = "na1", level: int = 30):
+        """Helper to mock a summoner response."""
+        return mock.get(f"/lol/summoner/v4/summoners/by-puuid/{puuid}").respond(
+            200, 
+            json={
+                "id": "summ_id",
+                "accountId": "acc_id",
+                "puuid": puuid,
+                "name": "MockSummoner",
+                "profileIconId": 1,
+                "revisionDate": 1600000000000,
+                "summonerLevel": level
+            }
+        )
+
+__all__ = ["RiotMock"]

riotskillissue-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,75 @@
+riotskillissue/__init__.py,sha256=CA0b9B2kxezDDPJcxWlXQco6kLn4LfP0c0CxREf6I14,213
+riotskillissue/auth.py,sha256=K2Soa6sm7RsGxshfGaJPAPVyz4CnSPGR66Xeid0R4aY,2247
+riotskillissue/cli.py,sha256=fsZKP81jKYgH1SKQGl5eE0NWpt84TGCT_SktE-ryHBM,3774
+riotskillissue/static.py,sha256=dVwuiKe85hWRrRpS0kfWEQZChioRVyMKlGjWD3mGfvQ,2707
+riotskillissue/testing.py,sha256=idkJJr8yI_xzufpvRYkB0ovdpFXGXFsEFHNcJj32e_o,1493
+riotskillissue/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+riotskillissue/api/client_mixin.py,sha256=_WuGSuKL7qTq6oOutXhn7bK0qPtDMLGT7gyybkWaY9U,4029
+riotskillissue/api/models.py,sha256=yosETBytjNySKckSnLGZLQaif4hw-fzZM3xxAMYnAC0,122391
+riotskillissue/api/endpoints/account.py,sha256=6Gq106k7kTnnsMLpLRYp6-4DWsKSUeCXFAqB1DruTaA,4693
+riotskillissue/api/endpoints/champion-mastery.py,sha256=VyO-hFuK5CkLpE9eUOP_zp4WYboomYacsACZvJGTMq8,3968
+riotskillissue/api/endpoints/champion.py,sha256=8Ls54phsA_S1LT_Z8bLVrBiFLa6PdM6vzUQuQ7UxNao,1061
+riotskillissue/api/endpoints/champion_mastery.py,sha256=nSLRYA4QfqI6_dNtPMZl4tLUJb4_BUPcc83wIGQPto0,4416
+riotskillissue/api/endpoints/clash.py,sha256=ujVhgAJRA9FCEvhMjGSGLbydDeWZlnaYiNH1II0tLWk,4340
+riotskillissue/api/endpoints/league-exp.py,sha256=5aq317iy1WVYaqWSs3r_NV4jBAely8K5MYI5s-9iLzM,1312
+riotskillissue/api/endpoints/league.py,sha256=may-2Yek1uNgci03PjKKxNdVoakMGLQRtCC462dEfYE,5783
+riotskillissue/api/endpoints/league_exp.py,sha256=QSrNo_ZP4HTs0aPKvc3fgVBvHgpGnGH4EJkbnJ0xTC8,1411
+riotskillissue/api/endpoints/lol-challenges.py,sha256=UkkDAOcfQKGLf6fCVcJjnPsVloKF_yOm8k5FHbrZnpg,5167
+riotskillissue/api/endpoints/lol-rso-match.py,sha256=0CmAwiPdz1418aY_8xOkrND7jYgPcl-OjCvfUXwrEY0,2851
+riotskillissue/api/endpoints/lol-status.py,sha256=KcNsWxTAdu2Sf1kiqil9rThFCVD5KWirrkbgCxPG2Ds,930
+riotskillissue/api/endpoints/lol_challenges.py,sha256=1XhmnSfL9AHddx7Xl_bPnETUVPmFZfaULaT2OAQ9eIo,5883
+riotskillissue/api/endpoints/lol_rso_match.py,sha256=1f4E--TFgNoSGnbkGkEHagPVIVCtMTF7T-aD8h4s1mo,3142
+riotskillissue/api/endpoints/lol_status.py,sha256=MT9y67CkPwBJu1pAVjNIJsrm-9P2OUta_BDHRVqZQ18,1024
+riotskillissue/api/endpoints/lor-deck.py,sha256=T2q87NFjcfOMWM41UCUdHSnGLS-vcuEtfQfkkEBZxt4,1492
+riotskillissue/api/endpoints/lor-inventory.py,sha256=K3yhPmBZNYRwseJk0nGs1aP91xgQjwfidIV5z3pbH5Q,921
+riotskillissue/api/endpoints/lor-match.py,sha256=4KN2dCyOYO1gmub0uzM2pNdJoRNulkoHWUJ2Z1apFt8,1713
+riotskillissue/api/endpoints/lor-ranked.py,sha256=qJYaXZJi9jM3MUtc6N1QX8xlnWYmkq1p8cUrlR27cjA,906
+riotskillissue/api/endpoints/lor-status.py,sha256=DpQW7kb2Cl3UUBfmQoECoS8s9FFqjg8O-ZQaGzrjEaQ,933
+riotskillissue/api/endpoints/lor_deck.py,sha256=0jGhps1aNhDr2IN6VxwsstQez6oBJj84lxR7cI--sx8,1675
+riotskillissue/api/endpoints/lor_inventory.py,sha256=YXLWO9eS2_6s2OjiaqBZmHVLOIY5XqdEM97UjkInDxM,1016
+riotskillissue/api/endpoints/lor_match.py,sha256=0X9jqVwoVdKSWoCflkexU2Rd9DZuTK_4kQvOPMjQuUs,1894
+riotskillissue/api/endpoints/lor_ranked.py,sha256=GLlfkFavyZK8T5r3Q1UKW1vugAkXEx9H2IUF69nphlM,999
+riotskillissue/api/endpoints/lor_status.py,sha256=TCN8RLYW1W6bCuyIxy-nAaHEODwxWZEAQVFlVwY1KHM,1027
+riotskillissue/api/endpoints/match.py,sha256=1GkY9NDtizQk9FkzoPIE7-dfkr49D_kl6W3XNUh6vQA,4027
+riotskillissue/api/endpoints/riftbound-content.py,sha256=EPJv5byGlk0HxGOqO9eFT6yxKyeLtYv8YDBCU1x00KY,993
+riotskillissue/api/endpoints/riftbound_content.py,sha256=AedcAu9oaa7j7wsQlIZS92qR00rgUUb-sncQtlVceWU,1098
+riotskillissue/api/endpoints/spectator-tft.py,sha256=Qp8K-mbupK5qLRXQRP7H_STYSetbc5kMG1KAjrX9_5s,1104
+riotskillissue/api/endpoints/spectator.py,sha256=jv5s8JvPAgNP8__WlrUIcDuCWQTpL57Yy9aMPrq5J8k,1188
+riotskillissue/api/endpoints/spectator_tft.py,sha256=ldMICn5XMMzTv-szfn8eJSMrCTxnGSOOQkfMbYIgHSg,1201
+riotskillissue/api/endpoints/summoner.py,sha256=vr90aMPAxeAUCnTTLDf_WmtV8ZYHxRyTvpupXJyouPs,1863
+riotskillissue/api/endpoints/tft-league.py,sha256=saz0GCpDV9u05rzdZk1SvT7ZHqDtakXSH9U8PFB1NU8,5646
+riotskillissue/api/endpoints/tft-match.py,sha256=cnDj4G4OkjSK15ntxdIzaxLjE3fdamzpabqspps6MwE,2047
+riotskillissue/api/endpoints/tft-status.py,sha256=Tz4mGgKF45ba4jycHxATjA69CZavywiqYR5uq4yeL-I,930
+riotskillissue/api/endpoints/tft-summoner.py,sha256=LP_g0PDTIFrMMAtym0Ho7ANrx8A82C1B8BvcM-Zpems,1678
+riotskillissue/api/endpoints/tft_league.py,sha256=EgLvJxA-zUZJe2ZOvxAC2WWTeEmK2lhiyqgTlQeCEbQ,6465
+riotskillissue/api/endpoints/tft_match.py,sha256=DUL5IOBXKhN8fDGu4jNj-o6j0fCf8ekTgstYWERJiT4,2228
+riotskillissue/api/endpoints/tft_status.py,sha256=9lxIZDC9PWFDeCLvWtkpTokbBZJg1QM1fJpyHd0HKn8,1024
+riotskillissue/api/endpoints/tft_summoner.py,sha256=0z_2cE1BvEmDv_eMFg161_z0BNSysNwSh8VCUG1Sy8M,1883
+riotskillissue/api/endpoints/tournament-stub.py,sha256=T0bvyWaFvtA-rZ9FY6lgIYAwMokLG48OEK50nfvWa0A,4044
+riotskillissue/api/endpoints/tournament.py,sha256=ZEmv_pvK-uE8tfJshKVMnsL6PijWsRZgidzmFF3Ed1g,6127
+riotskillissue/api/endpoints/tournament_stub.py,sha256=pWuhRbNWAZxjnOnabCtyPrg-C7JmAYkLtK672fIuHlg,4563
+riotskillissue/api/endpoints/val-console-match.py,sha256=285-76hj1EI8PNAq4lOqEFzJL3AxgMB3e8W_EuKyoUQ,2609
+riotskillissue/api/endpoints/val-console-ranked.py,sha256=IDKxvb95NU5x7Wjh-mUaVpC_UEX8QS3YHU6hA_AlwfE,1310
+riotskillissue/api/endpoints/val-content.py,sha256=4MPiPnbk0iOK98HPinK1hd5jLUZ6GXi08B0QtEVioQ4,986
+riotskillissue/api/endpoints/val-match.py,sha256=oPf_atPXSxGHz3C4hFBrRWtdjmAiM3cVtsTaoarVc80,2444
+riotskillissue/api/endpoints/val-ranked.py,sha256=kRV4VnmHYgvWGxx_G-z4wxi-lso8fQiomq5J14fL5mI,1195
+riotskillissue/api/endpoints/val-status.py,sha256=opLFHomkh0tvVEnuxVDCpha4DFJOBnhROqGnJA2ivzk,921
+riotskillissue/api/endpoints/val_console_match.py,sha256=Q5XtFeRKQXdsW8CFNCgGAvXOJk4Pb08ZveVlLrcUq_w,2953
+riotskillissue/api/endpoints/val_console_ranked.py,sha256=Adq5k8g02Q7Sjy53SHJJErTCLQrcCW5taR31hAbnhfk,1411
+riotskillissue/api/endpoints/val_content.py,sha256=B2F92j7rLrbp2n3s4J0s3eEzdQQbE1jXILCsD8PncSU,1076
+riotskillissue/api/endpoints/val_match.py,sha256=6uW3T9xvIW8pFFn7iVcMc5O-8pp9_aEkNvTak2dKVXw,2764
+riotskillissue/api/endpoints/val_ranked.py,sha256=bezU6oXHx_b-Ei93LoIeWcB71i9EecOBsMMyi3ViPZM,1288
+riotskillissue/api/endpoints/val_status.py,sha256=-EfUCCPjOqLSY1XATTfPM4IflcvaTTzxxzKMixquCQ8,1015
+riotskillissue/core/cache.py,sha256=5fVqaJAGUdwKXNJXiZTiIPWu3RroOvMDSLZiiRFF1DY,1672
+riotskillissue/core/client.py,sha256=FUJohr0gKzpkOqjUXS55rNOKIEo4hV0pH6uamW8h77s,1563
+riotskillissue/core/config.py,sha256=uHJkowiNkgYBD4kV0rg8oTSZX-DzdH-n7FG1UHQFDWM,542
+riotskillissue/core/http.py,sha256=UbXHVUFAFhWGf2_zxcqI7BvsdkYdC6cwQcDOVUYe-Cc,5842
+riotskillissue/core/pagination.py,sha256=OEiKwBCUt3YhmEQVNujze7k7E9D2cH582NUfOkoQMIk,2058
+riotskillissue/core/ratelimit.py,sha256=moCm8ztJWt0tLF6gyJraC68cM8g-Y8KGWvOeEAopkqg,7510
+riotskillissue/core/types.py,sha256=PUdqAcvraAGQNJHG2jyy0txHM-2_QHXc1Hbp0IMTWc8,1254
+riotskillissue/core/utils.py,sha256=THNMRbHegLDtHJd0QJ9n4c9T8Jm2l0cQBf0uRAjiC7k,742
+riotskillissue-0.1.0.dist-info/METADATA,sha256=PnZrK1tWzSR0rUvsHIStgC12dMOs1pVHL84rCD0lU4Q,1081
+riotskillissue-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+riotskillissue-0.1.0.dist-info/entry_points.txt,sha256=UGwPyhTjcdeyXCvSOAXUzCCRGT2QFV0tbIdjjoFY5rw,63
+riotskillissue-0.1.0.dist-info/licenses/LICENSE,sha256=pHOOfZKWeoeh33UTYa00xZsOLpdmLkNkz1zaGrF2JYw,1063
+riotskillissue-0.1.0.dist-info/RECORD,,

riotskillissue-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

riotskillissue-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+riotskillissue-cli = riotskillissue.cli:main

riotskillissue-0.1.0.dist-info/licenses/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.