data-pokemon-vgc 0.2.0

A parser and downloader for Pokémon VGC tournament data from rk9.gg

Data-Pokemon-VGC

A Python package to download and parse Pokémon VGC tournament data from rk9.gg, including players, pairings, and team details.

Features

• Download tournament data by tournament code
• Extract players and their teams with detailed Pokémon info
• Save data as JSON files in a structured format
• Command-line interface for easy usage

Installation

pip install Data-Pokemon-VGC

Or clone the repo and install locally:

git clone https://github.com/Rxdsilver/Data-Pokemon-VGC.git
cd Data-Pokemon-VGC
pip install .

Usage

Run this script to download tournament:

python -m scripts.download_tournament 'RK9_Code'

Run this script to get usage:

python -m scripts.compute_usage 'RK9_Code'

This will download tournament info, players, pairings, and teams, and save JSON files in the data/ directory named with the tournament code.

Project Structure

├── scripts/
│   └── download_tournament.py   # Main entry point CLI script
├── tournament_parser/
│   ├── models.py                # Data classes for Tournament, Player, Team, etc.
│   ├── parser.py                # Parsing logic from HTML pages
│   ├── utils.py                 # Helper functions (e.g. URL builders)
│   └── save.py                  # Functions to save JSON data
├── data/                       # Output JSON files saved here
├── tests/                      # Unit tests

Development & Tests

• Python 3.11+
• Use pytest to run tests