GrapeFruit is a pure Python module that let you easily manipulate and convert color information. Its Primary goal is to be natural and flexible.

The following color systems are supported by GrapeFruit:

• RGB (sRGB)
• HSL
• HSV
• YIQ
• YUV
• CIE-XYZ
• CIE-LAB (with the illuminant you want)
• CMY
• CMYK
• HTML/CSS color definition (#RRGGBB, #RGB or the X11 color name)
• RYB (Itten's )rtistic color wheel

You can install grapefruit driectly from PyPY. Just run:

pip install grapefruit

And you're set.

If you want to use the latest version, you can install directly from the sources by running:

pip install git+https://github.com/xav/Grapefruit

You can also use a specific revision (branch/tag/commit):

pip install git+https://github.com/xav/Grapefruit@master

To get complete demo of each function, please read the source code which is heavily documented and provide a lot of examples in doctest format.

Here is a reduced sample of a common usage scenario:

Any suggestion or issue is welcome. Push request are very welcome, please check out the guidelines.

Copyright (c) 2008-2016, Xavier Basty

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.