philiprehberger-color-convert
v0.2.0991 downloadsMIT
Convert between color formats: hex, RGB, HSL, HSV, CMYK, and named CSS colors
$
pip install philiprehberger-color-convertREADME
philiprehberger-color-convert
Convert between color formats: hex, RGB, HSL, HSV, CMYK, and named CSS colors.
Installation
pip install philiprehberger-color-convert
Usage
from philiprehberger_color_convert import Color
# Create from hex
c = Color("#ff6b35")
# Create from CSS named color
c = Color("tomato")
# Create from RGB string
c = Color("rgb(255, 107, 53)")
# Create from another Color
c2 = Color(c)
Factory Methods
c = Color.from_rgb(255, 107, 53)
c = Color.from_hsl(20, 100, 60)
c = Color.from_hsv(20, 79, 100)
c = Color.from_cmyk(0, 58, 79, 0)
Format Properties
c = Color("#ff6b35")
c.rgb # (255, 107, 53)
c.hex # "#ff6b35"
c.hsl # (16, 100, 60)
c.hsv # (16, 79, 100)
c.cmyk # (0, 58, 79, 0)
Manipulation
c = Color("#ff6b35")
lighter = c.lighten(20)
darker = c.darken(20)
more = c.saturate(10)
less = c.desaturate(10)
comp = c.complement()
inv = c.invert()
Chaining
# Each method returns a new Color — chain freely
warm = Color("#3498db").desaturate(20).lighten(10)
print(warm.hex)
Palette Generation
c = Color("#ff6b35")
c.analogous() # [Color, Color, Color]
c.triadic() # [Color, Color, Color]
c.split_complementary() # [Color, Color, Color]
Contrast Ratio
white = Color("#ffffff")
black = Color("#000000")
white.contrast_ratio(black) # 21.0
Mixing Colors
red = Color("#ff0000")
blue = Color("#0000ff")
red.mix(blue) # 50/50 mix → Color('#800080')
red.mix(blue, weight=0.25) # 25% blue → closer to red
red.mix(blue, weight=0.75) # 75% blue → closer to blue
API
| Method / Property | Description |
|---|---|
Color(value) | Create from hex, RGB string, CSS name, or Color |
Color.from_rgb(r, g, b) | Create from RGB values (0-255) |
Color.from_hsl(h, s, l) | Create from HSL (h: 0-360, s/l: 0-100) |
Color.from_hsv(h, s, v) | Create from HSV (h: 0-360, s/v: 0-100) |
Color.from_cmyk(c, m, y, k) | Create from CMYK (0-100 each) |
.rgb | RGB tuple (r, g, b) |
.hex | Hex string "#rrggbb" |
.hsl | HSL tuple (h, s, l) |
.hsv | HSV tuple (h, s, v) |
.cmyk | CMYK tuple (c, m, y, k) |
.lighten(percent) | Return lighter Color |
.darken(percent) | Return darker Color |
.saturate(percent) | Return more saturated Color |
.desaturate(percent) | Return less saturated Color |
.complement() | Return complementary Color |
.invert() | Return inverted Color |
.analogous() | List of 3 analogous Colors |
.triadic() | List of 3 triadic Colors |
.split_complementary() | List of 3 split-complementary Colors |
.contrast_ratio(other) | WCAG contrast ratio (float) |
.mix(other, weight=0.5) | Blend with another Color in RGB space |
css_color_names() | Sorted list of all 148 supported CSS color names |
Development
pip install -e .
python -m pytest tests/ -v
Support
If you find this project useful: