This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Parse events from log produced by IL-2 FB Dedicated Server

Project Description

L10N state:

Table of contents


This is a Python library which parses events from log file produced by IL-2 FB Dedicated Server. Resulting information about events is stored in special data structures.


You may see this library in action even if you do not understand its purpose.

All you need is just to visit project’s demo page.

That page allows you to test parser’s ability to process some string. If you do not know what to enter to the text area, you may Insert test data and parse it.

If something goes wrong, you will be prompted to confirm automatic creation of bug report which will be listed on this page.

Known events

This library supports the vast majority of events produced by dedicated server.

To see their list, go to the demo page and click See the list of supported events link.

You may find definitions of datastructures here and you may explore their internals here.


Get it from PyPI:

pip install il2fb-events-parser


Basic usage

If you need to be able to parse all events this library knows about, use parse_string():

from import parse_string
event = parse_string("[8:33:05 PM] User0 has connected")
# <Event 'HumanHasConnected'>
# datetime.time(20, 33, 5)
# 'User0'
import pprint
# {'callsign': 'User0',
#  'name': 'HumanHasConnected',
#  'time': '20:33:05',
#  'verbose_name': u'Human has connected'}

Possible exceptions

Certain errors may be raised if you will try to parse unknown event or known event with invalid data:

parse_string("foo bar")
# Traceback (most recent call last):
# ...
# EventParsingError: No grammar was found for string "foo bar"
parse_string("[99:99:99 PM] Mission BEGIN")
# Traceback (most recent call last):
# ...
# ValueError: time data '99:99:99 PM' does not match format '%I:%M:%S %p'

Current list of supported events is rather full, but EventParsingError is quite possible, because server’s events are undocumented and this library may do not know all of them.

In case you need to catch this error, its full name is

Other errors such as ValueError are quite impossible if you are parsing log created by dedicated server.

Safe usage

You may use parse_string_safely() if you don’t care about any exceptions:

from import parse_string_safely
event = parse_string_safely("foo bar")
event is None
# True

Any error (except SystemExit and KeyboardInterrupt) will be muted and None will be returned.


Each event has own grammar rule for parsing strings. Each rule increases max time of parsing of a single string.

For example, this time equals to ~10 ms for Python 2.7.8 running under Linux kernel 3.13 on Intel® Core™ i3-2120. Therefore, in the worst case you will be able to parse 100 events per second.

This may not be an issue for you, but if it is, you may skip some events to speed up parsing process.

Explicitly tell which events you are interested in

You may explicitly tell which events you are interested in, if you are not interested in the vast majority of events supported by this library.

To do so, you will need to use InclusiveEventsParser:

from import InclusiveEventsParser
from import HumanHasConnected, HumanHasSelectedAirfield
parser = InclusiveEventsParser([
    HumanHasConnected, HumanHasSelectedAirfield,
parser.parse_string("[8:33:05 PM] User0 has connected")
# <Event 'HumanHasConnected'>
parser.parse_string("[8:33:05 PM] User0 selected army Red at 100.0 200.99")
# <Event 'HumanHasSelectedAirfield'>
parser.parse_string("[8:33:05 PM] User0 has disconnected")
# None

Here, parse_string() method of our parser will work same way as parse_string_safely() function.

Explicitly tell which events you are NOT interested in

If you are not interested only in some events, you can exclude them using ExclusiveEventsParser:

from import ExclusiveEventsParser
from import (
    TreeWasDestroyed, TreeWasDestroyedByAIAircraft,
    TreeWasDestroyedByHumanAircraft, TreeWasDestroyedByStatic,
parser = ExclusiveEventsParser([
    TreeWasDestroyed, TreeWasDestroyedByAIAircraft,
    TreeWasDestroyedByHumanAircraft, TreeWasDestroyedByStatic,
parser.parse_string("[8:33:05 PM] User0 has connected")
# <Event 'HumanHasConnected'>
parser.parse_string("[8:33:05 PM] 3do/Tree/Line_W/live.sim destroyed by User0:Pe-8 at 100.0 200.99")
# None

Just like in case of InclusiveEventsParser, parse_string() will work same way as parse_string_safely() function.

Ideas for future

Another way to speed up parsing is to use LRU cache for grammar rules.

Here, the key idea is that some types of events usually may come in sequence during game flow. For example, user destroys a group of objects with bombs, user changes seat in his aircraft rapidly, the whole crew bails out, etc.

It seems to be OK to use collections.deque to implement cache for such situations.

The problem is that we need to preserve order of rules for events of similar types. To do so, first of all, we need to group all existing rules. Then we will need combine a group of rules into a single rule. This must be done during instantiation of parser, because list of events we are interested in may vary (see InclusiveEventsParser and ExclusiveEventsParser).

This idea seems to be nice and useful, but maybe it’s just a premature optimization.

Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
il2fb-events-parser-0.11.0.tar.gz (25.1 kB) Copy SHA256 Checksum SHA256 Source Jan 17, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting