Metadata-Version: 2.1
Name: syslogmp
Version: 0.3
Summary: A parser for BSD syslog protocol (RFC 3164) messages
Home-page: https://homework.nwsnet.de/releases/76d6/#syslogmp
Author: Jochen Kupperschmidt
Author-email: homework@nwsnet.de
License: MIT
Keywords: irc,webhook
Platform: any
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.6

syslogmp
========

A parser for BSD syslog protocol (RFC 3164) messages

This library was extracted from syslog2IRC_.


Requirements
------------

- Python 3.6+


Installation
------------

Install this package via pip_:

.. code:: sh

    $ pip install syslogmp


Usage
-----

To parse a syslog message:

.. code:: python

    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.


.. _syslog2IRC: http://homework.nwsnet.de/releases/c474/#syslog2irc
.. _pip:        http://www.pip-installer.org/
.. _RFC 3164:   http://tools.ietf.org/html/rfc3164
.. _RFC 5424:   http://tools.ietf.org/html/rfc5424


:Copyright: 2007-2021 Jochen Kupperschmidt
:License: MIT, see LICENSE for details.

syslogmp Changelog
==================


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 depedency 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


