[![Donate via PayPal][donate-image]][donate-link]
[![Build][github-ci-image]][github-ci-link]
[![Coverage Status][codecov-image]][codecov-link]
[![PyPI Version][pypi-image]][pypi-link]
[![PyPI Downloads][pypi-down]][pypi-link]
[![PyPI - Python Version][python-image]][pypi-link]
![License][license-image-mit]
# ColorAide
## Overview
ColorAide is a pure Python, object oriented approach to colors.
```python
>>> 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 particularly has a focus on the following:
- Accurate colors.
- Proper round tripping (where reasonable).
- Be generally easy to pick up for the average user.
- Support modern CSS color spaces and syntax.
- Make accessible many new and old non-CSS color spaces.
- Provide a number of useful utilities such as interpolation, color distancing, blending, gamut mapping, filters,
correlated color temperature, color vision deficiency simulation, etc.
- Provide a plugin API to extend supported color spaces and approaches to various utilities.
- 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
[github-ci-image]: https://github.com/facelessuser/coloraide/workflows/build/badge.svg?branch=main&event=push
[github-ci-link]: https://github.com/facelessuser/coloraide/actions?query=workflow%3Abuild+branch%3Amain
[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/coloraide/main.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333
[codecov-link]: https://codecov.io/github/facelessuser/coloraide
[pypi-image]: https://img.shields.io/pypi/v/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
[pypi-down]: https://img.shields.io/pypi/dm/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
[pypi-link]: https://pypi.python.org/pypi/coloraide
[python-image]: https://img.shields.io/pypi/pyversions/coloraide?logo=python&logoColor=aaaaaa&labelColor=333333
[license-image-mit]: https://img.shields.io/badge/license-MIT-blue.svg?labelColor=333333
[donate-image]: https://img.shields.io/badge/Donate-PayPal-3fabd1?logo=paypal
[donate-link]: https://www.paypal.me/facelessuser
Raw data
{
"_id": null,
"home_page": null,
"name": "coloraide",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "color, color-contrast, color-conversion, color-difference, color-filters, color-harmonies, color-interpolation, color-manipulation, color-spaces, color-temperature, color-vision-deficiency, colour, css",
"author": null,
"author_email": "Isaac Muse <Isaac.Muse@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c0/36/d8873c713d24228376565bc3c88b3ed3f54439c38c981bb80b51a4931803/coloraide-4.0.tar.gz",
"platform": null,
"description": "[![Donate via PayPal][donate-image]][donate-link]\n[![Build][github-ci-image]][github-ci-link]\n[![Coverage Status][codecov-image]][codecov-link]\n[![PyPI Version][pypi-image]][pypi-link]\n[![PyPI Downloads][pypi-down]][pypi-link]\n[![PyPI - Python Version][python-image]][pypi-link]\n![License][license-image-mit]\n\n# ColorAide\n\n## Overview\n\nColorAide is a pure Python, object oriented approach to colors.\n\n```python\n>>> from coloraide import Color\n>>> c = Color(\"red\")\n>>> c.to_string()\n'rgb(255 0 0)'\n>>> c.convert('hsl').to_string()\n'hsl(0 100% 50%)'\n>>> c.set(\"lch.chroma\", 30).to_string()\n'rgb(173.81 114.29 97.218)'\n>>> Color(\"blue\").mix(\"yellow\", space=\"lch\").to_string()\n'rgb(255 65.751 107.47)'\n```\n\nColorAide particularly has a focus on the following:\n\n- Accurate colors.\n\n- Proper round tripping (where reasonable).\n\n- Be generally easy to pick up for the average user.\n\n- Support modern CSS color spaces and syntax.\n\n- Make accessible many new and old non-CSS color spaces.\n\n- Provide a number of useful utilities such as interpolation, color distancing, blending, gamut mapping, filters,\n correlated color temperature, color vision deficiency simulation, etc.\n\n- Provide a plugin API to extend supported color spaces and approaches to various utilities.\n\n- Allow users to configure defaults to their liking.\n\nWith ColorAide, you can specify a color, convert it to other color spaces, mix it with other colors, output it in\ndifferent CSS formats, and much more!\n\n# Documentation\n\nhttps://facelessuser.github.io/coloraide\n\n## License\n\nMIT\n\n[github-ci-image]: https://github.com/facelessuser/coloraide/workflows/build/badge.svg?branch=main&event=push\n[github-ci-link]: https://github.com/facelessuser/coloraide/actions?query=workflow%3Abuild+branch%3Amain\n[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/coloraide/main.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333\n[codecov-link]: https://codecov.io/github/facelessuser/coloraide\n[pypi-image]: https://img.shields.io/pypi/v/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333\n[pypi-down]: https://img.shields.io/pypi/dm/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333\n[pypi-link]: https://pypi.python.org/pypi/coloraide\n[python-image]: https://img.shields.io/pypi/pyversions/coloraide?logo=python&logoColor=aaaaaa&labelColor=333333\n[license-image-mit]: https://img.shields.io/badge/license-MIT-blue.svg?labelColor=333333\n[donate-image]: https://img.shields.io/badge/Donate-PayPal-3fabd1?logo=paypal\n[donate-link]: https://www.paypal.me/facelessuser\n",
"bugtrack_url": null,
"license": null,
"summary": "A color library for Python.",
"version": "4.0",
"project_urls": {
"Homepage": "https://github.com/facelessuser/coloraide"
},
"split_keywords": [
"color",
" color-contrast",
" color-conversion",
" color-difference",
" color-filters",
" color-harmonies",
" color-interpolation",
" color-manipulation",
" color-spaces",
" color-temperature",
" color-vision-deficiency",
" colour",
" css"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d45d9a5ba2a2ecbea5e57a29710a7ad760141ade58637a11311c44c4e98ed313",
"md5": "e613774408eecb94c0b2c03359c7e7a0",
"sha256": "9de6c0fb352ff66413010b10adb539b623addca54c6fae95862dd9af36968c84"
},
"downloads": -1,
"filename": "coloraide-4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e613774408eecb94c0b2c03359c7e7a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 237698,
"upload_time": "2024-09-23T18:28:20",
"upload_time_iso_8601": "2024-09-23T18:28:20.733480Z",
"url": "https://files.pythonhosted.org/packages/d4/5d/9a5ba2a2ecbea5e57a29710a7ad760141ade58637a11311c44c4e98ed313/coloraide-4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c036d8873c713d24228376565bc3c88b3ed3f54439c38c981bb80b51a4931803",
"md5": "b36d39b9551e2e3555ddf6812acdefbd",
"sha256": "13efcc3dc3da716b7fd5aaf6e71d9259bb064b10a74888be2a56b6fc49c5e238"
},
"downloads": -1,
"filename": "coloraide-4.0.tar.gz",
"has_sig": false,
"md5_digest": "b36d39b9551e2e3555ddf6812acdefbd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 21463697,
"upload_time": "2024-09-23T18:28:22",
"upload_time_iso_8601": "2024-09-23T18:28:22.736186Z",
"url": "https://files.pythonhosted.org/packages/c0/36/d8873c713d24228376565bc3c88b3ed3f54439c38c981bb80b51a4931803/coloraide-4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-23 18:28:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "facelessuser",
"github_project": "coloraide",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "coloraide"
}