vlrdevapi 2.3.0__tar.gz → 2.4.1__tar.gz

vlrdevapi-2.4.1/.nvmrc

@@ -0,0 +1 @@
+26.10.0

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/.readthedocs.yaml

@@ -6,10 +6,11 @@ build:
     python: latest
   jobs:
     install:
-      - pip install zensical mkdocstrings mkdocstrings-python
+      - pip install uv
+      - uv sync --group dev
     build:
       html:
-        - cd docs-py && zensical build
+        - cd docs-py && uv run zensical build
     post_build:
       - mkdir -p $READTHEDOCS_OUTPUT/html/
       - cp --recursive docs-py/site/* $READTHEDOCS_OUTPUT/html/

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/CHANGELOG.md

@@ -5,6 +5,129 @@ 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.1] - 2026-10-17
+
+### Fixed
+
+- **Series players/stats parsing** — newer vlr.gg overview tables add a
+  dedicated `.mod-agents` cell before the stat columns. Stat cells are now
+  mapped dynamically around that column, and agents are read from the new
+  cell. This fixes `SideStats` validation errors and misaligned values
+  (rating, ACS, KDA, KAST, ADR, HS%, first kills/deaths).
+- **Series economy parsing** — the round-by-round economy grid now uses the
+  newer `.vlr-rounds.ecr` markup (`.ecr-bank`, `.ecc-c`, `.ecc-sq`). Banks,
+  spends, buy types, and round winners are read from it, with the legacy
+  `.wf-table-inset.mod-econ` table kept as a fallback.
+- **Series VODs parsing** — VODs are now read from the newer `.sm-vods`
+  module (`.sm-vod-name` labels, `a.sm-ext` links), keeping the legacy
+  `.match-vods` container as a fallback.
+- **Series game map names** — the game header now renders the duration as a
+  sibling of the map name. The map name is read from `.map-name`, so the
+  duration is no longer concatenated (e.g. `Pearl` instead of `Pearl35:48`).
+
+### Changed
+
+- **Series economy team matching** — team/abbreviation resolution is now
+  case-insensitive, so team IDs resolve for pages that render short tags.
+- **HTML parsing backend** — parsing now uses selectolax's Lexbor engine
+  (`selectolax.lexbor`) instead of the discontinued Modest engine
+  (`selectolax.parser`), which selectolax removed in 1.0. This is an internal
+  change: the public API, CSS selectors, and parsed output are unchanged.
+- **Dependencies** — raised the `selectolax` minimum to `>=1.0.0` and moved
+  `pydantic` to the 2.14 series.
+
+### Documentation
+
+- **Changelog** — this release is mirrored across `CHANGELOG.md`, the
+  ReadTheDocs changelog (`docs-py/docs/changelog.md`), and the official
+  site changelog (`official-docs/app/(home)/changelog/page.tsx`).
+
+## [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
@@ -193,6 +316,8 @@ The API surface, module structure, and type system are all new.
 - `aiohttp` and `asyncio` dependencies.
 - v1.x match/event/team parsing modules.
 
+[2.4.1]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.4.0...v2.4.1
+[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

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: vlrdevapi
-Version: 2.3.0
+Version: 2.4.1
 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
@@ -38,11 +38,11 @@ Classifier: Topic :: Games/Entertainment
 Classifier: Topic :: Internet :: WWW/HTTP
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: pydantic>=2.12.5
-Requires-Dist: selectolax>=0.4.7
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: selectolax>=1.0.0
 Provides-Extra: test
 Requires-Dist: pytest-cov>=7.1.0; extra == 'test'
-Requires-Dist: pytest>=8.0; extra == 'test'
+Requires-Dist: pytest>=9.1.1; extra == 'test'
 Requires-Dist: respx>=0.23.1; extra == 'test'
 Description-Content-Type: text/markdown
 

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vlrdevapi"
-version = "2.3.0"
+version = "2.4.1"
 description = "A Python library to scrape data from vlr.gg"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -22,8 +22,8 @@ classifiers = [
 ]
 dependencies = [
     "httpx>=0.28.1",
-    "pydantic>=2.12.5",
-    "selectolax>=0.4.7",
+    "pydantic>=2.14.1",
+    "selectolax>=1.0.0",
 ]
 
 [project.urls]
@@ -33,22 +33,22 @@ Documentation = "https://vlrdevapi.pages.dev/docs"
 
 [project.optional-dependencies]
 test = [
-    "pytest>=8.0",
+    "pytest>=9.1.1",
     "respx>=0.23.1",
     "pytest-cov>=7.1.0",
 ]
 
 [dependency-groups]
 dev = [
-    "ruff>=0.15.10",
-    "pytest>=8.0",
-    "tzdata>=2026.1",
-    "ty>=0.0.31",
+    "ruff>=0.17.1",
+    "pytest>=9.1.1",
+    "tzdata>=2026.5",
+    "ty>=0.0.89",
     "respx>=0.23.1",
     "pytest-cov>=7.1.0",
-    "zensical>=0.0.46",
-    "mkdocstrings>=0.28.0",
-    "mkdocstrings-python>=1.16.0",
+    "zensical>=0.0.71",
+    "mkdocstrings>=1.0.7",
+    "mkdocstrings-python>=2.0.9",
 ]
 
 [tool.pytest.ini_options]

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/scripts/check_mdx_examples.py

@@ -6,6 +6,12 @@ executes examples. An ``httpx.Client.get`` interceptor de-duplicates
 fetches within a run and can replay validation offline against HTML
 fixtures saved under ``.cache/mdx-html/`` (gitignored).
 
+Blocks may carry two markers (both stripped from rendered docs by the
+remark plugin in ``official-docs/source.config.ts``):
+
+    ``# doc-check: skip``          never execute (non-runnable demo code)
+    ``# doc-check: allow-empty``   execute, but empty output is acceptable
+
 CI/CD usage:
     python scripts/check_mdx_examples.py              # warm + offline replay
     python scripts/check_mdx_examples.py --skip-warm  # offline replay only
@@ -401,6 +407,26 @@ def has_skip_marker(code: str) -> bool:
     return any(line.strip().startswith("# doc-check: skip") for line in code.splitlines())
 
 
+def has_allow_empty_marker(code: str) -> bool:
+    """Blocks may opt out of the empty-output rule with `# doc-check: allow-empty`.
+
+    Use for examples that filter live data and can legitimately match nothing
+    on a given day. The block still runs and still fails on exceptions or
+    timeouts; only the "no output" requirement is relaxed.
+    """
+    return any(
+        line.strip().startswith("# doc-check: allow-empty")
+        for line in code.splitlines()
+    )
+
+
+def apply_allow_empty(code: str, run_ok: bool, run_msg: str) -> tuple[bool, str]:
+    """Relax an empty-output failure for blocks marked `# doc-check: allow-empty`."""
+    if not run_ok and has_allow_empty_marker(code) and "no output" in run_msg.lower():
+        return True, "(no output - allowed by marker)"
+    return run_ok, run_msg
+
+
 async def execute_blocks(
     results: list[Result],
     timeout: float,
@@ -433,6 +459,11 @@ async def execute_blocks(
         else:
             run_ok, run_msg, dur = await exec_sync(code, timeout)
 
+        # Blocks marked `# doc-check: allow-empty` may legitimately print
+        # nothing (e.g. a filtered loop over live data that matched no rows).
+        # They still fail on exceptions and timeouts.
+        run_ok, run_msg = apply_allow_empty(code, run_ok, run_msg)
+
         if record_results:
             results[i] = Result(
                 r.file, r.code, r.syntax_ok, r.syntax_error, r.imports_ok,

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/scripts/download_fixtures.py

@@ -33,8 +33,7 @@ ROUTES += [
 ROUTES += [
     ("/news", "news/news.html", {}),
     ("/news/?page=2", "news/news_page2.html", {}),
-    ("/news/?page=126", "news/news_page126.html", {}),
-    ("/news/?page=176", "news/news_page176.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", {}),
 ]
@@ -110,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:
@@ -128,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 ─────────────────────────────────────────
@@ -321,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.lexbor import LexborHTMLParser as 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.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/__init__.py

@@ -54,7 +54,7 @@ if TYPE_CHECKING:
     news: NewsNamespace
     client: type[VLRClient]
 
-__version__ = "2.3.0"
+__version__ = "2.4.1"
 
 _default_client: "VLRClient | None" = None
 

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_base.py

@@ -6,7 +6,7 @@ from collections.abc import Callable
 from typing import Any
 
 import httpx
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi.fetcher import (
     BASE_URL,

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/info/models.py

@@ -63,6 +63,10 @@ class EventRegion(BaseModel):
         default="",
         description="Region name (e.g., 'EMEA', 'Pacific', 'Americas', 'China', 'International')",
     )
+    subregion: str | None = Field(
+        default=None,
+        description="Subregion name if parsed from a subregion= breadcrumb (e.g., 'Japan', 'North America'); None for region= links",
+    )
     href: str = Field(default="", description="Relative path (e.g., '/vct/?region=27')")
 
 

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/info/parser.py

@@ -4,7 +4,8 @@ from datetime import date, datetime
 
 from vlrdevapi.commons.datetime import date_to_utc_datetime
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.info.models import (
     EventInfo,
@@ -16,12 +17,25 @@ from vlrdevapi._event.info.models import (
 )
 from vlrdevapi.commons.countries import get_country_name
 from vlrdevapi.commons.prizes import parse_prize_amount
+from vlrdevapi.commons.regions import resolve_country_to_region, resolve_subregion_to_region
 import contextlib
 
 
 def parse_event_info(html: HTMLParser, event_id: int) -> EventInfo:
     """Parse event info from the event page HTML.
 
+    After basic parsing the region list is post-processed:
+
+    1. Duplicates (same region name from ``region=`` and ``subregion=``
+       breadcrumbs) are collapsed; the entry carrying a ``subregion``
+       value is kept.
+    2. Two or more distinct regions collapse to a single
+       ``EventRegion(name="International")``.
+    3. When no breadcrumb region was found, the ``region_location``
+       country is tried first; if absent, ``location.country`` is
+       tried.  Either is resolved via ``resolve_country_to_region``
+       to infer the parent region.
+
     Args:
         html: Parsed HTML from the event page.
         event_id: Unique event identifier on vlr.gg.
@@ -42,6 +56,28 @@ def parse_event_info(html: HTMLParser, event_id: int) -> EventInfo:
     _parse_title(header, event)
     _parse_desc_items(header, event)
 
+    seen: dict[str, EventRegion] = {}
+    for r in event.regions:
+        if r.name not in seen:
+            seen[r.name] = r
+        elif r.subregion and not seen[r.name].subregion:
+            seen[r.name] = r
+    event.regions = list(seen.values())
+
+    if len(event.regions) > 1:
+        event.regions = [EventRegion(name="International")]
+
+    if not event.regions:
+        country = None
+        if event.region_location and event.region_location.country:
+            country = event.region_location.country
+        elif event.location and event.location.country:
+            country = event.location.country
+        if country:
+            parent = resolve_country_to_region(country)
+            if parent:
+                event.regions = [EventRegion(name=parent)]
+
     return event
 
 
@@ -62,7 +98,14 @@ def _parse_image(header: Node, event: EventInfo) -> None:
 
 
 def _parse_breadcrumb(header: Node, event: EventInfo) -> None:
-    """Parse breadcrumb links (series, stage, regions) from the header.
+    """Parse breadcrumb links (series, stage, regions/subregions) from the header.
+
+    Region resolution priority:
+
+    1. ``region=`` links are stored directly.
+    2. ``subregion=`` links are resolved to their parent region via
+       ``resolve_subregion_to_region``; the original subregion name is
+       preserved in ``EventRegion.subregion``.
 
     Args:
         header: The event-header root node.
@@ -93,10 +136,12 @@ def _parse_breadcrumb(header: Node, event: EventInfo) -> None:
 
         if "stage=" in href:
             event.stage = EventStageTag(name=name, href=href)
+        elif "subregion=" in href:
+            parent = resolve_subregion_to_region(name)
+            if parent:
+                event.regions.append(EventRegion(name=parent, subregion=name, href=href))
         elif "region=" in href:
             event.regions.append(EventRegion(name=name, href=href))
-        else:
-            event.regions.append(EventRegion(name=name, href=href))
 
 
 def _parse_title(header: Node, event: EventInfo) -> None:

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/list/parser.py

@@ -1,7 +1,8 @@
 import re
 from typing import Literal
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.info.models import EventPrize
 from vlrdevapi._event.list.models import (

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/matches/parser.py

@@ -2,7 +2,8 @@
 from datetime import date, tzinfo
 from zoneinfo import ZoneInfo
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.matches.models import (
     EventMatch,

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/stages/parser.py

@@ -4,7 +4,8 @@ import re
 from datetime import date, datetime
 from urllib.parse import parse_qs, urlparse
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.stages.models import EventStage, EventStages
 from vlrdevapi.exceptions import DataNotFoundError

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/standings/parser.py

@@ -1,6 +1,7 @@
 """Event standings parser."""
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.standings.models import StandingEntry, TeamStanding
 from vlrdevapi.commons.prizes import parse_prize_amount

{vlrdevapi-2.3.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/teams/parser.py

@@ -1,4 +1,5 @@
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.teams.models import Team, TeamPlayer