Coloredlogs

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

Bug fix: Restore MacOS compatibility after publishing release 9.3.

The following build failure became apparent to me just minutes after
publishing release 9.3 so I decided to change the implementation:
https://travis-ci.org/xolox/python-coloredlogs/jobs/372806733

.. _Release 9.3.1: https://github.com/xolox/python-coloredlogs/compare/9.3...9.3.1

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

Enable flexible millisecond formatting using the ``%f`` directive (`45`_).

.. _Release 9.3: https://github.com/xolox/python-coloredlogs/compare/9.2...9.3
.. _45: https://github.com/xolox/python-coloredlogs/issues/45

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

- Merged pull request `47`_: Switch to ``logging.getLogRecordFactory()``. In
the merge commit I added a small performance enhancement by checking for the
existence of ``logging.getLogRecordFactory()`` just once, when a
``ColoredFormatter`` object is instantiated.

- Merged pull request `52`_: Don't change whitespace in format strings. In the
merge commit I promoted the inline function to an instance method so that it
can be reused by sub classes of ``ColoredFormatter``.

.. _Release 9.2: https://github.com/xolox/python-coloredlogs/compare/9.1...9.2
.. _47: https://github.com/xolox/python-coloredlogs/pull/47
.. _52: https://github.com/xolox/python-coloredlogs/pull/52

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

- Added ``license`` key to ``setup.py`` script (`53`_).
- Added this changelog (requested in `55`_).

.. _Release 9.1: https://github.com/xolox/python-coloredlogs/compare/9.0...9.1
.. _53: https://github.com/xolox/python-coloredlogs/pull/53
.. _55: https://github.com/xolox/python-coloredlogs/issues/55

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

Added support for background colors and 256 color mode (`35`_).

Most of the changes required for this were actually implemented in the
humanfriendly_ package (see issue `35`_). The changes in coloredlogs
are mostly related to the ANSI to HTML conversion.

One unrelated change was made, that was to use faint green for the ``SPAM`` log
level (to distinguish it from ``DEBUG``).

New features in ANSI to HTML conversion:

- Support for bright and faint colors.
- Support for underlined, strike-through and inverse text styles.

Bug fixes in ANSI to HTML conversion:

- The scheme of URLs is no longer stripped from visible output.
- Support for ``\x1b[m`` as a short hand for ``\x1b[0m`` (I only learned about
this today when I didn't understand the empty ANSI escape sequence at the end
of each line emitted by ``hg log``).
- Ensure that the pattern for URLs doesn't capture ANSI sequences.

- Documenting how it all works. This will follow in the next commit
which is going to be a rather big one (hence why I see some value
in keeping it separate from the implementation changes).

Miscellaneous changes:

- Add installation instructions to readme.
- Improve screenshots in documentation.
- Automate taking of screen shots :-).

.. _Release 9.0: https://github.com/xolox/python-coloredlogs/compare/8.0...9.0
.. _35: https://github.com/xolox/python-coloredlogs/issues/35
.. _humanfriendly: https://humanfriendly.readthedocs.io/

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

Set the default date format in a new ``formatTime()`` method (`42`_).

I decided to bump the major version number because this change is technically
backwards incompatible, even though it concerns a minor detail (``datefmt``
being set to its default value in the initializer). Then again, this change
does improve compatibility with the behavior of the ``logging.Formatter`` class
in Python's standard library, so there's that :-).

.. _Release 8.0: https://github.com/xolox/python-coloredlogs/compare/7.3.3...8.0
.. _42: https://github.com/xolox/python-coloredlogs/pull/42