mirror of
https://github.com/taigrr/colorhash.git
synced 2026-04-01 18:58:45 -07:00
Tai Groot
e46914dabb
* ci: add GitHub Actions workflow with Go 1.25/1.26 matrix * Update CI workflow to use Go 1.26 only Removed Go version 1.25 from CI matrix.
colorhash
Deterministic color assignment from arbitrary input. Feed it a string or byte stream and get back a consistent color every time.
Features
- Deterministic — same input always produces the same color
- Pluggable palettes — bring your own
ColorSetor use simplecolorpalettes - Multiple output formats —
color.Color, ANSI escape codes, true-color terminal strings - String and byte input — hash strings directly or stream bytes via
io.Reader
Install
go get github.com/taigrr/colorhash
Usage
Hash a string to a color
import (
"github.com/taigrr/colorhash"
"github.com/taigrr/simplecolorpalettes/palettes/html"
)
palette := html.GetPalette() // or any ColorSet
c := colorhash.StringToColor(palette, "username")
// c is a deterministic color.Color
ANSI terminal colors
fmt.Println(colorhash.Red("error message"))
fmt.Println(colorhash.Green("success"))
fmt.Println(colorhash.BIYellow("bold high-intensity yellow"))
Automatic color from a palette
sp := colorhash.CreateStringerPalette(false, false, palette)
colored := sp.GetString("username") // wraps "username" in its assigned color
License
0BSD