Colouration
Colouration is a Python library for working with colours. It unifies three representation of colour:
Installation
pip install colouration
Usage
Colour
from colouration import Colour
default_arguments = Colour(
obj=None,
red=None, green=None, blue=None,
hexadecimal=None,
hue=None, saturation=None, lightness=None, value=None,
min_value=0.0, max_value=1.0,
name=None, id=None, scheme=None,
weight=1.0
)
# you can use the rgb hexadecimal code to create a Colour object
red = Colour('#FF0000')
# you can enter red, green, and blue as separate values
green = Colour(red=0, green=1, blue=0)
# max value is 1 by default but other values can be used too
blue = Colour(red=0, green=0, blue=255, max_value=255)
# and you can use colour names
literal_red = Colour('red')
print(f'is red equal to literal_red? {"yes" if red == literal_red else "no"}\n')
# you can print with it
literal_red.print('by default the main colour is used for background\n')
# to use the colour as the text colour you should use the main_colour argument
red.print(string='red text\n', main_colour='text', secondary='auto') # secondary='auto' is default
# the secondary colour is white when the main colour is dark and it is black otherwise
red.print(string='the secondary colour is white when the main colour is dark and it is black otherwise.\n')
# you can choose a secondary colour
red.print(string='red on white\n', main_colour='text', secondary='white')
# you can use string or a Colour object
red.print(string='blue on red\n', secondary=Colour('blue'))
# you can darken or lighten a colour
dark_red = red.darken(ratio=0.5)
dark_red.print(string='dark red\n')
# ratio can be between 0 and 1
light_red = red.lighten(ratio=0.8)
# you can change the hue of a colour
new_colour = red.increase_hue(0.2)
new_colour.print('hue increased by 0.2\n')
# you can assign a new hue, lightness, value, red, green, or blue too
new_colour.red = 0.2
new_colour.print('setting red = 0.2 causes this.\n')
new_colour.hue = 0.8
new_colour.print('setting hue = 0.4 causes this.\n')
new_colour.value = 0.3
new_colour.print('setting value = 0.3 causes this.\n')
new_colour.lightness = 0.9
new_colour.print('setting lightness = 0.9 causes this.\n')
# you can mix colours by adding them together
yellow = green + red
yellow.print(string='mixing green and red produces this.\n')
# Colour finds the best name for itself
bluish = Colour(red=220, green=243, blue=255, max_value=255) # max_value is 1 by default
bluish.print(string=f'Colour finds the best name for itself: {bluish.name}.\n')
Scheme
Gradient
1 maintainer
Metadata
1 maintainer
Release files for colouration 2020.7.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| colouration-2020.7.26.tar.gz | 18.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| colouration-2020.7.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 39.3 kB
Release files / colouration-2020.7.26.tar.gz
| Download URL | colouration-2020.7.26.tar.gz |
|---|---|
| Size | 18.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
13420ac5cc7a6be3b1be9a3730614678a23a3fe2a8abdc7f5bf7fea614d6f224
|
|
BLAKE2b-256 checksum How to use checksums |
3889999ced63975b9ea7e0c4fe27ef9f4b682a9702f7f930f28eb219c3ae4ba8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.2
|
Release files / colouration-2020.7.26-py3-none-any.whl
| Download URL | colouration-2020.7.26-py3-none-any.whl |
|---|---|
| Size | 20.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
824e4883c6b3596759ec5f8c4e2b74c6530373507c074901a62ee8c495bd80f4
|
|
BLAKE2b-256 checksum How to use checksums |
6cc0c938c243f098cad1d4adcfa1e1dd69a2b266f3a86eb3c217dde53174d742
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.2
|
