rivalsdata-api 1.2.1__tar.gz → 1.2.2__tar.gz

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: rivalsdata-api
-Version: 1.2.1
+Version: 1.2.2
 Summary: Python client and MCP server for public Marvel Rivals stats from RivalsData
 Project-URL: Homepage, https://github.com/GS-Rionnag/rivalsdata-api
 Project-URL: Repository, https://github.com/GS-Rionnag/rivalsdata-api
@@ -64,6 +64,7 @@ print(hero_id("Loki"))  # 1016
 with RivalsDataClient() as rd:
     player = rd.get_player("GS-")  # numeric UID works too
     print(player.name, player.level, player.rank_game_season)
+    print(player.win_rate)  # Current-season competitive win rate
 
     # Player profile sections are lazy resource managers.
     hero_season = player.heroes.fetch(season=20)
@@ -85,6 +86,11 @@ with RivalsDataClient() as rd:
 print(hero_season[0].win_rate)  # integer percent when wins/losses are present
 ```
 
+The player overview's overall win rate (`player.win_rate`) is the **current-season
+competitive win rate**. It uses the latest available competitive season with
+usable counts when a direct source rate is absent; it does not combine seasons.
+Hero and class stats use the season selector supplied to their own methods.
+
 Calculated player class statistics are available through
 `player.stats.classes(season=20)` and the MCP `get_player_stats` tool with
 `category="classes"`. Pass a numeric season ID for that season, or

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/README.md

@@ -28,6 +28,7 @@ print(hero_id("Loki"))  # 1016
 with RivalsDataClient() as rd:
     player = rd.get_player("GS-")  # numeric UID works too
     print(player.name, player.level, player.rank_game_season)
+    print(player.win_rate)  # Current-season competitive win rate
 
     # Player profile sections are lazy resource managers.
     hero_season = player.heroes.fetch(season=20)
@@ -49,6 +50,11 @@ with RivalsDataClient() as rd:
 print(hero_season[0].win_rate)  # integer percent when wins/losses are present
 ```
 
+The player overview's overall win rate (`player.win_rate`) is the **current-season
+competitive win rate**. It uses the latest available competitive season with
+usable counts when a direct source rate is absent; it does not combine seasons.
+Hero and class stats use the season selector supplied to their own methods.
+
 Calculated player class statistics are available through
 `player.stats.classes(season=20)` and the MCP `get_player_stats` tool with
 `category="classes"`. Pass a numeric season ID for that season, or

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/docs/API.md

@@ -48,6 +48,12 @@ integer percentage from a direct win-rate field, `wins`/`losses`, or the
 competitive profile row's `win_count`/`battle_count`. If the source provides
 none of these, it returns `None`.
 
+The player overview's overall win rate (`Player.win_rate`) refers to the current
+competitive season, using the latest available competitive season with usable
+counts when a direct source rate is absent. It does not sum historical seasons.
+MCP overview/dashboard descriptions identify this scope, and the dashboard labels
+the value as a season win rate. Hero and class rates follow their season selectors.
+
 ## Observed UI and routes
 
 `player.stats.classes(season=...)` derives tank (Vanguard), support (Strategist),

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/docs/PROJECT_CONTEXT.md

@@ -15,7 +15,7 @@ as public, stable methods. Keep requests respectful and conservative.
 ## Current package
 
 - Distribution: `rivalsdata-api`; import: `rivalsdata`.
-- Version: `1.2.1`.
+- Version: `1.2.2`.
 - Python `>=3.10`, Hatchling build, `src/` layout.
 - Runtime HTTP dependency: `curl-cffi`; optional browser fallback: Camoufox.
 - Public entry point: `RivalsDataClient`.
@@ -54,6 +54,12 @@ Favorites requires numeric UIDs and returns player summary rows.
 Rows offer `.win_rate` and `.winrate` integer-percent access when data supports
 it; all original data remains in mapping access.
 
+The player overview's overall win rate (`player.win_rate`) is for the current
+competitive season (latest available season with usable counts when there is no
+direct source rate), not an all-seasons aggregate. Keep this scope explicit in
+docs, MCP descriptions, and dashboard labels. Hero/class stats have separate
+season selectors.
+
 `player.stats.classes(season=...)` groups observed hero IDs into tank, support,
 and DPS. Supply a numeric season ID for one season or `season="all"` for
 combined all-seasons stats; the latter sends `season=-1` to the upstream API.

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rivalsdata-api"
-version = "1.2.1"
+version = "1.2.2"
 description = "Python client and MCP server for public Marvel Rivals stats from RivalsData"
 keywords = ["marvel-rivals", "rivalsdata", "game-stats", "api-client", "mcp"]
 readme = "README.md"

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/src/rivalsdata/__init__.py

@@ -153,4 +153,4 @@ __all__ = [
     "hero_id",
     "hero_name",
 ]
-__version__ = "1.2.1"
+__version__ = "1.2.2"

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/src/rivalsdata/mcp_server.py

@@ -108,7 +108,11 @@ def search_players(name: str) -> dict[str, Any]:
 
 @mcp.tool()
 def get_player(uid_or_name: str) -> dict[str, Any]:
-    """Get a public player overview by numeric UID or in-game name."""
+    """Get a public player overview by numeric UID or in-game name.
+
+    The overview's overall win rate refers to the current competitive season
+    (latest available season with usable counts), not all seasons combined.
+    """
     return _call(lambda client, value: client.get_player(value).raw, uid_or_name)
 
 
@@ -141,6 +145,7 @@ def show_player_dashboard(
     combining live-match, hero, and match-history pulls. MCP Apps hosts can
     render the returned dashboard resource; all values are escaped before HTML
     output.
+    The competitive record and win rate are for the latest available season.
     """
     with RivalsDataClient() as client:
         player = client.get_player(uid_or_name)
@@ -168,7 +173,7 @@ def show_player_dashboard(
             competitive_summary = (
                 f'<div class="competitive-line">'
                 f'<span>{battles:,} competitive games</span>'
-                + (f'<span>{rate}% win rate</span>' if rate is not None else "")
+                + (f'<span>{rate}% season win rate</span>' if rate is not None else "")
                 + (f'<span>{escape(str(score))} RP</span>' if score is not None else "")
                 + '</div>'
             )

{rivalsdata_api-1.2.1 → rivalsdata_api-1.2.2}/src/rivalsdata/models.py

@@ -983,7 +983,11 @@ class Player(DataModel):
 
     @property
     def win_rate(self) -> int | None:
-        """Overall competitive win rate when the profile includes wins/losses."""
+        """Current-season competitive win rate when profile counts are available.
+
+        Uses a direct source rate or the latest available competitive season
+        with usable counts. This property does not aggregate across seasons.
+        """
         direct = StatRecord(self._data).win_rate
         if direct is not None:
             return direct