blitz-replays analyze

[Jylpah]

Design document

blitz-replays analyze is a command to analyze replays and print various stats.

Requirements

1. Can read replays from files (JSON) or database (SQLite)

Consider using blitzstats.BackEnd() since it would add support for MongoDB

2. Filter replays

Filter replays to analyze based on:

• player / account_id
• tank
• tier (well, tank)
• battle played
• in platoon / solo
• battle result (win/loss/draw)
• game mode (Regular, special modes)
• battle mode (Encounter/Supremacy)
• map

3. Player stats

Fetch player stats from WG API tanks/stats/. The measure can be any WR, average damage or number of battles. For each there are three options:

1. Average WR/average damage/total battles
2. WR/average damage/battles at the tier played
3. WR/average/damage/battles in a tank played

Edge cases

• Options 2-3 are problematic in edge cases where there are only very few battles. Should there be a lower limit for battles before the WR "becomes valid"?
• Should the "tier" be the tier of the battle or the tier of each player's tank? The former does not exist for all. Probably the latter.

4. Configurable analysis/categorization like in the old version

Have look at the BattleCategorization() and consider refactoring to something more solid.

5. Configurable columns

Like in the blitz-tools replay analysis tool.

• TOML config file will be used for customizing reports
• User will be open to add new reports and combine it with the default reports.

[Jylpah]

First working version released 🎉

pip install git+https://github.com/Jylpah/blitz-replays.git

[Jylpah]

Status with 0.5.20

• Replay analysis works and is fast.
• Support for user configurable reports and field through a TOML config file
• Export reports to a tab-separated file that can be opened with Excel
• Add --config option for app configuration file

Todo

• Improve documentation
  • How to access replays on Microsoft Store version
• Add option to create an empty config file
• Add commands to update maps and tankopedia from GH repo
• Database cache for API stats
• --filter to filter replays based on a criteria
• Support for reading replays from a DB