<commit_before>Eliot: Logging as Storytelling
==============================

Eliot provides a structured logging system for Python that generates as a forest
of nested actions. Action start and eventually finish, successfully or not. Log
messages thus tell a story: what happened, and what caused it.

Features:

* Structured, typed messages.
* Action tree, with messages automatically figuring out their action context.
* Excellent support for unit testing your logging code.
* Twisted support.
* JSON output, usable by Logstash/Elasticsearch.
* Supports Python 2.7 and 3.3.

This is a **PREVIEW** and does not guarantee version stability across versions.

Eliot is released by `HybridCluster`_ under the Apache 2.0 License
and maintained by <NAME>.

Downloads are available on `PyPI`_.

Documentation can be found on `Read The Docs`_.

Bugs and feature requests should be filed at the project `Github page`_.

.. _Read the Docs: https://eliot.readthedocs.org/
.. _Github page: https://github.com/hybridcluster/eliot
.. _PyPI: https://pypi.python.org/pypi/eliot
.. _HybridCluster: http://www.hybridcluster.com

.. image:: https://travis-ci.org/hybridcluster/eliot.png?branch=master
           :target: http://travis-ci.org/hybridcluster/eliot
           :alt: Build Status
<commit_msg>Various small improvements to the README.<commit_after>Eliot: Logging as Storytelling
==============================

Eliot provides a structured logging and tracing system for Python that generates log messages describing a forest of nested actions.
Actions start and eventually finish, successfully or not.
Log messages thus tell a story: what happened and what caused it.

Features:

* Structured, typed log messages.
* Ability to log actions, not just point-in-time information: log messages become a trace of program execution.
* Excellent support for unit testing your logging code.
* Emphasis on performance, including no blocking I/O in logging code path.
* Optional Twisted support.
* Designed for JSON output, usable by Logstash/Elasticsearch.
* Supports CPython 2.7, 3.3 and PyPy.

This is a **PREVIEW** and does not guarantee version stability across versions.

Eliot is released by `HybridCluster`_ under the Apache 2.0 License
and maintained by <NAME>.

Downloads are available on `PyPI`_.

Documentation can be found on `Read The Docs`_.

Bugs and feature requests should be filed at the project `Github page`_.

.. _Read the Docs: https://eliot.readthedocs.org/
.. _Github page: https://github.com/hybridcluster/eliot
.. _PyPI: https://pypi.python.org/pypi/eliot
.. _HybridCluster: http://www.hybridcluster.com

.. image:: https://travis-ci.org/hybridcluster/eliot.png?branch=master
           :target: http://travis-ci.org/hybridcluster/eliot
           :alt: Build Status

{'fraction_non_alphanumeric': 0.10370903853078862, 'fraction_numerical': 0.004321209938782859, 'mean_word_length': 4.202247191011236, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 8, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1289956', 'n_tokens_mistral': 795, 'n_tokens_neox': 767, 'n_words': 317}