Humanfriendly

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

**Noteworthy changes:**

- Merged pull request `45`_ to resolve the issue caused by the conditional
:pypi:`pyreadline` requirement on Windows not supporting Python 3.9+.

- Updated the readme to use Python 3 in the example (reported in issue `56`_).
Also added a mention of the ``humanfriendly --demo`` command.

- Removed the ``humanfriendly.compat.unittest`` alias that presumably no-one is
using at this point; it had been rendered useless quite a long time ago
(requested in issue `53`_).

**Internal changes:**

- Merged pull request `54`_ which migrates the :pypi:`humanfriendly` project
from Travis CI to GitHub Actions and from Coveralls.io to Codecov.

- Fixed a deprecation warning concerning ``setup.cfg`` and some Sphinx
documentation errors.

.. _Release 10.0: https://github.com/xolox/python-humanfriendly/compare/9.2...10.0
.. _45: https://github.com/xolox/python-humanfriendly/pull/45
.. _53: https://github.com/xolox/python-humanfriendly/issues/53
.. _54: https://github.com/xolox/python-humanfriendly/pull/54
.. _56: https://github.com/xolox/python-humanfriendly/issues/56

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

Maintenance release:

- Merged pull request `46`_ which fixes several :pypi:`flake8` warnings.

- Merged pull request `49`_ which marks Python 3.9 support final.

- Merged pull request `51`_ which helps to stabilize the test suite.

- Merged pull request `52`_ which updates the :mod:`humanfriendly.sphinx`
module to include Sphinx extension metadata that has become mandatory in a
recent Sphinx release. After merging the pull request I added additional
metadata including the version.

.. _Release 9.2: https://github.com/xolox/python-humanfriendly/compare/9.1...9.2
.. _46: https://github.com/xolox/python-humanfriendly/pull/46
.. _49: https://github.com/xolox/python-humanfriendly/pull/49
.. _51: https://github.com/xolox/python-humanfriendly/pull/51
.. _52: https://github.com/xolox/python-humanfriendly/pull/52

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

Added :func:`~humanfriendly.compat.on_macos()` function to detect Apple MacOS
(I need this in an upcoming :pypi:`coloredlogs` release and don't want to have
to think about how to detect MacOS again in the future 😇).

.. _Release 9.1: https://github.com/xolox/python-humanfriendly/compare/9.0...9.1

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

The major version number was bumped because the bug fix for
:func:`~humanfriendly.text.pluralize()` is backwards incompatible
and (even though this seems like very "cosmetic" functionality)
version numbers are cheap, so who cares 😉.

**Bug fixes:**

- Changed :func:`~humanfriendly.format_number()` to properly support negative
numbers (as suggested in `issue 40`_).

- Changed :func:`~humanfriendly.text.pluralize()` to generate "1.5 seconds"
instead of "1.5 second" (as suggested in `issue 43`_).

**Enhancements:**

- Enhanced :func:`~humanfriendly.text.concatenate()` to support ``conjunction``
and ``serial_comma`` keyword arguments (as suggested in `issue 30`_).

- Added :func:`~humanfriendly.text.pluralize_raw()` to select singular or
plural form without prefixing the count to the text that is returned.

.. _Release 9.0: https://github.com/xolox/python-humanfriendly/compare/8.2...9.0
.. _issue 30: https://github.com/xolox/python-humanfriendly/issues/30
.. _issue 40: https://github.com/xolox/python-humanfriendly/issues/40
.. _issue 43: https://github.com/xolox/python-humanfriendly/issues/43

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

Added a simple case insensitive dictionary implementation, for details refer to
the new :mod:`humanfriendly.case` module.

.. _Release 8.2: https://github.com/xolox/python-humanfriendly/compare/8.1...8.2

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

**Enhancements:**

- Make it possible to opt out of the output capturing that
:func:`humanfriendly.testing.run_cli()` sets up by default.

- Improve feature parity between :class:`humanfriendly.testing.CaptureOutput`
and my :pypi:`capturer` package to the point where most of the
:pypi:`humanfriendly` test suite can now run without :pypi:`capturer`.

**Internal changes:**

- Refactored the test suite to import all names separately instead of referring
to identifiers via their modules (my preferences have changed since this code
was written a long time ago).

.. _Release 8.1: https://github.com/xolox/python-humanfriendly/compare/8.0...8.1