Metadata-Version: 1.2
Name: syslogmp
Version: 0.4
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
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_:
        
        .. 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.
        
        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
        
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.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.7
