.. _changelog:


Change log
==========

This document lists the changes between each release of webcolors.


Version 1.13, released 2023-??-??
---------------------------------

No bug fixes or new features.

Other changes
~~~~~~~~~~~~~

* Supported Python versions are now 3.7, 3.8, 3.9, 3.10, and 3.11

* The codebase was significantly reorganized and modernized. Public API is
  unchanged. Imports should continue to be directly from the top-level
  ``webcolors`` module; attempting to import from submodules is not supported.

* Now packaging declaratively via ``pyproject.toml`` with `PEP 517
  <https://peps.python.org/pep-0517/>`_ support from ``setuptools``.


Version 1.12, released 2022-05-25
---------------------------------

No bug fixes or new features.

Other changes
~~~~~~~~~~~~~

* Supported Python versions are now 3.7, 3.8, 3.9, and 3.10.


Version 1.11.1, released 2020-02-17
-----------------------------------

Bugs fixed
~~~~~~~~~~

* Corrected an error regarding supported Python versions in the README file.


Version 1.11, released 2020-02-17
---------------------------------

No bug fixes or new features.

Other changes
~~~~~~~~~~~~~

* Python 2 has reached the end of its support cycle from the Python core team;
  accordingly, Python 2 support is dropped. Supported Python versions are now
  3.5, 3.6, 3.7, and 3.8.


Version 1.10, released 2019-09-08
---------------------------------

No bug fixes or new features.

Other changes
~~~~~~~~~~~~~

* Similar to the change in version 1.9 which normalized conversions to named
  colors for ``gray``/``grey`` to always use the ``gray`` variant, the other
  named grays of CSS3 now normalize to the ``gray`` spelling. This affects the
  following colors: ``darkgray``/``darkgrey``,
  ``darkslategray``/``darkslategrey``, ``dimgray``/``dimgrey``,
  ``lightgray``/``lightgrey``, ``lightslategray``/``lightslategrey``,
  ``slategray``/``slategrey``.


Version 1.9.1, released 2019-06-07
----------------------------------

Bugs fixed
~~~~~~~~~~

* The ``__version__`` attribute of the installed webcolors module, although not
  documented or referenced anywhere, was accidentally not updated in the 1.9
  release. It has now been updated (and now indicates 1.9.1).


Version 1.9, released 2019-06-01
--------------------------------

No bug fixes.

New features
~~~~~~~~~~~~

* Added :ref:`a set of constants to use when referring to specifications that
  define color names <spec-constants>`.

Other changes
~~~~~~~~~~~~~

* When asked to provide a color name, using the CSS3/SVG set of names, for the
  hexadecimal value ``#808080``, the integer triplet ``rgb(128, 128, 128)``, or
  the percentage triplet ``rgb(50%, 50%, 50%)``, webcolors now always returns
  ``u'gray'``, never ``u'grey'``. Previously, the behavior could be
  inconsistent as it depended on the Python version in use; ``u'gray'`` was
  picked because it was the spelling variant used in HTML 4, CSS1, and CSS2.


Version 1.8.1, released 2018-02-12
----------------------------------

The 1.8.1 release is a repackaging of 1.8 to produce both source (.tar.gz) and
binary (.whl) package formats, following reports that the source-package-only
release of 1.8 was causing installation issues for some users. See `issue 6 in
the repository <https://github.com/ubernostrum/webcolors/issues/6>`_ for
details.


Version 1.8, released 2018-02-08
--------------------------------

No bug fixes.

New features
~~~~~~~~~~~~

* Added the :class:`~webcolors.IntegerRGB`,
  :class:`~webcolors.PercentRGB`, and
  :class:`~webcolors.HTML5SimpleColor` named tuples.

Other changes
~~~~~~~~~~~~~

* Drop support for Python 3.3 (Python core team no longer maintains 3.3).

* Mark support for Python 3.6.

* :ref:`The full verification tests <full-verification>` now run correctly on
  Python 3.


Version 1.7, released 2016-11-25
--------------------------------

No new features or bugfixes.

Other changes
~~~~~~~~~~~~~

* Drop support for Python 2.6 (Python core team no longer maintains 2.6).

* Mark support for Python 3.4.

* On Python 3, the use of :class:`str` for all functions which take string
  arguments is now mandatory. Attempted use of :class:`bytes` will raise an
  exception. On Python 2, use of bytestrings is still permitted.


Version 1.5.1, released 2015-11-23
----------------------------------

No new features.

Bug fixes
~~~~~~~~~

* Corrected multiple typos in documentation.



Version 1.5, released 2015-03-07
--------------------------------

No bug fixes.


New features
~~~~~~~~~~~~

* Python 3 support: webcolors now supports Python 3.3.

* Added :ref:`HTML5 color algorithms <html5-algorithms>`.

Other changes
~~~~~~~~~~~~~

* Packaging improvements.


Version 1.4, released 2012-02-10
--------------------------------

No new features.

Bugs fixed
~~~~~~~~~~

* Integer and percentage ``rgb()`` triplets now normalized in accordance with
  CSS clipping rules.

Other changes
~~~~~~~~~~~~~

* Packaging fixes.

* Preparatory work for Python 3 support.


Version 1.3.1, released 2009-10-24
----------------------------------

No new features or bugfixes.

Other changes
~~~~~~~~~~~~~

* Documentation expanded.

* Documentation now maintained using `Sphinx <http://www.sphinx-doc.org/>`_.


Version 1.3, released 2009-05-08
--------------------------------

No new features or bugfixes.

Other changes
~~~~~~~~~~~~~

* Documentation expanded.


Version 1.2, 2009-03-01
-----------------------

Bugs fixed:
~~~~~~~~~~~

* Corrected the download URL in the ``setup.py`` script.


Version 1.1, released 2008-12-19
--------------------------------

No new features or bugfixes.

Other changes
~~~~~~~~~~~~~

* Documentation expanded.


Version 1.0, released 2008-10-28
--------------------------------

Initial stable release of webcolors.
