#color #cli

app colo

CLI tool to show and convert colors between various color spaces

7 unstable releases (3 breaking)

new 0.4.0 Nov 21, 2020
0.3.2 Nov 13, 2020
0.2.2 Oct 31, 2020
0.1.0 Oct 28, 2020

#55 in Command-line interface

Download history 80/week @ 2020-10-28 51/week @ 2020-11-04 41/week @ 2020-11-11 29/week @ 2020-11-18

58 downloads per month

MIT license

115KB
3K SLoC

colo Logo

Command-line tool for displaying colors, written in Rust

Crates.io Crates.io Tests

Changelog ☑

The changelog can be found here.

Note that colo is young and evolving rapidly. There will likely be big changes in the next releases.

Usage 📚

How to use colo is explained on the website.

Here is the list of supported color spaces.

Installation 🚀

How to install colo is explained on the releases page.

Build from source 🛠

If you want to build colo from source, make sure you have the Rust toolchain (including Cargo) installed. Then clone this repository and run

cargo install --path .

Or, if you don't want to clone the repository, you can run

cargo install --git https://github.com/Aloso/colo

This builds the code from the main branch. You can specify a different branch with --branch or a tag with --tag.

Code of Conduct 🤝

Please be friendly and respectful to others. This should be a place where everyone can feel safe, therefore I intend to enforce the Rust code of conduct.

Contributing 🙌

I appreciate your help! The easiest way to help is to file bug reports or suggest new features in the issue tracker.

If you want to create a pull request, make sure the following requirements are met:

  • The code is documented
  • If you add a dependency that includes unsafe code, please explain why it is required
  • Please try to keep compile times small, if feasible

Also, to pass continuous integration, the code must

  • be properly formatted with cargo fmt
  • pass cargo clippy
  • compile on the latest stable Rust version on Ubuntu, Windows and macOS.
  • all tests must pass

To contribute to the website, send a PR to the gh-pages branch.

That's it! If you have any questions, feel free to create an issue.

Dependencies

~1.3–2MB
~40K SLoC