vlrdevapi 3.1.0__tar.gz → 3.1.2__tar.gz

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/.github/workflows/cleanup-caches.yml

@@ -10,7 +10,7 @@ permissions:
 
 jobs:
   cleanup:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - name: Delete PR caches
         env:

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/.github/workflows/docs-check.yml

@@ -5,15 +5,19 @@ on:
     paths:
       - 'official-docs/**'
       - 'docs-py/**'
+      - 'src/**'
+      - 'scripts/**'
   push:
     branches: [main]
     paths:
       - 'official-docs/**'
       - 'docs-py/**'
+      - 'src/**'
+      - 'scripts/**'
 
 jobs:
   check:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v7
 
@@ -24,6 +28,9 @@ jobs:
       - name: Install package
         run: uv sync --group dev --all-extras
 
+      - name: Validate documentation schemas against Python library
+        run: uv run scripts/check_docs_schema.py
+
       # Restore fixture cache scoped to the current ref (branch or main) and version prefix (v3).
       # This ensures caches are never shared across unrelated branches or older versions.
       - name: Restore fixture cache

vlrdevapi-3.1.2/.github/workflows/mcp-publish.yml

@@ -0,0 +1,27 @@
+name: Publish to MCP Registry
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    name: Publish to MCP Registry
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

vlrdevapi-3.1.2/.github/workflows/publish.yml

@@ -0,0 +1,99 @@
+name: Publish to PyPI and MCP Registry
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      target:
+        description: 'What to publish'
+        required: true
+        type: choice
+        options:
+          - 'all'
+          - 'mcp-only'
+          - 'pypi-only'
+        default: 'all'
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test on Python ${{ matrix.python-version }}
+    if: github.event_name == 'release' || inputs.target != 'mcp-only'
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13', '3.14', '3.15']
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --group dev --all-extras
+
+      - name: Download fixtures
+        run: uv run python scripts/download_fixtures.py
+
+      - name: Run tests
+        run: uv run pytest
+
+  pypi-publish:
+    name: Publish to PyPI
+    if: github.event_name == 'release' || inputs.target != 'mcp-only'
+    runs-on: ubuntu-24.04
+    needs:
+      - test
+
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/project/vlrdevapi/
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  mcp-publish:
+    name: Publish to MCP Registry
+    if: always() && (github.event_name == 'release' || inputs.target != 'pypi-only') && (inputs.target == 'mcp-only' || needs.pypi-publish.result == 'success')
+    runs-on: ubuntu-24.04
+    needs:
+      - pypi-publish
+
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+
+      - name: Wait for PyPI propagation
+        if: github.event_name == 'release' || inputs.target != 'mcp-only'
+        run: sleep 15
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/.github/workflows/test.yml

@@ -21,7 +21,7 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
         python-version: ['3.11', '3.12', '3.13', '3.14', '3.15']

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/CHANGELOG.md

@@ -5,6 +5,41 @@ 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/).
 
+## [3.1.2] - 2026-11-14
+
+### Fixed
+
+- **MCP Registry OIDC Namespace Alignment** — Updated server namespace to `io.github.Vanshbordia/vlrdevapi` in `server.json` to match GitHub identity claim casing strictly, resolving `403 Forbidden` errors during automated registry publishing.
+- **Multilingual Documentation Schemas** — Aligned model attribute tables and executable code examples across Spanish, Portuguese, and Simplified Chinese documentation to match the Python SDK models.
+- **Documentation Verification Pipeline** — Added `check_docs_schema.py` to continuously validate MDX documentation tables against live Python runtime models before doc builds and deployments.
+
+### Added
+
+- **Standalone MCP Publishing Workflow** — Added dedicated `.github/workflows/mcp-publish.yml` allowing standalone MCP registry publication on demand via `workflow_dispatch`.
+- **Targeted Release Dispatch** — Added dispatch targets (`all`, `mcp-only`, `pypi-only`) to `publish.yml` to support selective re-releases when PyPI or MCP registry publication runs independently.
+
+### Changed
+
+- **CI/CD Runner Upgrades** — Pinned `runs-on: ubuntu-24.04` across all GitHub Actions workflows to eliminate runner deprecation warnings.
+- **Direct PyPI Build Integration** — Streamlined release pipeline by building packages directly with `uv build` in the publish step, eliminating Node.js 20 deprecated artifact upload/download actions.
+
+## [3.1.1] - 2026-11-13
+
+### Added
+
+- **Official MCP Registry Manifest** — Added `server.json` compliant with the Model Context Protocol registry schema (`registry.modelcontextprotocol.io`), registering `io.github.Vanshbordia/vlrdevapi` with stdio transport and `uvx` runtime arguments.
+- **Automated MCP Registry Publishing Workflow** — Extended GitHub Actions release pipeline (`publish.yml`) with automated OIDC authentication (`id-token: write`) via `mcp-publisher`.
+- **PyPI MCP Ownership Verification** — Added package ownership verification marker to `README.md`.
+
+### Fixed
+
+- **MCP Registry CLI Entrypoint** — Expose `vlrdevapi` console script alias to `vlrdevapi.mcp.server:main` alongside `vlrdevapi-mcp` so MCP registry clients launch the server using the package identifier.
+- **Windows Timezone Support** — Added `tzdata>=2025.1; sys_platform == 'win32'` as a core dependency to resolve `ZoneInfoNotFoundError` when running `vlrdevapi` or `uvx` on Windows.
+
+### Changed
+
+- **Dependency Upgrades** — Bumped core Python dependencies (Pydantic, Pandas, Polars, PyArrow, Pytest, Ruff) and documentation website dependencies (Next.js 16.4.6, Fumadocs 16.19, Tailwind CSS 4.3.5).
+
 ## [3.1.0] - 2026-10-25
 
 ### Added
@@ -485,6 +520,8 @@ The API surface, module structure, and type system are all new.
 - `aiohttp` and `asyncio` dependencies.
 - v1.x match/event/team parsing modules.
 
+[3.1.2]: https://github.com/Vanshbordia/vlrdevapi/compare/v3.1.1...v3.1.2
+[3.1.1]: https://github.com/Vanshbordia/vlrdevapi/compare/v3.1.0...v3.1.1
 [3.1.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.4.1...v3.0.0
 [2.4.1]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.4.0...v2.4.1

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vlrdevapi
-Version: 3.1.0
+Version: 3.1.2
 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
@@ -42,6 +42,7 @@ Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.14.1
 Requires-Dist: selectolax>=1.0.0
+Requires-Dist: tzdata>=2025.1; sys_platform == 'win32'
 Provides-Extra: all
 Requires-Dist: mcp>=1.2.0; extra == 'all'
 Requires-Dist: openpyxl>=3.1.0; extra == 'all'
@@ -88,6 +89,8 @@ Description-Content-Type: text/markdown
 
 </div>
 
+<!-- mcp-name: io.github.Vanshbordia/vlrdevapi -->
+
 ---
 
 **vlrdevapi** is a high-performance, type-safe Python client for extracting and analyzing Valorant esports data from [VLR.gg](https://www.vlr.gg/). Built for competitive analysts, data scientists, Discord bot creators, and esports engineers, it delivers structured [Pydantic](https://docs.pydantic.dev/) models with full type hinting, built-in rate limiting, automatic retries, and comprehensive coverage across all VLR.gg entities.
@@ -373,7 +376,7 @@ print(players.to_markdown())
 
 ## Model Context Protocol (MCP) Server
 
-VLRdevAPI includes a native MCP server for AI assistants and autonomous coding agents:
+VLRdevAPI includes a native MCP server for AI assistants and autonomous coding agents (`io.github.Vanshbordia/vlrdevapi` on the official MCP Registry):
 
 ```bash
 # Run server over stdio

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/README.md

@@ -17,6 +17,8 @@
 
 </div>
 
+<!-- mcp-name: io.github.Vanshbordia/vlrdevapi -->
+
 ---
 
 **vlrdevapi** is a high-performance, type-safe Python client for extracting and analyzing Valorant esports data from [VLR.gg](https://www.vlr.gg/). Built for competitive analysts, data scientists, Discord bot creators, and esports engineers, it delivers structured [Pydantic](https://docs.pydantic.dev/) models with full type hinting, built-in rate limiting, automatic retries, and comprehensive coverage across all VLR.gg entities.
@@ -302,7 +304,7 @@ print(players.to_markdown())
 
 ## Model Context Protocol (MCP) Server
 
-VLRdevAPI includes a native MCP server for AI assistants and autonomous coding agents:
+VLRdevAPI includes a native MCP server for AI assistants and autonomous coding agents (`io.github.Vanshbordia/vlrdevapi` on the official MCP Registry):
 
 ```bash
 # Run server over stdio

{vlrdevapi-3.1.0 → vlrdevapi-3.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vlrdevapi"
-version = "3.1.0"
+version = "3.1.2"
 description = "A Python library to scrape data from vlr.gg"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -37,6 +37,7 @@ dependencies = [
     "httpx>=0.28.1",
     "pydantic>=2.14.1",
     "selectolax>=1.0.0",
+    "tzdata>=2025.1; sys_platform == 'win32'",
 ]
 
 [project.urls]
@@ -80,6 +81,7 @@ all = [
 ]
 
 [project.scripts]
+vlrdevapi = "vlrdevapi.mcp.server:main"
 vlrdevapi-mcp = "vlrdevapi.mcp.server:main"
 
 [dependency-groups]
@@ -123,4 +125,3 @@ exclude = [
     "/.pytest_cache",
     "/.ruff_cache",
 ]
-