Skip to main content

Python bindings for faf-replay-parser

Project description

FAF Replay Parser

Build Status pypi

A fast library for parsing Supreme Commander Forged Alliance replay files.

Installation

Currently, pre-built packages are only available for Linux. You can install them with:

pip install faf-replay-parser

Documentation

Here are some examples of using the parser. Check help(fafreplay) for more details on available functions.

Gathering basic info

For the most basic uses there are a few special functions that should be preferred over constructing a Parser object. These do only one job, but they do it very quickly.

Current functions:

  • body_offset - Used for splitting replay data into header and body.
  • body_ticks - Used for extracting the game length.

Example

from datetime import timedelta
from fafreplay import body_offset, body_ticks

# Split replay data into header and body
offset = body_offset(data)
header_data, body_data = data[:offset], data[offset:]

# Get replay length in ticks
ticks = body_ticks(body_data)
print("Game length:", timedelta(milliseconds=ticks*100))

Using the Parser object

The Parser object can be used to get fine grained control over how replay commands are parsed. Generally it's a good idea to parse only the minimum commands needed, as conversion back to python dictionaries is quite expensive.

from datetime import timedelta
from fafreplay import Parser, commands

parser = Parser(
    # Skip all commands except the ones defined here
    commands=[
        commands.Advance,                   # For the tick counter
        commands.VerifyChecksum,            # For desync detection
    ],
    # Throw away commands right after we parse them. Setting this to `True` will
    # significantly increase the parse time.
    save_commands=False,
    limit=None,
    stop_on_desync=False
)
# Or create a parser with default arguments (turn off save_commands though)
# parser = Parser(save_commands=False)

# Read replay to a `bytes` object
with open("12345.scfareplay", "rb") as f:
    data = f.read()

# Parse to a python dictionary. Data must of type `bytes` or `bytearray`
replay = parser.parse(data)
print("Game time:", timedelta(milliseconds=replay["body"]["sim"]["tick"]*100))
if replay["body"]["sim"]["desync_ticks"]:
    print("Replay desynced!")

Benchmark comparison

To see how much faster the basic functions can be, consider this simple example done on replay 6176549 (an almost 50 minute long Seton's game).

>>> len(body_data)
5586339
>>> body_ticks(body_data)
28917
>>> parser = Parser(
...     commands=[commands.Advance],
...     save_commands=False
... )
>>> timeit.timeit("parser.parse_body(body_data)['sim']['tick']", globals=globals(), number=100)
1.4510237049980788
>>> timeit.timeit("body_ticks(body_data)", globals=globals(), number=100)
0.20173147800232982

In this case body_ticks turned out to be more than 7x faster than using a Parser.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for faf-replay-parser, version 0.5.1.post0
Filename, size File type Python version Upload date Hashes
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-macosx_10_9_x86_64.whl (290.6 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-manylinux1_i686.whl (1.0 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-manylinux1_x86_64.whl (953.0 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-manylinux2010_i686.whl (1.0 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-manylinux2010_x86_64.whl (953.0 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-win32.whl (176.2 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp36-cp36m-win_amd64.whl (185.3 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-macosx_10_9_x86_64.whl (290.5 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-manylinux1_i686.whl (1.0 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-manylinux1_x86_64.whl (953.0 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-manylinux2010_i686.whl (1.0 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-manylinux2010_x86_64.whl (953.0 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-win32.whl (176.2 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp37-cp37m-win_amd64.whl (185.0 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-macosx_10_9_x86_64.whl (290.4 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-manylinux1_i686.whl (1.0 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-manylinux1_x86_64.whl (953.2 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-manylinux2010_i686.whl (1.0 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-manylinux2010_x86_64.whl (953.2 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-win32.whl (176.3 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp38-cp38-win_amd64.whl (184.7 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-macosx_10_9_x86_64.whl (290.4 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-manylinux1_i686.whl (1.0 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-manylinux1_x86_64.whl (953.1 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-manylinux2010_i686.whl (1.0 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-manylinux2010_x86_64.whl (953.1 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-win32.whl (176.0 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-cp39-cp39-win_amd64.whl (184.1 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp36-pypy36_pp73-macosx_10_9_x86_64.whl (290.8 kB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp36-pypy36_pp73-manylinux1_x86_64.whl (953.6 kB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp36-pypy36_pp73-manylinux2010_x86_64.whl (953.6 kB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp36-pypy36_pp73-win32.whl (176.9 kB) File type Wheel Python version pp36 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl (290.7 kB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp37-pypy37_pp73-manylinux1_x86_64.whl (953.5 kB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp37-pypy37_pp73-manylinux2010_x86_64.whl (953.5 kB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size faf_replay_parser-0.5.1.post0-pp37-pypy37_pp73-win32.whl (176.8 kB) File type Wheel Python version pp37 Upload date Hashes View
Filename, size faf-replay-parser-0.5.1.post0.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page