OPGG.py v3.0.0 - "Back in Business" 😎

Breaking Changes ⚠️

Removed methods (due to OPGG API deprecation):

• update()
• get_live_game() - Use Riot's Spectator-V5 API instead

The entire v1/v2 nested structure has been removed.
The library imports will now be clean from opgg.opgg import OPGG vs the old from opgg.v2.opgg import OPGG

What's New ✨

New Champion Statistics Method

• get_champion_stats(tier, version, region, queue_type=Queue.SOLO, season_id=None)
  • Fetch ranked stats filtered by tier (iron → challenger, plus the "_plus" tiers, like "diamond_plus")
  • Regional filters (global, NA, KR, EUW, EUNE, and 13+ more)
  • Version filters (e.g., 15.22) and historic splits via season_id
  • Queue selection with the existing Queue enum (Solo/Flex/Arena)
  • Returns pick/ban/win rates and other insights

New Versions Method

• get_versions(lang_code)
  • Retrieve available League of Legends versions
  • Localize responses with LangCode

Season metadata – New SeasonMeta model with caching; Summoner.previous_seasons now enriched with display names/split info

Improvements 👌

• Clearer naming: BYPASS_API_URL → SUMMONER_API_URL.
• Added CHAMPION_API_URL for the new champion service.
• Search now defaults to the latest internal v3 route.
• Added rich docstrings covering every restored/new method, parameter descriptions, return types, and sample usage.
• Added a dedicated SeasonMeta model with caching to expose /meta/seasons data consistently. get_all_seasons() now returns typed metadata objects, and Summoner.previous_seasons entries are enriched with their corresponding metadata for easier display (year, split, preseason flag).
• Added CLAUDE.md for AI assisted development

Bug Fixes 🔧

Updated all endpoints for OPGG's API migration:

• Search: /v2/complete/summoners → /v3/summoners?riot_id={riot_id}
• Games & Summary endpoints confirmed working

Thanks to everyone who reported issues and helped track down the new endpoints! 🙏

Installation/Upgrade

pip install opgg.py==3.0.0

pip install --upgrade opgg.py

Full Changelog: 2.0.4...3.0.0