.gitignore

# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
venv/
env/
ENV/
*.egg-info/
dist/
build/

# IDE
.idea/
.vscode/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

# Testing
.pytest_cache/
.coverage
htmlcov/
.tox/

# Logs
*.log

# Temporary files
*.tmp
*.bak
*.swp

# Environment
.env
.env.local

# Local test inputs — absolute paths into licensed material on one machine.
# .env.test.example is the tracked template.
.env.test

.venv/
.claude/
.worktrees/

# Licensed / private material — MUST NEVER be committed.
# HERODesignerSource/ is Simon Ubsdell's licensed Hero Designer Java source
# (personal-use license, purchased 2026-04-07). legal/ holds the purchase
# receipts. Committing either puts them in history permanently.
HERODesignerSource/
legal/

# Derived Hero Games content — MUST NEVER be committed.
#
# tests/fixtures/oracle/ is 655 JSON dumps of characters from the HERO System
# Bestiary, Champions Villains 1-2 and the HERO System Equipment Guide: 651
# named characters with their power names and full costed builds. That is a
# machine-readable reproduction of published stat blocks, however useful it is
# as a test corpus.
#
# They are generated, not authored, from packs you own — but the generator is
# not here either: it drives a headless build of HERO Designer to dump HD's own
# costs, and that harness wraps licensed source, so it cannot be published. The
# tests that need these fixtures skip without them, and the suite passes.
#
# The .hdc files are Champions Villains character files themselves, and
# roundtrip_hd6_costs.json is one character's costed build. Same rule.
tests/fixtures/oracle/
tests/fixtures/*.hdc
tests/fixtures/**/*.hdc
tests/fixtures/roundtrip_hd6_costs.json

# DELIBERATELY TRACKED, and the only .hdc files in the repository:
# tests/fixtures/authored/{Ravel,Bokor,PowerLad}.hdc are PeterB's own
# characters, built on stock templates and cleared by him for publication
# (2026-09-01). They are here so the canonical load path -- HDCLoader on a
# real HD-saved file -- runs by default instead of only where an environment
# variable happened to be set.
#
# The `tests/fixtures/**/*.hdc` line above is what makes these three
# negations load-bearing, and it was added for that reason. `*.hdc` alone
# does not match a subdirectory, so before it every .hdc under
# tests/fixtures/authored/ was tracked by default -- including any licensed
# third-party character dropped there, which `git add -A` would have staged
# without a word. Deny everything under tests/fixtures/, re-admit exactly
# three by name.
#
# THREE FILES, NO MORE. Nothing else from that document store may be added:
# the rest is licensed third-party content and personal campaign material,
# including the variants that sit beside these (background sheets, kits).
!tests/fixtures/authored/Ravel.hdc
!tests/fixtures/authored/Bokor.hdc
!tests/fixtures/authored/PowerLad.hdc