Skip to main content

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.

Source Distribution

syslogmp-0.4.tar.gz (8.2 kB view hashes)

Uploaded source

Built Distribution

syslogmp-0.4-py3-none-any.whl (7.9 kB view hashes)

Uploaded py3

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 NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page