vlrdevapi 2.2.0__tar.gz → 2.4.0__tar.gz

vlrdevapi-2.4.0/CHANGELOG.md

@@ -0,0 +1,287 @@
+# Changelog
+
+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/).
+
+## [2.4.0] - 2026-08-19
+
+### Added
+
+- **Bo1 series support** — single-map series now resolve games from
+  `.vm-stats-game` containers when nav tabs are absent. `resolve_game_id`
+  raises `ParsingError` instead of silently returning wrong data on
+  out-of-range or empty game lists.
+- **Event region resolution** — `_parse_breadcrumb` resolves `subregion=`
+  breadcrumb links (e.g. "Japan", "North America") to their parent region
+  via `commons.regions.resolve_subregion_to_region`. A new
+  `EventRegion.subregion` field preserves the original subregion name
+  (e.g. `"Japan"`); `None` for `region=` links.
+- **Event country-to-region fallback** — when no breadcrumb region is
+  present, the `region_location` country flag is resolved via
+  `resolve_country_to_region` to infer the parent region.
+- **Event region deduplication** — duplicate region entries (from both
+  `region=` and `subregion=` breadcrumbs for the same parent region)
+  are collapsed, preferring the entry that carries a subregion name.
+- **`commons.regions` module** — new shared utilities for region
+  resolution: `VALID_REGIONS`, `SUBREGION_TO_REGION` (17 VCL/GC
+  subregions), `COUNTRY_TO_REGION` (~100+ countries),
+  `resolve_subregion_to_region`, and `resolve_country_to_region`.
+- **`commons.__init__` re-exports** — `resolve_subregion_to_region`,
+  `resolve_country_to_region`, `VALID_REGIONS`, `SUBREGION_TO_REGION`,
+  and `COUNTRY_TO_REGION` are now re-exported from `vlrdevapi.commons`.
+- **Series forfeit detection** — new `ForfeitInfo` model on
+  `SeriesInfo.forfeit` exposes `forfeited`, `team`, `team_id`, and
+  `reason` fields. Parser detects `"forfeited by TEAM"` in the
+  `match-header-vs-note` element and maps the team name to the
+  corresponding `team1`/`team2` for ID resolution. Note-level
+  forfeit text (e.g. "Blind Esports Forfeit Map 2") is also parsed.
+- **Series match notes** — new `SeriesInfo.notes` list captures
+  non-veto `match-header-note` text such as technical pause warnings
+  and lobby remake notices.
+
+### Changed
+
+- **Series economy enrichment** — team matching now tries abbreviation
+  names from `.ovw-player-tag` elements first (e.g. "SEN"), then falls
+  back to full team names. This fixes mismatches where the economy tab
+  shows a different abbreviation than the overview header.
+- **Series rounds enrichment** — same abbreviation-first matching
+  strategy as economy.
+- **Series info veto parsing** — Bo1 veto fallback now handles the
+  "bans + decider" pattern (e.g. `"Ban1 remains"`) in addition to
+  pick/ban. The PICK badge is excluded from map names via
+  `span.text(deep=False)`.
+- **Series info notes parsing** — the parser now iterates all
+  `match-header-note` elements instead of only the first. This
+  correctly separates forfeit reasons, informational notes, and
+  map veto text when multiple notes are present.
+
+### Fixed
+
+- **Economy bank/spend parsing** — `int()` calls on `.rnd-sq` `title`
+  attributes and `.rnd-num` text are wrapped in `try/except ValueError`;
+  malformed values default to `0` instead of crashing the parser.
+- **Event region from location country** — events that only have a
+  "Location" label with a flag (no separate "Region" label) now resolve
+  the region from `location.country` via `resolve_country_to_region`.
+  Previously the country-to-region fallback only checked `region_location`.
+- **Phantom pagination in matches** — terminal pages no longer report
+  `has_next_page = True` (from DaviAlcanfor PR #50).
+
+### Documentation
+
+- **Event info reference** — `EventRegion` fields table now documents
+  the `subregion` field. Region example demonstrates subregion access.
+  `regions` field description explains deduplication and International
+  collapse.
+- **Series info reference** — `ForfeitInfo` fields table documents the
+  new `forfeit` nested model. `notes` field description explains the
+  distinction between forfeit reasons and informational notes.
+- **Series economy reference** — docstrings reference correct model
+  types (`RoundEconomyData`, `bank_team1`).
+- **Series rounds reference** — docstrings reference correct model
+  types (`RoundData`, `winner_team_name`).
+- **`commons.regions` module** — docstrings describe all mapping
+  dictionaries and resolution functions.
+- **Project structure** — contributing guide updated with actual
+  underscore-prefixed directory names and new modules (`_news/`,
+  `_utils/`, `commons/regions.py`).
+- **Module docstrings** — added to `economy/parser.py`,
+  `rounds/parser.py`, and `commons/__init__.py`.
+
+## [2.3.0] - 2026-08-11
+
+### Added
+
+- **News namespace** — `vlrdevapi.news(page=1)` lists news items from
+  vlr.gg/news, each with `title`, `subtitle`, `link`, `country_name`,
+  `date`, and `author`, plus `has_next_page` and `page_number` on the
+  returned page.
+- **News article content** — `vlrdevapi.news.article(article_id)` fetches
+  a single news article with its `title`, `author`, `date`, associated
+  `event_name`/`event_link`, and the full `content` body text. The body
+  is also available as Markdown via `content_md`, preserving headings,
+  lists, links, emphasis, and clip embeds.
+- **News out-of-range pages** — requesting a news page beyond the last
+  available page (e.g. `page=176`) now raises `NotFoundError` instead of
+  silently returning an empty result.
+
+### Changed
+
+- **News article Markdown links are absolute** — links in `content_md` are
+  prefixed with `https://www.vlr.gg` when they were relative (e.g.
+  `/player/5132/mada` → `https://www.vlr.gg/player/5132/mada`). Absolute
+  and `www.`-prefixed URLs are left untouched. `NewsArticle.event_link` is
+  now an absolute URL as well.
+
+### Fixed
+
+- **News article clip embeds** — `content_md` clip embeds now link to the
+  directly openable watch URL (e.g. `https://clips.twitch.tv/<slug>`) for
+  Twitch clips, Twitch VODs, YouTube, and Soop embeds, instead of the embed
+  URL which could not be opened in a new tab.
+- **News article Markdown whitespace/emphasis** — inline emphasis and bold
+  render correctly around links: source indentation whitespace no longer
+  produces double spaces, and `*`/`**` markers no longer wrap whitespace.
+- **News article dates are timezone-aware** — the article date is parsed
+  through the shared `commons.parse_vlr_iso_datetime` helper. Offset-aware
+  `datetime` attributes are converted to UTC as-is; naive values are
+  localised to the client's `source_tz` (or UTC) instead of the local
+  machine timezone.
+- **Unknown article IDs raise `NotFoundError`** — vlr.gg returns a generic
+  HTTP 200 page for non-existent article IDs; `news.article()` now detects
+  the missing article card and raises `NotFoundError` instead of returning
+  an empty article.
+- **News article Markdown fidelity** — `content_md` now renders nested
+  lists, tables (as pipe tables), and inline `code` verbatim (whitespace
+  preserved). Links whose href is `www.`-prefixed are upgraded to
+  `https://`, fixing broken relative links in Markdown.
+- **Documentation** — news reference pages updated (article, list, index),
+  plus the getting-started guide, main docs index, and README now cover the
+  news namespace; model/parser docstrings describe the current behaviour.
+
+## [2.2.0] - 2026-08-11
+
+### 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.
+- **Series performance field renames (breaking)** — `AdvStatsEntry` fields
+  were renamed to descriptive names: `econ` → `economy`, `pl` → `plants`,
+  and `de` → `defuses`. Update any code referencing the old field names.
+  The series performance reference docs were updated to match.
+
+### 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).
+- **Series per-game stats by game number** — `players()`, `rounds()`,
+  `performance()`, and `economy()` game identifiers can now be a 1-based
+  game number within the series, resolved to the real VLR game ID from the
+  page's game nav tabs. A real VLR game ID is still accepted unchanged;
+  previously passing a game number produced empty results.
+- **Series economy and rounds scope** — economy and round-by-round data are
+  now parsed from the selected game's section only. The economy parser
+  previously collected tables from the whole page, so a per-game request
+  could include data from other maps.
+- **Series performance player IDs** — the performance tab renders player
+  cells without links, leaving player IDs as `0`. IDs are now recovered from
+  the series overview tab (keyed by team abbreviation and player name) and
+  attached to kill-matrix entries, advanced stats, and notable-round victims.
+
+## [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
+
+- **Series player stats** — overview tab HTML changed from `<table>` to
+  `<div>` on vlr.gg; updated CSS selectors to match the new structure.
+- **Player agent stats** — agent table class changed from `wf-table` to
+  `st-table.mod-agent-rows`; column count reduced from 17 to 16 (FKPR and
+  FDPR columns consolidated into a single FK:FD ratio column).
+- **Player profile** — same agent table selector fix; the profile fallback
+  to `timespan=all` now works correctly.
+- **Team fixtures** — updated stale test assertions for NRG Haven map
+  stats (games played, wins, losses, etc.) and total winnings to match
+  current vlr.gg data.
+
+### Removed
+
+- `fkpr` and `fdpr` fields from `AgentStats` model — vlr.gg no longer
+  exposes separate First Kills Per Round / First Deaths Per Round columns.
+  The `first_kills` and `first_deaths` total fields remain available.
+
+### Changed
+
+- **Documentation** — agents schema reference updated to reflect the
+  removal of `fkpr` and `fdpr`.
+
+## [2.0.0] - 2026-07-07
+
+### Major Rewrite
+
+Complete rewrite of the library. v2.0.0 replaces the asynchronous
+aiohttp-based v1.x with a synchronous httpx-based architecture.
+The API surface, module structure, and type system are all new.
+
+### Added
+
+- **Sync-first client** - `VLRClient` with context manager support and
+  thread-safe parallel enrichment for bulk operations.
+- **Curried access pattern** - bind a player/team/series/event ID once,
+  then chain sub-methods without re-passing the ID.
+- **Event namespace** - list with pagination and filtering (tier, region,
+  status), plus info, matches, stages, standings, and teams.
+- **Match listing namespace** - live, upcoming (paginated), and completed
+  (paginated) match feeds with team enrichment.
+- **Player namespace** - info, teams (current/past), agent stats
+  (30d/60d/90d/all), match history (paginated), and consolidated profile.
+- **Series namespace** - info (veto, games, scores), player stats per game,
+  round-by-round data, performance (kill matrices, advanced stats),
+  economy (buy types, spend analysis), and VOD links.
+- **Team namespace** - info, roster, stats (per-map with optional agent
+  composition), placements, transactions, completed and upcoming matches.
+- **Pydantic v2 models** - fully typed with Google-style docstrings and
+  field descriptions.
+- **Built-in resilience** - configurable retry with exponential/linear/
+  constant backoff, jitter, and token-bucket rate limiting.
+- **Thread-safe LRU cache** - bounded `LRUCache` for team data to avoid
+  redundant HTTP requests during enrichment.
+- **Input validation** - `@sanitize_and_validate` decorator with positive-ID
+  checks and Pydantic type coercion.
+- **Custom exceptions** - typed hierarchy (`NotFoundError`, `RateLimitError`,
+  `ParsingError`, `ValidationError`, etc.) for clean error handling.
+- **Documentation** - Zensical/MkDocs site via `docs-py/` (ReadTheDocs)
+  with auto-generated API reference from docstrings.
+- **Official website** - Next.js + Fumadocs site via `official-docs/`
+  (Cloudflare Pages) with interactive code examples.
+- **Doc validation** - `scripts/check_mdx_examples.py` validates syntax,
+  imports, and live execution of all code examples in docs.
+
+### Changed
+
+- **Architecture** - migrated from async aiohttp to synchronous httpx.
+  No more `await` or `async with` required.
+- **No explicit session management** - `VLRClient` handles connection
+  pooling, retries, and rate limiting internally.
+- **Type system** - replaced raw dict returns with Pydantic v2 models
+  for all endpoints.
+- **Build system** - moved from setuptools to hatchling with `uv` for
+  dependency management.
+- **Python requirement** - raised minimum to 3.11.
+
+### Removed
+
+- All v1.x async endpoints (`get_event`, `get_team`, `get_player`, etc.)
+  are removed. See the new module-level or client-based API.
+- `aiohttp` and `asyncio` dependencies.
+- v1.x match/event/team parsing modules.
+
+[2.4.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.3.0...v2.4.0
+[2.3.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.2.0...v2.3.0
+[2.2.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.1.0...v2.2.0
+[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.2.0 → vlrdevapi-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: vlrdevapi
-Version: 2.2.0
+Version: 2.4.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
@@ -68,7 +68,7 @@ Access Valorant esports data from VLR.gg with a clean, type-safe Python API. Get
 
 ## Features
 
-- **Complete Data Access** - Events, matches, players, teams, and series
+- **Complete Data Access** - Events, matches, players, teams, series, and news
 - **Type-Safe** - Pydantic models with rich type hints and field descriptions
 - **Production-Ready** - Retry logic, rate limiting, and LRU-cached enrichment
 - **Curried Access** - Bind a player/team/series ID once, then call sub-methods without re-passing
@@ -181,6 +181,17 @@ performance = s.performance()            # Advanced performance stats
 economy = s.economy(game_id=1)           # Economy data
 ```
 
+### News
+
+```python
+page = client.news(page=1)               # Browse the news listing
+for item in page.news[:5]:
+    print(item.title)
+
+article = client.news.article(734100)    # Fetch a full article
+print(article.content_md)                # Article body as Markdown
+```
+
 ## Documentation
 
 - **Official Docs** - [vlrdevapi.pages.dev/docs](https://vlrdevapi.pages.dev/docs)

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/README.md

@@ -20,7 +20,7 @@ Access Valorant esports data from VLR.gg with a clean, type-safe Python API. Get
 
 ## Features
 
-- **Complete Data Access** - Events, matches, players, teams, and series
+- **Complete Data Access** - Events, matches, players, teams, series, and news
 - **Type-Safe** - Pydantic models with rich type hints and field descriptions
 - **Production-Ready** - Retry logic, rate limiting, and LRU-cached enrichment
 - **Curried Access** - Bind a player/team/series ID once, then call sub-methods without re-passing
@@ -133,6 +133,17 @@ performance = s.performance()            # Advanced performance stats
 economy = s.economy(game_id=1)           # Economy data
 ```
 
+### News
+
+```python
+page = client.news(page=1)               # Browse the news listing
+for item in page.news[:5]:
+    print(item.title)
+
+article = client.news.article(734100)    # Fetch a full article
+print(article.content_md)                # Article body as Markdown
+```
+
 ## Documentation
 
 - **Official Docs** - [vlrdevapi.pages.dev/docs](https://vlrdevapi.pages.dev/docs)

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/pyproject.toml

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

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/scripts/check_mdx_examples.py

@@ -39,7 +39,7 @@ REPO_ROOT = Path(__file__).resolve().parent.parent
 DOCS_DIR = REPO_ROOT / "official-docs" / "content"
 DEFAULT_FIXTURES_DIR = REPO_ROOT / ".cache" / "mdx-html"
 
-DYNAMIC_PATHS = frozenset({"/matches", "/matches/results", "/events"})
+DYNAMIC_PATHS = frozenset({"/matches", "/matches/results", "/events", "/news"})
 
 
 class Result(NamedTuple):

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/scripts/download_fixtures.py

@@ -29,6 +29,15 @@ ROUTES += [
     ("/matches/results/?page=2", "matches/results_page2.html", {}),
 ]
 
+# ── News ───────────────────────────────────────────────────────
+ROUTES += [
+    ("/news", "news/news.html", {}),
+    ("/news/?page=2", "news/news_page2.html", {}),
+    ("/news/?page=300", "news/news_page300.html", {}),
+    ("/734100", "news/article_734100.html", {}),
+    ("/720033/americas-recent-victors-start-strong-in-week-1", "news/article_720033.html", {}),
+]
+
 # ── Events ─────────────────────────────────────────────────────
 ROUTES += [
     ("/events", "events/events.html", {}),
@@ -100,6 +109,9 @@ ADDITIONAL_EVENTS = [
     (2949, "gameon-productivity-and-technology-tournament-2026"),
     (2847, "challengers-2026-japan-split-1"),
     (58, "100t-x-cashapp-gamers-for-equality"),
+    (2763, "tesfed-turkish-cup-2025"),
+    (2544, "morocco-gaming-expo-2025"),
+    (3074, "raidiant-academy-2026"),
 ]
 
 for _eid, _eslug in ADDITIONAL_EVENTS:
@@ -118,8 +130,8 @@ ROUTES += [
 
 # ── Event standings pages (for standings filtering tests) ──────
 ROUTES += [
-    ("/event/2283", "event/2283/overview.html", {}),
-    ("/event/2682", "event/2682_americas_kickoff/overview.html", {}),
+    ("/event/2283/valorant-champions-2025", "event/2283_valorant-champions-2025/overview.html", {}),
+    ("/event/2682/vct-2026-americas-kickoff", "event/2682_vct-2026-americas-kickoff/overview.html", {}),
 ]
 
 # ── Event matches pages ─────────────────────────────────────────
@@ -311,10 +323,153 @@ ROUTES += [
 ]
 
 
+# ── Series 704037 Bo1 (single-map game, no nav tabs, no veto) ─
+SERIES_ID_BO1 = 704037
+SERIES_SLUG_BO1 = "mushoku-vs-fallen-angels-game-changers-2026-emea-stage-2-promotion-relegation-r1"
+GAME_ID_BO1 = 274641
+
+ROUTES += [
+    (
+        f"/{SERIES_ID_BO1}/{SERIES_SLUG_BO1}",
+        f"series/{SERIES_ID_BO1}/overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1}?game={GAME_ID_BO1}&tab=overview",
+        f"series/{SERIES_ID_BO1}/game_{GAME_ID_BO1}_overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1}?game={GAME_ID_BO1}&tab=performance",
+        f"series/{SERIES_ID_BO1}/game_{GAME_ID_BO1}_performance.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1}?game={GAME_ID_BO1}&tab=economy",
+        f"series/{SERIES_ID_BO1}/game_{GAME_ID_BO1}_economy.html",
+        {},
+    ),
+]
+
+# ── Series 64819 Bo1 (single-map, bans + decider veto) ────────
+SERIES_ID_BO1_VETO = 64819
+GAME_ID_BO1_VETO = 65212
+
+ROUTES += [
+    (
+        f"/{SERIES_ID_BO1_VETO}",
+        f"series/{SERIES_ID_BO1_VETO}/overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_VETO}?game={GAME_ID_BO1_VETO}&tab=overview",
+        f"series/{SERIES_ID_BO1_VETO}/game_{GAME_ID_BO1_VETO}_overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_VETO}?game={GAME_ID_BO1_VETO}&tab=performance",
+        f"series/{SERIES_ID_BO1_VETO}/game_{GAME_ID_BO1_VETO}_performance.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_VETO}?game={GAME_ID_BO1_VETO}&tab=economy",
+        f"series/{SERIES_ID_BO1_VETO}/game_{GAME_ID_BO1_VETO}_economy.html",
+        {},
+    ),
+]
+
+# ── Series 30788 Bo1 (single-map, pick veto) ──────────────────
+SERIES_ID_BO1_PICK = 30788
+GAME_ID_BO1_PICK = 47971
+
+ROUTES += [
+    (
+        f"/{SERIES_ID_BO1_PICK}",
+        f"series/{SERIES_ID_BO1_PICK}/overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_PICK}?game={GAME_ID_BO1_PICK}&tab=overview",
+        f"series/{SERIES_ID_BO1_PICK}/game_{GAME_ID_BO1_PICK}_overview.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_PICK}?game={GAME_ID_BO1_PICK}&tab=performance",
+        f"series/{SERIES_ID_BO1_PICK}/game_{GAME_ID_BO1_PICK}_performance.html",
+        {},
+    ),
+    (
+        f"/{SERIES_ID_BO1_PICK}?game={GAME_ID_BO1_PICK}&tab=economy",
+        f"series/{SERIES_ID_BO1_PICK}/game_{GAME_ID_BO1_PICK}_economy.html",
+        {},
+    ),
+]
+
+# ── Series: forfeit and notes parsing ───────────────────────
+SERIES_FORFEIT_NOTES = [
+    (477343, "shopify-rebellion-gold-vs-yfp-x-game-changers-2025-north-america-stage-1-r3"),
+    (67357, "t1-vs-tsm-champions-tour-north-america-stage-1-challengers-lr4"),
+    (155313, "blind-esports-vs-onlyfriends-nsg-yuddha-phase-2-all-india-championship-playoffs-lr1"),
+    (459856, "team-liquid-vs-karmine-corp-champions-tour-2025-emea-stage-1-w5"),
+    (715117, "shopify-rebellion-black-vs-2game-esports-vcl-26-americas-last-chance-qualifier-main-event-gf"),
+]
+
+for _sid, _sslug in SERIES_FORFEIT_NOTES:
+    ROUTES.append((f"/{_sid}/{_sslug}", f"series/{_sid}/overview.html", {}))
+
+
+def _parse_last_page(html: str) -> int | None:
+    """Parse the highest page number from vlr.gg pagination controls."""
+    from selectolax.parser import HTMLParser
+
+    doc = HTMLParser(html)
+    pagination = doc.css_first("div.action-container-pages")
+    if pagination is None:
+        return None
+    max_page = 0
+    for el in pagination.css("a.btn.mod-page, span.btn.mod-page"):
+        try:
+            num = int(el.text(strip=True))
+            if num > max_page:
+                max_page = num
+        except ValueError:
+            continue
+    return max_page if max_page > 0 else None
+
+
+async def _download_news_last_page(client: httpx.AsyncClient) -> None:
+    """Dynamically determine and download the last news page."""
+    out = FIXTURES_DIR / "news" / "news_last_page.html"
+    out.parent.mkdir(parents=True, exist_ok=True)
+    if out.exists():
+        print("SKIP (exists) news/news_last_page.html")
+        return
+
+    print("GET /news (to find last page number)")
+    try:
+        resp = await client.get("/news")
+        resp.raise_for_status()
+        last_page = _parse_last_page(resp.text)
+        if last_page is None:
+            print("         WARNING: could not parse last page number")
+            return
+
+        last_path = f"/news/?page={last_page}"
+        print(f"GET {BASE_URL}{last_path}")
+        resp2 = await client.get(last_path)
+        resp2.raise_for_status()
+        out.write_text(resp2.text, encoding="utf-8")
+        print(f"         -> {out.relative_to(FIXTURES_DIR.parent)}")
+    except (httpx.HTTPStatusError, httpx.RequestError) as e:
+        print(f"         ERROR {e}")
+
+
 async def download_all():
     async with httpx.AsyncClient(
         base_url=BASE_URL, headers=HEADERS, follow_redirects=True, timeout=30
     ) as client:
+        await _download_news_last_page(client)
+
         total = len(ROUTES)
         for i, (path, filename, cookies) in enumerate(ROUTES, 1):
             out = FIXTURES_DIR / filename

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/src/vlrdevapi/__init__.py

@@ -1,8 +1,8 @@
 """vlrdevapi — A Python library to scrape data from vlr.gg.
 
 Provides a synchronous, typed interface for accessing match listings,
-event data, tournament info, team/player profiles, and statistics
-from vlr.gg.
+event data, tournament info, team/player profiles, statistics, and
+news from vlr.gg.
 
 Examples:
     Module-level access (using a default client):
@@ -23,17 +23,25 @@ Examples:
     >>> matches.matches[0].score
     '2-1'
 
+    News listing and articles:
+
+    >>> page = vlrdevapi.news(page=1)
+    >>> article = vlrdevapi.news.article(page.news[0].id)
+    >>> article.title != ''
+    True
+
 """
 
 import atexit as _atexit
+import contextlib
 from typing import TYPE_CHECKING
 
 from vlrdevapi._client import VLRClient
-import contextlib
 
 if TYPE_CHECKING:
     from vlrdevapi._event.namespace import EventNamespace
     from vlrdevapi._matches.namespace import MatchesNamespace
+    from vlrdevapi._news.namespace import NewsNamespace
     from vlrdevapi._player.namespace import PlayerNamespace
     from vlrdevapi._series.namespace import SeriesNamespace
     from vlrdevapi._team.namespace import TeamNamespace
@@ -43,22 +51,23 @@ if TYPE_CHECKING:
     player: PlayerNamespace
     team: TeamNamespace
     matches: MatchesNamespace
+    news: NewsNamespace
     client: type[VLRClient]
 
-__version__ = "2.2.0"
+__version__ = "2.4.0"
 
 _default_client: "VLRClient | None" = None
 
 
 def _get_default_client() -> "VLRClient":
-    global _default_client  # noqa: PLW0603
+    global _default_client
     if _default_client is None:
         _default_client = VLRClient()
     return _default_client
 
 
 def _cleanup_default_client() -> None:
-    global _default_client  # noqa: PLW0603
+    global _default_client
     if _default_client is not None:
         with contextlib.suppress(OSError):
             _default_client.close()
@@ -67,7 +76,7 @@ def _cleanup_default_client() -> None:
 
 _atexit.register(_cleanup_default_client)
 
-_BOUND_NAMES = frozenset({"event", "series", "player", "team", "matches"})
+_BOUND_NAMES = frozenset({"event", "series", "player", "team", "matches", "news"})
 
 
 def __getattr__(name: str) -> object:
@@ -89,6 +98,7 @@ __all__ = [
     "client",
     "event",
     "matches",
+    "news",
     "player",
     "series",
     "team",

{vlrdevapi-2.2.0 → vlrdevapi-2.4.0}/src/vlrdevapi/__init__.pyi

@@ -1,6 +1,7 @@
 from vlrdevapi._client import VLRClient
 from vlrdevapi._event.namespace import EventNamespace
 from vlrdevapi._matches.namespace import MatchesNamespace
+from vlrdevapi._news.namespace import NewsNamespace
 from vlrdevapi._player.namespace import PlayerNamespace
 from vlrdevapi._series.namespace import SeriesNamespace
 from vlrdevapi._team.namespace import TeamNamespace
@@ -69,6 +70,20 @@ Examples:
     >>> completed = vlrdevapi.matches.completed()
 """
 
+news: NewsNamespace
+"""Access news from vlr.gg: news listings and full article content.
+
+Returns:
+    NewsNamespace instance bound to the default client. Call it with a
+    ``page`` number to browse the news listing, or use ``.article()`` to
+    fetch a single article (plain text and Markdown).
+
+Examples:
+    >>> page = vlrdevapi.news(page=1)
+    >>> article = vlrdevapi.news.article(734100)
+    >>> print(article.content_md)
+"""
+
 client: type[VLRClient]
 """Create an explicit VLRClient for connection management.