Metadata-Version: 2.1
Name: parser201
Version: 0.2.0
Summary: Extract individual fields from lines in Apache logs.
Home-page: https://github.com/geozeke/parser201
Author: Peter Nardi
Author-email: pete@nardi.com
License: MIT license
Keywords: parser201 apache log parse parser scanner web server
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Topic :: Education
Classifier: Topic :: Internet :: Log Analysis
Classifier: Topic :: Security
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Systems Administration
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE

=====
About
=====

.. BADGES_START
   
.. image:: https://img.shields.io/pypi/v/parser201.svg
      :target: https://pypi.python.org/pypi/parser201

.. image:: https://img.shields.io/github/v/tag/geozeke/parser201.svg
      :target: https://img.shields.io/github/v/tag/geozeke/parser201

.. image:: https://img.shields.io/travis/geozeke/parser201.svg
      :target: https://travis-ci.com/geozeke/parser201

.. image:: https://readthedocs.org/projects/parser201/badge/?version=latest
      :target: https://parser201.readthedocs.io/en/latest/?badge=latest
      :alt: Documentation Status
     
.. image:: https://img.shields.io/pypi/status/parser201.svg
      :target: https://img.shields.io/pypi/status/parser201
      
.. image:: https://img.shields.io/pypi/pyversions/parser201.svg
      :target: https://img.shields.io/pypi/pyversions/parser201

.. image:: https://img.shields.io/github/last-commit/geozeke/parser201.svg
      :target: https://img.shields.io/github/last-commit/geozeke/parser201

.. image:: https://img.shields.io/github/license/geozeke/parser201.svg
      :target: https://img.shields.io/github/license/geozeke/parser201
   
.. BADGES_END

Free software: MIT license

Features
--------

The centerpiece of the parser201 module is the ``LogParser`` class. The class initializer takes a line from an Apache log file and extracts the individual fields into properties within an object.

* Parses entries (lines) from Apache log files into objects with a separate property for each field in the log entry.
* Prints log objects as strings in a presentation format.

Documentation
-------------

https://parser201.readthedocs.io

Development Lead
----------------

Peter Nardi <pete@nardi.com>

Source Code
-----------

Available on github: parser201_.

.. _parser201: https://github.com/geozeke/parser201

Package Framework
-----------------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.0 (2021-10-31)
------------------

* Changed behavior to gracefully fail for any malformed input line. If an input line cannot be successfully parsed, all properties of the returned object are set to None and no messages are printed.
* Added additional pytest cases to verify failure behavior.

0.1.9 (2021-09-15)
------------------

* Code cleanup for pep8 compliance.
* Cleaned up Makefiles and scripts to remove references to python (meaning python2) and replace it with python3.

0.1.8 (2021-09-15)
------------------

* Internal build.

0.1.7 (2021-06-05)
------------------

* Re-tooled testing scripts to use parameterized test data, and conduct more robust testing.

0.1.6 (2020-12-19)
------------------

* Addressed exception handling for initializer input not being a valid string data type.
* Documentation cleanup.

0.1.5 (2020-10-26)
------------------

* Enabled automatic deployment of tagged releases to pypi from travis using encrypted token.
* Converted references to the ``master`` branch in the git repository to ``main`` across the documentation set.
* Documentation cleanup.

0.1.4 (2020-10-24)
------------------

* Initial pypi release.
* Fixed test file filtering issue in ``.gitignore``.
* Dependency fix for travis tests.

0.1.1 (2020-10-22)
------------------

* Follow-on testing on test.pypi.org.

0.1.0 (2020-10-18)
------------------

* Initial testing on test.pypi.org.


