This is a single module package that contains everything that is needed to read in the Warcraft 3 replay file format *.w3g. W3G is a custom binary format. The benefits of this are that the files are small, even for very long games. The downside is that for them to be meaningfully a lot of extra data needs to be provided (as is done here for you) for these files to be meaningfully deciphered.

The replays basically amount to a bunch of metadata (map, players, etc) and a big event list. The file parser here provides you with access to this data as well as some post-processed metrics, such as actions-per-minute (APM).

The API should be easy to use and figure out. Classes and attributes are named in a sane way. Here is an example of usage:

import w3g
f = w3g.File('replay.w3g')

winner = f.winner()
print(winner)

f.print_apm()

You can also use this file in script mode to print out the entire game and its stats:

$ ./w3g.py  replay.w3g

If you have any questions or issues, please email me or leave an issue on the issue tracker.

/scopzout