vlrdevapi 2.0.1__tar.gz → 2.1.0__tar.gz

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [Unreleased]
+
+### Changed
+
+- **Events list dates without a year** — `event.list()` dates are rendered
+  on vlr.gg without a year (e.g. `"Jul 9 – Aug 23"`). These now use a
+  sentinel year of `2019` instead of the current year. Any parsed date with
+  `year < 2020` means the source omitted the year, so guard with
+  `event.start_date.year < 2020` before relying on it.
+
+### Fixed
+
+- **Python 3.13/3.15 date parsing deprecation** — `datetime.strptime` emits
+  a `DeprecationWarning` when parsing a day-of-month without a year (and will
+  change behavior in Python 3.15). All such parses now supply an explicit
+  year derived from context (reference date, page-header year, or the
+  sentinel above).
+
+## [2.1.0] - 2026-08-07
+
+### Added
+
+- **Event teams player rosters** — `event.teams()` now includes a `players`
+  list on each `Team`, containing each player's `name` and `id` parsed from
+  the event page. The `players` field is always present and defaults to `[]`
+  when roster data is unavailable. A new `TeamPlayer` model was added and exposed
+  from the `_event.teams` submodule.
+
+### Changed
+
+- **Documentation** — event teams reference updated with the new `players`
+  field, a `TeamPlayer` fields table, and a roster iteration example.
+
 ## [2.0.1] - 2026-07-29
 
 ### Fixed
@@ -92,5 +125,6 @@ The API surface, module structure, and type system are all new.
 - `aiohttp` and `asyncio` dependencies.
 - v1.x match/event/team parsing modules.
 
+[2.1.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.0.1...v2.1.0
 [2.0.1]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.0.0...v2.0.1
 [2.0.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v1.6.2...v2.0.0

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vlrdevapi
-Version: 2.0.1
+Version: 2.1.0
 Summary: A Python library to scrape data from vlr.gg
 Project-URL: Homepage, https://vlrdevapi.pages.dev/
 Project-URL: Repository, https://github.com/Vanshbordia/vlrdevapi

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vlrdevapi"
-version = "2.0.1"
+version = "2.1.0"
 description = "A Python library to scrape data from vlr.gg"
 readme = "README.md"
 requires-python = ">=3.11"

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/__init__.py

@@ -45,7 +45,7 @@ if TYPE_CHECKING:
     matches: MatchesNamespace
     client: type[VLRClient]
 
-__version__ = "2.0.1"
+__version__ = "2.1.0"
 
 _default_client: "VLRClient | None" = None
 

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/info/parser.py

@@ -288,10 +288,9 @@ def _parse_partial_date(text: str, reference_end: date) -> date | None:
     if full_attempt is not None:
         return full_attempt
 
-    for fmt in ("%b %d", "%B %d"):
+    for fmt in ("%b %d %Y", "%B %d %Y"):
         try:
-            dt = datetime.strptime(text, fmt)
-            return dt.replace(year=reference_end.year).date()
+            return datetime.strptime(f"{text} {reference_end.year}", fmt).date()
         except ValueError:
             continue
 

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/list/models.py

@@ -22,8 +22,16 @@ class EventListItem(BaseModel):
         default="upcoming", description="Event status",
     )
     prize: EventPrize | None = Field(default=None, description="Prize information")
-    start_date: date | None = Field(default=None, description="Event start date")
-    end_date: date | None = Field(default=None, description="Event end date")
+    start_date: date | None = Field(
+        default=None,
+        description="Event start date. Year is 2019 when the listing omitted it "
+        "(year < 2020 means the year is not present).",
+    )
+    end_date: date | None = Field(
+        default=None,
+        description="Event end date. Year is 2019 when the listing omitted it "
+        "(year < 2020 means the year is not present).",
+    )
     region: str = Field(default="", description="Country or region name from flag")
     image_url: str = Field(default="", description="URL to the event thumbnail image")
     url: str = Field(default="", description="Full URL to the event page on vlr.gg")

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/namespace.py

@@ -99,8 +99,10 @@ class EventMatchNamespace:
                 If ``None``, returns teams for all stages.
 
         Returns:
-            EventTeams: Teams grouped by stage, with team ``name``, ``tag``,
-            ``logo_url``, and roster info where available.
+            EventTeams: Teams grouped by stage, with team ``name``, ``id``,
+            optional ``note``, and a ``players`` list (each with ``name``
+            and ``id``). ``players`` is always present and may be an empty
+            list when roster data is unavailable.
 
         Raises:
             NotFoundError: If the event page does not exist (HTTP 404).
@@ -241,6 +243,8 @@ class EventNamespace:
         Returns:
             An ``EventTeamsNamespace`` instance. Call with an ``event_id``
             and optional ``stage`` to return an ``EventTeams`` model.
+            Each ``Team`` includes a ``players`` roster list that is always
+            present and may be empty when roster data is unavailable.
 
         """
         return self._teams

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/stages/parser.py

@@ -189,10 +189,9 @@ def _parse_subnav_single_date(text: str, year: int | None) -> date | None:
         return None
 
     if year is not None:
-        for fmt in ("%b %d", "%B %d"):
+        for fmt in ("%b %d %Y", "%B %d %Y"):
             try:
-                dt = datetime.strptime(text, fmt)
-                return dt.replace(year=year).date()
+                return datetime.strptime(f"{text} {year}", fmt).date()
             except ValueError:
                 continue
 
@@ -220,10 +219,9 @@ def _parse_subnav_partial_date(text: str, year: int) -> date | None:
     if full is not None:
         return full
 
-    for fmt in ("%b %d", "%B %d"):
+    for fmt in ("%b %d %Y", "%B %d %Y"):
         try:
-            dt = datetime.strptime(text, fmt)
-            return dt.replace(year=year).date()
+            return datetime.strptime(f"{text} {year}", fmt).date()
         except ValueError:
             continue
 

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/teams/__init__.py

@@ -1,8 +1,9 @@
-from vlrdevapi._event.teams.models import EventStageTeams, EventTeams
+from vlrdevapi._event.teams.models import EventStageTeams, EventTeams, TeamPlayer
 from vlrdevapi._event.teams.namespace import EventTeamsNamespace
 
 __all__ = [
     "EventStageTeams",
     "EventTeams",
+    "TeamPlayer",
     "EventTeamsNamespace",
 ]

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/teams/models.py

@@ -1,6 +1,23 @@
 from pydantic import BaseModel, ConfigDict, Field
 
 
+class TeamPlayer(BaseModel):
+    """Player information for a team at an event."""
+
+    model_config = ConfigDict(
+        json_schema_extra={"description": "Player information for a team at an event."},
+    )
+
+    id: int = Field(
+        default=0,
+        description="Player identifier from vlr.gg (e.g., 1311)",
+    )
+    name: str = Field(
+        default="",
+        description="Player in-game name (e.g., 'Melser')",
+    )
+
+
 class Team(BaseModel):
     """Team information for an event from vlr.gg."""
 
@@ -20,6 +37,10 @@ class Team(BaseModel):
         default=None,
         description="Optional note (e.g., 'Partner Team')",
     )
+    players: list[TeamPlayer] = Field(
+        default_factory=list,
+        description="List of players on the team (name and id). Always present; empty when roster data is unavailable.",
+    )
 
 
 class EventStageTeams(BaseModel):
@@ -60,4 +81,4 @@ class EventTeams(BaseModel):
         return iter(self.stages)
 
     def __getitem__(self, index):
-        return self.stages[index]
+        return self.stages[index]

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/teams/namespace.py

@@ -43,8 +43,10 @@ class EventTeamsNamespace:
             stage: Optional stage name or path to filter by (e.g. 'playoffs').
 
         Returns:
-            EventTeams: Teams grouped by stage, with team ``name``, ``tag``,
-            ``logo_url``, and roster info where available.
+            EventTeams: Teams grouped by stage, with team ``name``, ``id``,
+            optional ``note``, and a ``players`` list (each with ``name``
+            and ``id``). ``players`` is always present and may be an empty
+            list when roster data is unavailable.
 
         Raises:
             ValidationError: If ``event_id`` is not a valid positive integer.

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/_event/teams/parser.py

@@ -1,7 +1,6 @@
-
 from selectolax.parser import HTMLParser, Node
 
-from vlrdevapi._event.teams.models import Team
+from vlrdevapi._event.teams.models import Team, TeamPlayer
 
 
 def parse_subnav(html: HTMLParser) -> list[tuple[str, str]]:
@@ -70,4 +69,32 @@ def _parse_team_card(card: Node) -> Team | None:
     note_el = card.css_first(".event-team-note")
     note = note_el.text(strip=True) if note_el else None
 
-    return Team(name=name, id=team_id, note=note)
+    players = _parse_players(card)
+
+    return Team(name=name, id=team_id, note=note, players=players)
+
+
+def _parse_players(card: Node) -> list[TeamPlayer]:
+    """Parse the players listed on a team card."""
+    players = []
+    for item in card.css(".event-team-players-item"):
+        player = _parse_player_item(item)
+        if player:
+            players.append(player)
+    return players
+
+
+def _parse_player_item(item: Node) -> TeamPlayer | None:
+    """Parse a single player anchor (e.g. /player/1311/melser)."""
+    href = item.attributes.get("href", "")
+    if not href or "/player/" not in href:
+        return None
+
+    try:
+        id_str = href.split("/player/")[1].split("/")[0]
+        player_id = int(id_str)
+    except (ValueError, IndexError):
+        return None
+
+    name = item.text(strip=True)
+    return TeamPlayer(id=player_id, name=name)

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/commons/datetime.py

@@ -5,6 +5,12 @@ from zoneinfo import ZoneInfo
 
 UTC = UTC
 
+# Sentinel year used when a vlr.gg page omits the year from a date
+# (e.g. ``"Sep 14"``). Any parsed date with ``year < 2020`` means the
+# source did not specify a year; Valorant launched in 2020, so no real
+# data can carry the sentinel year 2019.
+_UNKNOWN_YEAR = 2019
+
 # Fallback when no ``source_tz`` is provided. Prefer passing an explicit
 # timezone from :class:`~vlrdevapi._client.VLRClient` (``source_tz`` or
 # ``auto_detect_tz=True``).
@@ -108,7 +114,9 @@ def parse_vlr_date_range(text: str) -> tuple[date | None, date | None]:
 
     Supports en-dash, em-dash, and hyphen as separators. If the right side is
     ``"TBD"``, the end date is ``None``. If no separator is found, the same
-    date is returned for both start and end.
+    date is returned for both start and end. When a side has no year, the
+    sentinel year :data:`_UNKNOWN_YEAR` (2019) is used; a parsed date with
+    ``year < 2020`` means the source omitted the year.
 
     Args:
         text: The date range string to parse.
@@ -154,7 +162,10 @@ def _parse_list_date(text: str) -> date | None:
     """Parse a date string from list/match pages.
 
     Tries formats with year (``%b %d, %Y``, etc.) first, then formats
-    without year (assuming the current year).
+    without year. When the year is absent, the sentinel year
+    :data:`_UNKNOWN_YEAR` (2019) is used to signal that the source did not
+    specify a year (any parsed date with ``year < 2020`` means the year is
+    unknown).
 
     Args:
         text: The date string to parse.
@@ -176,12 +187,11 @@ def _parse_list_date(text: str) -> date | None:
         except ValueError:
             continue
 
-    # Try formats without year, assume current year
-    current_year = datetime.now().year
-    for fmt in ("%b %d", "%B %d"):
+    # Try formats without year; the source omits the year, so use the
+    # sentinel year to signal that it is unknown.
+    for fmt in ("%b %d %Y", "%B %d %Y"):
         try:
-            dt = datetime.strptime(text, fmt)
-            return dt.replace(year=current_year).date()
+            return datetime.strptime(f"{text} {_UNKNOWN_YEAR}", fmt).date()
         except ValueError:
             continue
 
@@ -207,12 +217,11 @@ def _parse_list_partial_date(text: str, reference: date) -> date | None:
     if not text:
         return None
     full = _parse_list_date(text)
-    if full is not None:
+    if full is not None and full.year != _UNKNOWN_YEAR:
         return full
-    for fmt in ("%b %d", "%B %d"):
+    for fmt in ("%b %d %Y", "%B %d %Y"):
         try:
-            dt = datetime.strptime(text, fmt)
-            return dt.replace(year=reference.year).date()
+            return datetime.strptime(f"{text} {reference.year}", fmt).date()
         except ValueError:
             continue
     return None

{vlrdevapi-2.0.1 → vlrdevapi-2.1.0}/src/vlrdevapi/commons/timezone.py

@@ -242,7 +242,7 @@ def _detect_from_offset(
     except ValueError:
         return None
 
-    date_formats = ("%A, %B %d", "%A, %B %d, %Y", "%B %d, %Y", "%b %d, %Y")
+    date_formats = ("%A, %B %d, %Y", "%B %d, %Y", "%b %d, %Y")
     local_date = None
     for fmt in date_formats:
         try:
@@ -251,7 +251,14 @@ def _detect_from_offset(
         except ValueError:
             continue
     if local_date is None:
-        local_date = canonical.date()
+        try:
+            # Weekday-only format with no year; the reference timestamp
+            # provides the canonical year.
+            local_date = datetime.strptime(
+                f"{displayed_date.strip()} {canonical.year}", "%A, %B %d %Y"
+            ).date()
+        except ValueError:
+            local_date = canonical.date()
     else:
         local_date = local_date.replace(year=canonical.year)