Skip to content

API Reference

Auto-generated from source docstrings. All public classes and functions follow Google-style docstrings.

Removed compatibility modules

Root-level compatibility modules from earlier releases, such as gem.reader, gem.models, gem.map_context, and gem.replay_fetch, have been removed. Use the canonical grouped modules documented below.

Core parsing modules

ModuleContents
BitReaderLow-level bit/byte/varint reader
DemoStreamOuter message stream iterator
Send TablesSerializer tree — parse_send_tables, Serializer, Field
Field DecodersType → decoder dispatch, QuantizedFloatDecoder
Field PathsHuffman field path decoder, FieldPath
String TablesTable creation, updates, key-history decoder
EntitiesEntity lifecycle, EntityOp, typed field accessors
Game EventsGame event schema registration and typed dispatch
Combat LogCombat log entry decoding and dispatch
ReplayParserTop-level parse driver — wires all subsystems

Output and extraction

ModuleContents
Public APIparse(), find_player(), JSON, DataFrame, and Parquet helpers
ModelsParsedMatch, ParsedPlayer, output dataclasses
CatalogGrouped hero, item, ability, league, XP, and map-data lookups
ConstantsCompatibility facade for hero_display(), item_display(), name lookups
Analysis HelpersSpatial, combat, vision, map-context, and Roshan conversion helpers
ReportsSelf-contained HTML report generation from ParsedMatch
Results AssemblyAssembles extractor output into ParsedMatch
Combat AggregatorPer-player combat stat aggregation
DataFramesparse_to_dataframe(), to_parquet(), to_json(), to_dict() — export to pandas, Parquet, or JSON
Batchparse_many(), parse_many_to_dataframe(), parse_many_to_parquet() — parallel multi-replay processing

Extractors

ModuleContents
OverviewHow extractors attach to the parser
PlayersHero/player snapshots, time series, runes
ObjectivesTowers, barracks, Roshan
WardsWard placements with coordinates
CourierCourier state per tick
DraftPick and ban events
LaneLane role from the 10-minute position heatmap
TeamfightsTeamfight window detection

Reference data

PageContents
Reference Values (Enums)Team, game-mode, lobby-type, and other integer-code tables