Colouredlogs

---------------------------

Enable runtime patching of ``sys.stderr`` (related to `30`_ and `31`_).

.. _Release 6.2: https://github.com/xolox/python-coloredlogs/compare/6.1...6.2
.. _30: https://github.com/xolox/python-coloredlogs/issues/30
.. _31: https://github.com/xolox/python-coloredlogs/pull/31

---------------------------

- Bug fix: Adjust logger level in ``set_level()``, ``increase_verbosity()``, etc. (this is a follow up to release 6.0).
- Bug fix: Never enable system logging on Windows.
- Increase test coverage (using mocking).
- Document Python 3.6 support.

.. _Release 6.1: https://github.com/xolox/python-coloredlogs/compare/6.0...6.1

---------------------------

Two backwards incompatible changes were made:

- Changed log level handling in ``colouredlogs.install()``.
- Changed the default system logging level from ``DEBUG`` to ``INFO``. To make
it easier to restore the old behavior, ``colouredlogs.install(syslog='debug')``
is now supported.

The old and problematic behavior was as follows:

- ``colouredlogs.install()`` would unconditionally change the log level of the
root logger to ``logging.NOTSET`` (changing it from the root logger's default
level ``logging.WARNING``) and the log levels of handler(s) would control
which log messages were actually emitted.

- ``enable_system_logging()`` would never change the root logger's log level,
which meant that when ``enable_system_logging()`` was used in isolation from
``install()`` the default log level would implicitly be set to
``logging.WARNING`` (the default log level of the root logger).

Over the years I've gotten a lot of feedback about the log level handling in
the colouredlogs package, it was clearly the number one cause of confusion for
users. Here are some examples:

- https://github.com/xolox/python-coloredlogs/issues/14
- https://github.com/xolox/python-coloredlogs/issues/18
- https://github.com/xolox/python-coloredlogs/pull/21
- https://github.com/xolox/python-coloredlogs/pull/23
- https://github.com/xolox/python-coloredlogs/issues/24

My hope is that with the changes I've made in the past days, the experience for
new users will be more 'Do What I Mean' and less 'What The Fuck is Going On
Here?!' :-). Of course only time (and feedback, or lack thereof) will tell
whether I've succeeded.

.. _Release 6.0: https://github.com/xolox/python-coloredlogs/compare/5.2...6.0

---------------------------

Merged pull request `19`_: Automatically call ``colouredlogs.install()`` if
``COLOUREDLOGS_AUTO_INSTALL=true``.

While merging this pull request and writing tests for it I changed
the implementation quite a bit from the original pull request:

- The environment variable was renamed from ``COLOUREDLOGS_AUTOUSE`` to
``COLOUREDLOGS_AUTO_INSTALL`` (in order to make it consistent with the other
environment variables) and added to the documentation.

- The ``colouredlogs.pth`` file was changed in order to reduce the amount of
code required inside the ``*.pth`` file as much as possible and create room
to grow this feature if required, by extending ``auto_install()``. I
seriously dislike writing out complex code in a single line, especially when
dealing with Python code :-).

- The ``colouredlogs.pth`` file has been added to ``MANIFEST.in`` to make sure
that ``python setup.py sdist`` copies the ``*.pth`` file into the source
distribution archives published to PyPI.

- The ``setup.py`` script was changed to figure out the location of the
``lib/pythonX.Y/site-packages`` directory using distutils instead of 'hard
coding' the site-packages name (which I dislike for various reasons).

- The ``setup.py`` script was changed to preserve compatibility with universal
wheel distributions using what looks like an undocumented hack found through
trial and error (the other hacks I found were much worse :-). I ran into this
incompatibility when running the tests under ``tox``, which runs ``pip
install`` under the hood, which in turn runs ``python setup.py bdist_wheel``
under the hood to enable wheel caching.

.. _Release 5.2: https://github.com/xolox/python-coloredlogs/compare/5.1.1...5.2
.. _19: https://github.com/xolox/python-coloredlogs/pull/19

-----------------------------

- Starting from this release wheel distributions are published to PyPI.
- Refactored makefile and setup script (checkers, docs, wheels, twine, etc).
- Replaced ``colouredlogs.readthedocs.org`` with ``colouredlogs.readthedocs.io`` everywhere.

.. _Release 5.1.1: https://github.com/xolox/python-coloredlogs/compare/5.1...5.1.1

---------------------------

- Bug fix: Enable command capturing on MacOS (fixes `12`_).
- Add styles for the ``SPAM`` and ``NOTICE`` levels added by my verboselogs_ package.
- Set up automated MacOS tests on Travis CI.
- Documented Python 3.5 support.

.. _Release 5.1: https://github.com/xolox/python-coloredlogs/compare/5.0...5.1
.. _12: https://github.com/xolox/python-coloredlogs/issues/12