---
# nuzlocke-tracker-dqyb
title: Set up Python tool scaffold
status: completed
type: task
priority: normal
created_at: 2026-02-11T08:42:58Z
updated_at: 2026-02-11T08:49:55Z
parent: nuzlocke-tracker-bs05
blocking:
    - nuzlocke-tracker-zno2
---

Set up the standalone Python tool project in `tools/import-pokedb/`.

## Checklist

- [x] Create `tools/import-pokedb/` directory structure
- [x] Set up `pyproject.toml` with dependencies (just stdlib should suffice for JSON processing, maybe `click` for CLI)
- [x] Create CLI entry point (`__main__.py` or similar) that accepts:
  - Path to directory containing PokeDB JSON export files
  - Target output directory (default: `backend/src/app/seeds/data/`)
  - Optional: specific game version to generate (default: all)
- [x] Load and parse all PokeDB JSON files: `encounters.json`, `locations.json`, `location_areas.json`, `encounter_methods.json`, `versions.json`, `pokemon_forms.json`
- [x] Basic validation that all expected files are present and parseable

## Notes
- Keep it as a standalone tool, not part of the backend
- The PokeDB JSON files are downloaded manually from https://pokedb.org/data-export — no need to automate the download
- Model the CLI similarly to how `tools/fetch-pokeapi/` works (cd into dir, run the tool)