overfast-client 0.1.0__py3-none-any.whl

overfast_client-0.1.0.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: overfast-client
+Version: 0.1.0
+Summary: Async Python client for the OverFast API (Overwatch data).
+Project-URL: Homepage, https://github.com/Leo890728/overwatch_py
+Project-URL: Repository, https://github.com/Leo890728/overwatch_py
+Project-URL: Issues, https://github.com/Leo890728/overwatch_py/issues
+Project-URL: Changelog, https://github.com/Leo890728/overwatch_py/blob/main/CHANGELOG.md
+Author-email: Leo890728 <Leo890728@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: api,async,httpx,overfast,overwatch,pydantic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: hishel<0.2,>=0.0.30
+Requires-Dist: httpx-retries>=0.3
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.5
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# overfast-client
+
+Async Python client for the [OverFast API](https://overfast-api.tekrop.fr) — comprehensive Overwatch data (heroes, maps, gamemodes, player stats) via a typed, pydantic-backed interface.
+
+## Install
+
+```bash
+pip install overfast-client
+```
+
+> The PyPI distribution is `overfast-client`; the import name is `overwatch_py`.
+
+Or from source (editable):
+
+```bash
+pip install -e .
+```
+
+## Quick start
+
+```python
+import asyncio
+from overwatch_py import Client
+from overwatch_py.enums import Hero, Locale, Role, HeroGamemode, PlayerGamemode, Platform
+
+async def main():
+    client = Client()
+
+    # List heroes
+    heroes = await client.get_heroes(role=Role.SUPPORT, locale=Locale.EN_US)
+    for h in heroes:
+        print(h.key, h.name)
+
+    # Full hero data (abilities, story, hitpoints, ...)
+    ana = await client.get_hero_data(Hero.ANA)
+    print(ana.hitpoints, len(ana.abilities))
+
+    # Maps & gamemodes
+    maps = await client.get_maps()
+    gamemodes = await client.get_gamemode_details()
+
+    # Hero usage stats (pickrate / winrate)
+    stats = await client.get_heroes_stats(
+        platform=Platform.PC,
+        gamemode=PlayerGamemode.COMPETITIVE,
+    )
+
+    # Players
+    result = await client.search_players("TeKrop", limit=10)
+    player = await client.get_player(result.results[0].player_id)
+    summary = await client.get_player_summary("TeKrop-2217")
+    stats_summary = await client.get_player_stats("TeKrop-2217", gamemode=PlayerGamemode.COMPETITIVE)
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+from overwatch_py import Client
+from overwatch_py.config import Config
+from overwatch_py.session import HTTPSession
+
+config = Config(
+    timeout=10,          # seconds
+    retries=3,           # retries on 5xx
+    cache=True,          # HTTP-level cache (hishel), respects server Cache-Control
+    cache_backend="sqlite",  # "memory" | "sqlite" | "file"
+)
+client = Client(HTTPSession(config))
+```
+
+### Caching
+
+Caching is disabled by default. When enabled, [hishel](https://hishel.com) sits in the httpx transport stack and honors each endpoint's `Cache-Control` / `Age` headers (e.g. `/heroes` is cached ~1 day, `/heroes/stats` ~1 hour by the upstream API).
+
+## Exceptions
+
+All non-2xx responses map to subclasses of `APIError`:
+
+| Status | Exception |
+|--------|-----------|
+| 400    | `BadRequestError` |
+| 404    | `NotFoundError` |
+| 422    | `ValidationError` |
+| 429    | `APIRateLimitError` |
+| 500    | `InternalServerError` |
+| 503    | `BlizzardRateLimitError` |
+| 504    | `BlizzardServerError` |
+
+```python
+from overwatch_py.exceptions import NotFoundError, APIRateLimitError
+
+try:
+    await client.get_player_summary("does-not-exist-1234")
+except NotFoundError:
+    ...
+except APIRateLimitError as e:
+    print("rate limited:", e.response.headers.get("retry-after"))
+```
+
+## API surface
+
+Exposed on `Client`:
+
+- **Heroes** — `get_heroes`, `get_hero_data`, `get_heroes_stats`
+- **Maps / Gamemodes** — `get_maps`, `get_gamemode_details`
+- **Players** — `search_players`, `get_player`, `get_player_summary`, `get_player_stats`, `get_player_career_stats`, `get_player_career_stats_with_labels`, `get_player_full_stats`
+
+The underlying services (`client.heros`, `client.maps`, `client.players`) are also available if you prefer service-level access.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                     # unit + mocked HTTP tests
+pytest -m live             # hits the real API (rate-limited)
+pytest -m 'live or not live'  # run everything
+```
+
+## License
+
+MIT.

overfast_client-0.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+overwatch_py/__init__.py,sha256=h8jkjJd_ZWwpwwRJ5zMXBF-8oV3xKQdpYYIp-G5UOws,85
+overwatch_py/client.py,sha256=Svn_fsXl6Gk22KCFBuxi0-s79EgMrXxcCnzsUj0yEIs,4902
+overwatch_py/config.py,sha256=v21ZAqzGpuBkiwpSkh8yPJLQUz_Q-UJBZoI2i4PR2ts,284
+overwatch_py/exceptions.py,sha256=SDiXFwMGTX34fOR4uaRjOWySUVQMYDlpxObAU8XQlhQ,714
+overwatch_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overwatch_py/session.py,sha256=acnkIDmvBV668hB48kGvcI26j5ED80FO9WiZmEgK-KM,2148
+overwatch_py/enums/__init__.py,sha256=qUKvvqaxRInTkIzAepfVMNl4WsmgzB8vHH16ikqixgk,652
+overwatch_py/enums/background_image_size.py,sha256=rHJL6s4YAbUAUU4gred2nWFbfJQHaeemG1Ync-KWN7k,154
+overwatch_py/enums/career_stat_category.py,sha256=s1h4olzLj4r0ZfjhoFskH2_5lKPfiLbMHFSwNOMALUc,272
+overwatch_py/enums/gamemode.py,sha256=YbNU4nI9azUkN2pfd12pgo5n8zGhTWhwHdffLkYTt9I,348
+overwatch_py/enums/hero.py,sha256=-8ZVCuBUpXazr4N_SCF-AhyJwbB_cLagO5VhYekVQGc,1225
+overwatch_py/enums/locale.py,sha256=7cESDJy_LYkvdfr-zVB-S8f4FTKvvIkdVF-0NTVv4VM,308
+overwatch_py/enums/map.py,sha256=3Hkm4zBs1flqWUpwwOaXe-BQBYpyB3gQnjBayK9W18c,1825
+overwatch_py/enums/map_gamemode.py,sha256=ny9h0NtrtBvmpXutZfioQOxwv3MLBjhXoD6XIyAy3Rg,455
+overwatch_py/enums/platform.py,sha256=U__Ga6Ma_JlvfQ3tlR14R2t5OTJQ03ILFJhb2WtRu20,88
+overwatch_py/enums/rank.py,sha256=vZoyW9XcyPg1lSmOLTdfB6vGdXsTYKfUdmYLKoXO4Kk,556
+overwatch_py/enums/region.py,sha256=eiVnirCz3DiaQmAlHNXEjlFoKi8pC2OxQuSLWQnSRSk,115
+overwatch_py/enums/role.py,sha256=6KrifIbH6BW9D_BsyFTxT6s46B025YEfyGZr7Pj4EM8,110
+overwatch_py/models/__init__.py,sha256=x3Hg2J-UnEYTL7RS559E_HLLTgUfLSa9E72SiMptC5Q,1382
+overwatch_py/models/gamemode_details.py,sha256=Pd-mujYqsKsOpRhCsZUu5jTyr_reUHMwXt69SiucqQ0,206
+overwatch_py/models/hero.py,sha256=l7EqTbpdHQJCtoXEGFieVUobRCkBdtceoyQYbSkEcsY,1269
+overwatch_py/models/hero_short.py,sha256=e7Yi6lrRHbzkEGVmNCNDhX9Y9nuandznjF61yHFGER8,215
+overwatch_py/models/hero_stats.py,sha256=tbQVxSwPnUIbxi-7nnwN0bIrvjFviBJuTwUAY4TvY0k,140
+overwatch_py/models/map_details.py,sha256=I5wTkKFO3xAq6-6yizqKg7wRnLPpcqQaXRtpvad9MX8,270
+overwatch_py/models/player.py,sha256=7uZ9eG_GmHqTqonFc7hKNVof5rJN_DnNfD7aIcxvZw8,1608
+overwatch_py/models/player_stats.py,sha256=lPPe47O_oDPaMUnnXXUPT-hhX3eJopnB-feq5AdNSuU,3247
+overwatch_py/services/__init__.py,sha256=a2drwxI_bz_a9eRjLlQaEgLvnE5iDqHbbZgHlVxSPUE,159
+overwatch_py/services/heros.py,sha256=sAZNu1VOxkf_UFdrwGvfJDAHzp-o4VPxWmWKNvm9588,4660
+overwatch_py/services/maps.py,sha256=B6n-Ao2yP99UE42ngxfAnSbwdfAzd8ieX2Al4ZDCNqI,892
+overwatch_py/services/players.py,sha256=5J8jG0NPB6x_zPNvV75XxgknNyZsgQRKfvQyRRRC-Ag,4759
+overfast_client-0.1.0.dist-info/METADATA,sha256=KQaMBQZgU_BeGN1nlBU8owUbwN7Brk5FM979DgMa77M,5106
+overfast_client-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+overfast_client-0.1.0.dist-info/licenses/LICENSE,sha256=1OjTzFo2zh8donxQs_QiBTv6e4fp9NqYLvRKooqWyWk,1065
+overfast_client-0.1.0.dist-info/RECORD,,

overfast_client-0.1.0.dist-info/WHEEL

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

overfast_client-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leo890728
+
+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.

overwatch_py/__init__.py

@@ -0,0 +1,4 @@
+from .client import Client
+
+__version__ = "0.1.0"
+__all__ = ["Client", "__version__"]

overwatch_py/client.py

@@ -0,0 +1,96 @@
+from typing import Optional
+
+from .services import HerosService, MapsService, PlayersService
+from .services.players import HeroFilter
+from .session import HTTPSession
+from .models import (
+    GamemodeDetails,
+    HeroData,
+    HeroPlayerCareerStats,
+    HeroShort,
+    HeroStats,
+    MapDetails,
+    Player,
+    PlayerSearchResult,
+    PlayerStats,
+    PlayerStatsSummary,
+    PlayerSummary,
+)
+from .enums import (
+    CompetitiveDivisionFilter,
+    Hero,
+    HeroGamemode,
+    Locale,
+    Map,
+    MapGamemode,
+    Platform,
+    PlayerGamemode,
+    Region,
+    Role,
+)
+
+
+class Client:
+    def __init__(self, session: HTTPSession = None):
+        self.session = session or HTTPSession()
+        self.heros = HerosService(self.session)
+        self.maps = MapsService(self.session)
+        self.players = PlayersService(self.session)
+
+    async def get_heroes(self, role: Role = None, locale: Locale = Locale.EN_US, gamemode: Optional[HeroGamemode] = None) -> list[HeroShort]:
+        """Get a list of Overwatch heroes, which can be filtered using roles or gamemodes."""
+        return await self.heros.get_heroes(role, locale, gamemode)
+
+    async def get_hero_data(self, hero: Hero, locale: Locale = Locale.EN_US) -> HeroData:
+        """Get data about an Overwatch hero : description, abilities, stadium powers, story, etc."""
+        return await self.heros.get_hero_data(hero, locale)
+
+    async def get_maps(self, map_gamemode: Optional[MapGamemode] = None) -> list[MapDetails]:
+        """Get a list of Overwatch maps : Hanamura, King's Row, Dorado, etc."""
+        return await self.maps.get_maps(map_gamemode)
+
+    async def get_gamemode_details(self) -> list[GamemodeDetails]:
+        """Get a list of Overwatch gamemodes : Assault, Escort, Flashpoint, Hybrid, etc."""
+        return await self.maps.get_gamemode_details()
+
+    async def get_heroes_stats(self, platform: Platform = Platform.PC, gamemode: PlayerGamemode = PlayerGamemode.COMPETITIVE,
+                               region: Region = Region.ASIA, role: Optional[Role] = None, map: Optional[Map] = None,
+                               competitive_division: Optional[CompetitiveDivisionFilter] = None, order_by: Optional[str] = "hero:asc") -> list[HeroStats]:
+        """Get hero statistics usage, filtered by platform, region, role, etc. Only Role Queue gamemodes are concerned."""
+        return await self.heros.get_heroes_stats(platform, gamemode, region, role, map, competitive_division, order_by)
+
+    async def search_players(self, name: str, order_by: Optional[str] = None,
+                             offset: Optional[int] = None, limit: Optional[int] = None) -> PlayerSearchResult:
+        """Search for players by BattleTag name."""
+        return await self.players.search_players(name, order_by, offset, limit)
+
+    async def get_player(self, player_id: str, gamemode: Optional[PlayerGamemode] = None,
+                         platform: Optional[Platform] = None) -> Player:
+        """Get all player data: summary and statistics."""
+        return await self.players.get_player(player_id, gamemode, platform)
+
+    async def get_player_summary(self, player_id: str) -> PlayerSummary:
+        """Get player summary: name, avatar, endorsement, competitive ranks."""
+        return await self.players.get_player_summary(player_id)
+
+    async def get_player_stats(self, player_id: str, gamemode: Optional[PlayerGamemode] = None,
+                               platform: Optional[Platform] = None) -> PlayerStatsSummary:
+        """Get player stats summary (general / roles / heroes)."""
+        return await self.players.get_player_stats(player_id, gamemode, platform)
+
+    async def get_player_career_stats(self, player_id: str, gamemode: PlayerGamemode,
+                                      platform: Optional[Platform] = None,
+                                      hero: Optional[HeroFilter] = None) -> dict[str, Optional[HeroPlayerCareerStats]]:
+        """Get player career stats as flat {label: value} maps per hero."""
+        return await self.players.get_player_career_stats(player_id, gamemode, platform, hero)
+
+    async def get_player_career_stats_with_labels(self, player_id: str, gamemode: PlayerGamemode,
+                                                  platform: Optional[Platform] = None,
+                                                  hero: Optional[HeroFilter] = None):
+        """Get player career stats with labels and categories per hero."""
+        return await self.players.get_player_career_stats_with_labels(player_id, gamemode, platform, hero)
+
+    async def get_player_full_stats(self, player_id: str, gamemode: Optional[PlayerGamemode] = None,
+                                    platform: Optional[Platform] = None) -> PlayerStats:
+        """Get a player's full per-platform stats (pc/console)."""
+        return await self.players.get_player_full_stats(player_id, gamemode, platform)

overwatch_py/config.py

@@ -0,0 +1,11 @@
+from typing import Literal
+
+from pydantic import BaseModel, HttpUrl
+
+
+class Config(BaseModel):
+    base_url: HttpUrl = "https://overfast-api.tekrop.fr"
+    timeout: int = 10
+    retries: int = 3
+    cache: bool = False
+    cache_backend: Literal["memory", "sqlite", "file"] = "memory"

overwatch_py/enums/__init__.py

@@ -0,0 +1,28 @@
+from .background_image_size import BackgroundImageSize
+from .career_stat_category import CareerStatCategory
+from .map_gamemode import MapGamemode
+from .hero import Hero
+from .locale import Locale
+from .platform import Platform
+from .region import Region
+from .role import Role
+from .map import Map
+from .gamemode import HeroGamemode, PlayerGamemode
+from .rank import Rank, CompetitiveDivisionFilter
+
+
+__all__ = [
+    "BackgroundImageSize",
+    "CareerStatCategory",
+    "CompetitiveDivisionFilter",
+    "Hero",
+    "HeroGamemode",
+    "Locale",
+    "Map",
+    "MapGamemode",
+    "Platform",
+    "PlayerGamemode",
+    "Rank",
+    "Region",
+    "Role",
+]

overwatch_py/enums/background_image_size.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+
+class BackgroundImageSize(str, Enum):
+    MIN = "min"
+    XS = "xs"
+    SM = "sm"
+    MD = "md"
+    LG = "lg"
+    XL_PLUS = "xl+"

overwatch_py/enums/career_stat_category.py

@@ -0,0 +1,12 @@
+from enum import Enum
+
+
+class CareerStatCategory(str, Enum):
+    ASSISTS = "assists"
+    AVERAGE = "average"
+    BEST = "best"
+    COMBAT = "combat"
+    GAME = "game"
+    HERO_SPECIFIC = "hero_specific"
+    MATCH_AWARDS = "match_awards"
+    MISCELLANEOUS = "miscellaneous"

overwatch_py/enums/gamemode.py

@@ -0,0 +1,13 @@
+from enum import Enum
+
+
+class HeroGamemode(str, Enum):
+    """Gamemodes a hero can be played in (used by /heroes filter and HeroShort.gamemodes)."""
+    QUICKPLAY = "quickplay"
+    STADIUM = "stadium"
+
+
+class PlayerGamemode(str, Enum):
+    """Gamemodes used by player-stats endpoints."""
+    QUICKPLAY = "quickplay"
+    COMPETITIVE = "competitive"

overwatch_py/enums/hero.py

@@ -0,0 +1,55 @@
+from enum import Enum
+
+
+class Hero(str, Enum):
+    ANA = "ana"
+    ANRAN = "anran"
+    ASHE = "ashe"
+    BAPTISTE = "baptiste"
+    BASTION = "bastion"
+    BRIGITTE = "brigitte"
+    CASSIDY = "cassidy"
+    DVA = "dva"
+    DOMINA = "domina"
+    DOOMFIST = "doomfist"
+    ECHO = "echo"
+    EMRE = "emre"
+    FREJA = "freja"
+    GENJI = "genji"
+    HAZARD = "hazard"
+    HANZO = "hanzo"
+    ILLARI = "illari"
+    JETPACK_CAT = "jetpack-cat"
+    JUNKER_QUEEN = "junker-queen"
+    JUNKRAT = "junkrat"
+    JUNO = "juno"
+    KIRIKO = "kiriko"
+    LIFEWEAVER = "lifeweaver"
+    LUCIO = "lucio"
+    MAUGA = "mauga"
+    MEI = "mei"
+    MERCY = "mercy"
+    MIZUKI = "mizuki"
+    MOIRA = "moira"
+    ORISA = "orisa"
+    PHARAH = "pharah"
+    RAMATTRA = "ramattra"
+    REAPER = "reaper"
+    REINHARDT = "reinhardt"
+    ROADHOG = "roadhog"
+    SIGMA = "sigma"
+    SIERRA = "sierra"
+    SOJOURN = "sojourn"
+    SOLDIER_76 = "soldier-76"
+    SOMBRA = "sombra"
+    SYMMETRA = "symmetra"
+    TORBJORN = "torbjorn"
+    TRACER = "tracer"
+    VENDETTA = "vendetta"
+    VENTURE = "venture"
+    WIDOWMAKER = "widowmaker"
+    WINSTON = "winston"
+    WRECKING_BALL = "wrecking-ball"
+    WUYANG = "wuyang"
+    ZARYA = "zarya"
+    ZENYATTA = "zenyatta"

overwatch_py/enums/locale.py

@@ -0,0 +1,17 @@
+from enum import Enum
+
+
+class Locale(str, Enum):
+    DE_DE = "de-de"
+    EN_GB = "en-gb"
+    EN_US = "en-us"
+    ES_ES = "es-es"
+    ES_MX = "es-mx"
+    FR_FR = "fr-fr"
+    IT_IT = "it-it"
+    JA_JP = "ja-jp"
+    KO_KR = "ko-kr"
+    PL_PL = "pl-pl"
+    PT_BR = "pt-br"
+    RU_RU = "ru-ru"
+    ZH_TW = "zh-tw"

overwatch_py/enums/map.py

@@ -0,0 +1,61 @@
+from enum import Enum
+
+
+class Map(str, Enum):
+    AATLIS = "aatlis"
+    ANTARCTIC_PENINSULA = "antarctic-peninsula"
+    ANUBIS = "anubis"
+    ARENA_VICTORIAE = "arena-victoriae"
+    AYUTTHAYA = "ayutthaya"
+    BLACK_FOREST = "black-forest"
+    BLIZZARD_WORLD = "blizzard-world"
+    BUSAN = "busan"
+    CASTILLO = "castillo"
+    CHATEAU_GUILLARD = "chateau-guillard"
+    CIRCUIT_ROYAL = "circuit-royal"
+    COLOSSEO = "colosseo"
+    DORADO = "dorado"
+    ECOPOINT_ANTARCTICA = "ecopoint-antarctica"
+    EICHENWALDE = "eichenwalde"
+    ESPERANCA = "esperanca"
+    GOGADORO = "gogadoro"
+    HANAMURA = "hanamura"
+    HANAOKA = "hanaoka"
+    HAVANA = "havana"
+    HOLLYWOOD = "hollywood"
+    HORIZON = "horizon"
+    ILIOS = "ilios"
+    JUNKERTOWN = "junkertown"
+    LIJIANG_TOWER = "lijiang-tower"
+    KANEZAKA = "kanezaka"
+    KINGS_ROW = "kings-row"
+    MALEVENTO = "malevento"
+    MIDTOWN = "midtown"
+    NECROPOLIS = "necropolis"
+    NEPAL = "nepal"
+    NEW_JUNK_CITY = "new-junk-city"
+    NEW_QUEEN_STREET = "new-queen-street"
+    NUMBANI = "numbani"
+    OASIS = "oasis"
+    PARAISO = "paraiso"
+    PARIS = "paris"
+    PETRA = "petra"
+    PLACE_LACROIX = "place-lacroix"
+    POWDER_KEG_MINE = "powder-keg-mine"
+    PRACTICE_RANGE = "practice-range"
+    REDWOOD_DAM = "redwood-dam"
+    RIALTO = "rialto"
+    ROUTE_66 = "route-66"
+    RUNASAPI = "runasapi"
+    SAMOA = "samoa"
+    SHAMBALI_MONASTERY = "shambali-monastery"
+    SURAVASA = "suravasa"
+    THAMES_DISTRICT = "thames-district"
+    THRONE_OF_ANUBIS = "throne-of-anubis"
+    VOLSKAYA = "volskaya"
+    WATCHPOINT_GIBRALTAR = "watchpoint-gibraltar"
+    WORKSHOP_CHAMBER = "workshop-chamber"
+    WORKSHOP_EXPANSE = "workshop-expanse"
+    WORKSHOP_GREEN_SCREEN = "workshop-green-screen"
+    WORKSHOP_ISLAND = "workshop-island"
+    WUXING_UNIVERSITY = "wuxing-university"

overwatch_py/enums/map_gamemode.py

@@ -0,0 +1,18 @@
+from enum import Enum
+
+
+class MapGamemode(str, Enum):
+    ASSAULT = "assault"
+    CAPTURE_THE_FLAG = "capture-the-flag"
+    CLASH = "clash"
+    CONTROL = "control"
+    DEATHMATCH = "deathmatch"
+    ELIMINATION = "elimination"
+    ESCORT = "escort"
+    FLASHPOINT = "flashpoint"
+    HYBRID = "hybrid"
+    PAYLOAD_RACE = "payload-race"
+    PRACTICE_RANGE = "practice-range"
+    PUSH = "push"
+    TEAM_DEATHMATCH = "team-deathmatch"
+    WORKSHOP = "workshop"

overwatch_py/enums/platform.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class Platform(str, Enum):
+    PC = "pc"
+    CONSOLE = "console"

overwatch_py/enums/rank.py

@@ -0,0 +1,23 @@
+from enum import Enum
+
+
+class Rank(str, Enum):
+    BRONZE = "bronze"
+    SILVER = "silver"
+    GOLD = "gold"
+    PLATINUM = "platinum"
+    DIAMOND = "diamond"
+    MASTER = "master"
+    GRANDMASTER = "grandmaster"
+    ULTIMATE = "ultimate"
+
+
+class CompetitiveDivisionFilter(str, Enum):
+    """Same as Rank, but without ULTIMATE — accepted by /heroes/stats `competitive_division` query."""
+    BRONZE = "bronze"
+    SILVER = "silver"
+    GOLD = "gold"
+    PLATINUM = "platinum"
+    DIAMOND = "diamond"
+    MASTER = "master"
+    GRANDMASTER = "grandmaster"

overwatch_py/enums/region.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Region(str, Enum):
+    EUROPE = "europe"
+    AMERICAS = "americas"
+    ASIA = "asia"

overwatch_py/enums/role.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Role(str, Enum):
+    TANK = "tank"
+    DAMAGE = "damage"
+    SUPPORT = "support"

overwatch_py/exceptions.py

@@ -0,0 +1,33 @@
+class APIError(Exception):
+    def __init__(self, message: str, status_code: int, response=None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.response = response
+
+
+class BadRequestError(APIError):
+    """400 Bad Request Error"""
+
+
+class NotFoundError(APIError):
+    """404 Not Found (hero or player)"""
+
+
+class ValidationError(APIError):
+    """422 Validation Error"""
+
+
+class APIRateLimitError(APIError):
+    """429 API Rate Limit Error"""
+
+
+class InternalServerError(APIError):
+    """500 Internal Server Error"""
+
+
+class BlizzardRateLimitError(APIError):
+    """503 Blizzard Rate Limit Error"""
+
+
+class BlizzardServerError(APIError):
+    """504 Blizzard Server Error"""