coloraide


Namecoloraide JSON
Version 2.10 PyPI version JSON
download
home_page
SummaryA color library for Python.
upload_time2023-09-12 13:27:47
maintainer
docs_urlNone
author
requires_python>=3.8
license
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
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            [![Donate via PayPal][donate-image]][donate-link]
[![Discord][discord-image]][discord-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=master&event=push
[github-ci-link]: https://github.com/facelessuser/coloraide/actions?query=workflow%3Abuild+branch%3Amaster
[discord-image]: https://img.shields.io/discord/678289859768745989?logo=discord&logoColor=aaaaaa&color=mediumpurple&labelColor=333333
[discord-link]:https://discord.gg/TWs8Tgr
[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/coloraide/master.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": "",
    "name": "coloraide",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "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": "",
    "author_email": "Isaac Muse <Isaac.Muse@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/44/46/6764916d964d3d2ec9d62ceb0942bccac2588bd98655007be660b4e809e6/coloraide-2.10.tar.gz",
    "platform": null,
    "description": "[![Donate via PayPal][donate-image]][donate-link]\n[![Discord][discord-image]][discord-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=master&event=push\n[github-ci-link]: https://github.com/facelessuser/coloraide/actions?query=workflow%3Abuild+branch%3Amaster\n[discord-image]: https://img.shields.io/discord/678289859768745989?logo=discord&logoColor=aaaaaa&color=mediumpurple&labelColor=333333\n[discord-link]:https://discord.gg/TWs8Tgr\n[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/coloraide/master.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": "",
    "summary": "A color library for Python.",
    "version": "2.10",
    "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": "1f88a88493d5354670b06cd5a6fa0e92a478aaf8d6fc6e510944fd8a487d4c19",
                "md5": "bb3f885d2ea0afec539eb8f95fa17f16",
                "sha256": "3d99ea936c73f061f22d5fc8bc2c3794ca1b319fbeb099a1aa3e3037f04319e3"
            },
            "downloads": -1,
            "filename": "coloraide-2.10-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb3f885d2ea0afec539eb8f95fa17f16",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 234533,
            "upload_time": "2023-09-12T13:27:45",
            "upload_time_iso_8601": "2023-09-12T13:27:45.545509Z",
            "url": "https://files.pythonhosted.org/packages/1f/88/a88493d5354670b06cd5a6fa0e92a478aaf8d6fc6e510944fd8a487d4c19/coloraide-2.10-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "44466764916d964d3d2ec9d62ceb0942bccac2588bd98655007be660b4e809e6",
                "md5": "e5d68268f25428f46eb172c9c0e4b8cb",
                "sha256": "88536ee1a59a27dde399705e10a6eaf0e3e5bcedebb96d4a76905fe2051f0714"
            },
            "downloads": -1,
            "filename": "coloraide-2.10.tar.gz",
            "has_sig": false,
            "md5_digest": "e5d68268f25428f46eb172c9c0e4b8cb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 15490207,
            "upload_time": "2023-09-12T13:27:47",
            "upload_time_iso_8601": "2023-09-12T13:27:47.706225Z",
            "url": "https://files.pythonhosted.org/packages/44/46/6764916d964d3d2ec9d62ceb0942bccac2588bd98655007be660b4e809e6/coloraide-2.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-12 13:27:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "facelessuser",
    "github_project": "coloraide",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "coloraide"
}
        
Elapsed time: 0.16974s