Skip to main content

A color library for CSS colors.

Project description

Donate via PayPal Discord Build Coverage Status PyPI Version PyPI Downloads PyPI - Python Version License

ColorAide

This is still a work in progress.

While ColorAide is very usable and out of the alpha stage, it is currently in a prerelease > state. This simply means the API could still be in flux to some degree. ColorAide is still technically waiting for > some issues related to CSS color syntax and behavior to be decided by the CSS Working Group.

Overview

ColorAide is a color library for Python with the intent of providing an easy to use interface to work with colors.

>>> from coloraide import Color
>>> c = Color("red")
>>> c.to_string()
'rgb(255 0 0)'
>>> c.convert('hsl').to_string()
'hsl(0 100% 50%)'
>>> c.set("lch.chroma", 30).to_string()
'rgb(173.81 114.29 97.218)'
>>> Color("blue").mix("yellow", space="lch").to_string()
'rgb(255 65.751 107.47)'

ColorAide is a continually evolving project, but was created with a number of specific goals in mind:

  • Be generally easy to pick up for the average user.

  • Support modern CSS color spaces and syntax as well as a number of popular non-CSS color spaces.

  • Provide a plugin API to extend color spaces and more.

  • Provide a number of useful utilities such as interpolation, color distancing, blending, gamut mapping, etc.

  • Allow users to configure defaults to their liking.

With ColorAide, you can specify a color, convert it to other color spaces, mix it with other colors, output it in different CSS formats, and much more!

Documentation

https://facelessuser.github.io/coloraide

License

MIT

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coloraide-0.14.0.tar.gz (8.3 MB view hashes)

Uploaded Source

Built Distribution

coloraide-0.14.0-py3-none-any.whl (95.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page