syslogmp 0.4

A parser for BSD syslog protocol (RFC 3164) messages

syslogmp

A parser for BSD syslog protocol (RFC 3164) messages

This library was extracted from syslog2IRC.

Requirements

• Python 3.7+

Installation

Install this package via pip:

$ pip install syslogmp

Usage

To parse a syslog message:

from syslogmp import parse

# Parse data (usually received via network).
message = parse(data)

# Let's see what we've got here.
print(message.facility)
print(message.facility.description)
print(message.severity)
print(message.timestamp)
print(message.hostname)
print(message.message)

Further Reading

For more information, see RFC 3164, “The BSD syslog Protocol”.

Please note that there is RFC 5424, “The Syslog Protocol”, which obsoletes RFC 3164. This package, however, only implements the latter.

Copyright:

2007-2021 Jochen Kupperschmidt

License:

MIT, see LICENSE for details.

Changelog

Version 0.4

Released 2021-04-04

• Removed support for Python versions 3.6.

• Turn namedtuples Message and PriorityValue into dataclasses.

• Added type hints.

Version 0.3

Released 2021-03-03

• Removed support for end-of-life Python versions 2.7, 3.3, 3.4, and 3.5.

• Added support for Python 3.6, 3.7, 3.8, and 3.9.

Version 0.2.2

Released 2016-03-01

• Fixed datetime.strptime failing on February 29th. (Tests introduce a test dependency on FreezeGun).

Version 0.2.1

Released 2015-09-08

• Added missing files to distribution.

Version 0.2

Released 2015-09-07

• Data is required to be a byte string.

• Raise custom exception on message parsing errors instead of using assertions.

• Raise exception if message is too long instead of truncating and processing it.

Version 0.1.1

Released 2015-08-10

• Fixed packaging issue.

Version 0.1

Released 2015-08-10

• first official release