A parser for BSD syslog protocol (RFC 3164) messages
Project description
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.