Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2,193 changes: 2,193 additions & 0 deletions build/lib/grapefruit.py

Large diffs are not rendered by default.

Binary file added dist/grapefruit-0.1a4-py3.6.egg
Binary file not shown.
163 changes: 163 additions & 0 deletions grapefruit.egg-info/PKG-INFO
Original file line number Diff line number Diff line change
@@ -0,0 +1,163 @@
Metadata-Version: 1.1
Name: grapefruit
Version: 0.1a4
Summary: A module to manipulate color information easily.
Home-page: https://github.com/xav/Grapefruit/
Author: Xavier Basty
Author-email: xbasty@gmail.com
License: UNKNOWN
Description: ==========
GrapeFruit
==========

.. image:: https://img.shields.io/pypi/v/grapefruit.svg?style=flat
:target: https://pypi.python.org/pypi/grapefruit/
:alt: Latest PyPI version

.. image:: https://img.shields.io/travis/xav/Grapefruit/master.svg?style=flat
:target: https://travis-ci.org/xav/grapefruit/
:alt: Travis CI build status

.. image:: https://coveralls.io/repos/github/xav/Grapefruit/badge.svg?branch=master&style=flat
:target: https://coveralls.io/github/xav/Grapefruit?branch=master
:alt: Test coverage

.. image:: https://img.shields.io/github/license/xav/Grapefruit.svg?style=flat
:alt: License

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


Installation
============

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


Usage
=====

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:


Conversion of raw color values
------------------------------

+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| ↓from/to→ | cmy | cmyk | greyscale | hsl | hsv | html | ints | lab | pil | rgb | ryb | websafe | xyz | yiq | yuv |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| cmy | | yes | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| cmyk | yes | | | | | | | | | | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| greyscale | | | | | | | | | | | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| hsl | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| hsv | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| html | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| ints | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| lab | | | | | | | | | | | | | yes | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| pil | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| rgb | yes | | yes | yes | yes | yes | yes | | yes | | yes | yes | | yes | yes |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| ryb | | | | | | | | | | yes | | | yes | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| websafe | | | | | | | | | | | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| xyz | | | | | | | | yes | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| yiq | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+
| yuv | | | | | | | | | | yes | | | | | |
+-----------+-----+------+-----------+-----+-----+------+------+-----+-----+-----+-----+---------+-----+-----+-----+


Instantiation
-------------


Reading/Writing values
----------------------


Generate variations of a color
------------------------------


Generate color schemes based on a start color
---------------------------------------------


Contributing
============

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



License
=========

::

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.


Keywords: color,colour
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Graphics
9 changes: 9 additions & 0 deletions grapefruit.egg-info/SOURCES.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
README.rst
grapefruit.py
setup.cfg
setup.py
grapefruit.egg-info/PKG-INFO
grapefruit.egg-info/SOURCES.txt
grapefruit.egg-info/dependency_links.txt
grapefruit.egg-info/requires.txt
grapefruit.egg-info/top_level.txt
1 change: 1 addition & 0 deletions grapefruit.egg-info/dependency_links.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

3 changes: 3 additions & 0 deletions grapefruit.egg-info/requires.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@

[test]
nose
1 change: 1 addition & 0 deletions grapefruit.egg-info/top_level.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
grapefruit
4 changes: 2 additions & 2 deletions grapefruit.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@

"""GrapeFruit - Color manipulation in Python"""

from __future__ import division


import sys

Expand Down Expand Up @@ -1492,7 +1492,7 @@ def __unicode__(self):
The RGBA representation of this grapefruit.Color instance.

"""
return unicode("({}, {}, {}, {})".format(*[round(v, 6) for v in (self.__rgb + (self.__a,))]))
return str("({}, {}, {}, {})".format(*[round(v, 6) for v in (self.__rgb + (self.__a,))]))

def __iter__(self):
return iter(self.__rgb + (self.__a,))
Expand Down