{"id":26725,"library":"aoe2rec-py","title":"aoe2rec-py","description":"Python bindings for aoe2rec, a Rust library for parsing Age of Empires 2 recorded game files. Currently at version 0.1.21, requires Python >=3.9, and is released alongside the core aoe2rec crate. Development is active via GitHub.","status":"active","version":"0.1.21","language":"python","source_language":"en","source_url":"https://github.com/aoe2ct/aoe2rec/tree/main/crates/aoe2rec-py","tags":["age-of-empires-2","recorded-game","parser","rust-bindings","game-analysis"],"install":[{"cmd":"pip install aoe2rec-py","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Primary function to parse a recording file.","symbol":"parse_recording","correct":"from aoe2rec_py import parse_recording"},{"note":"Type returned by parse_recording.","symbol":"Recording","correct":"from aoe2rec_py import Recording"}],"quickstart":{"code":"from aoe2rec_py import parse_recording\n\n# Replace with a path to a valid .aoe2record file\nrecording = parse_recording(\"path/to/recording.aoe2record\")\nprint(f\"Map: {recording.map_name}\")\nprint(f\"Players: {len(recording.players)}\")","lang":"python","description":"Parses a recording file and prints map name and player count. Works directly with saved .aoe2record files."},"warnings":[{"fix":"Use `from aoe2rec_py import ...` (underscores).","message":"The import path uses underscores: 'aoe2rec_py', not hyphens. Common mistake: 'from aoe2rec-py import ...' fails.","severity":"gotcha","affected_versions":"all"},{"fix":"Check the aoe2rec core crate for version support and open issues if a recording fails.","message":"The library may not parse all versions of recorded games, especially very old or modded ones. The underlying Rust crate is under active development.","severity":"gotcha","affected_versions":"<=0.1.21"},{"fix":"Stay updated; the import path and function name are likely to stabilize.","message":"The function `parse_recording` may be renamed to `load_recording` in future versions; check latest docs.","severity":"deprecated","affected_versions":"0.1.x"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Change import to: from aoe2rec_py import parse_recording","cause":"Using hyphens in import statement instead of underscores.","error":"ImportError: No module named aoe2rec-py"},{"fix":"Ensure the file path is a valid string pointing to an existing .aoe2record file.","cause":"Passing None or invalid path to parse_recording.","error":"TypeError: argument must be a string, not None"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}