https://github.com/ubernostrum/webcolors

A library for working with HTML/CSS color formats in Python.
https://github.com/ubernostrum/webcolors

colors css html python

Last synced: 2 days ago
JSON representation

A library for working with HTML/CSS color formats in Python.

• Host: GitHub
• URL: https://github.com/ubernostrum/webcolors
• Owner: ubernostrum
• License: bsd-3-clause
• Created: 2013-09-11T06:45:17.000Z (over 11 years ago)
• Default Branch: trunk
• Last Pushed: 2024-11-11T07:43:13.000Z (3 months ago)
• Last Synced: 2025-01-25T23:02:01.062Z (7 days ago)
• Topics: colors, css, html, python
• Language: Python
• Homepage: https://webcolors.readthedocs.io/
• Size: 509 KB
• Stars: 160
• Watchers: 6
• Forks: 27
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
.. -*-restructuredtext-*-

.. image:: https://github.com/ubernostrum/webcolors/workflows/CI/badge.svg

   :alt: CI status image

   :target: https://github.com/ubernostrum/webcolors/actions?query=workflow%3ACI

``webcolors`` is a module for working with and converting between the

various HTML/CSS color formats.

Support is included for normalizing and converting between the

following formats (RGB colorspace only; conversion to/from HSL can be

handled by the ``colorsys`` module in the Python standard library):

* Specification-defined color names

* Six-digit hexadecimal

* Three-digit hexadecimal

* Integer ``rgb()`` triplet

* Percentage ``rgb()`` triplet

For example:

.. code-block:: python

    >>> import webcolors

    >>> webcolors.hex_to_name("#daa520")

    'goldenrod'

Implementations are also provided for the HTML5 color parsing and

serialization algorithms. For example, parsing the infamous

"chucknorris" string into an ``rgb()`` triplet:

.. code-block:: python

    >>> import webcolors

    >>> webcolors.html5_parse_legacy_color("chucknorris")

    HTML5SimpleColor(red=192, green=0, blue=0)

Full documentation is `available online `_.