Instant feedback on the state of your tests*
About | Demo | Installation | Configuration | License | Contribution
This crate allows running arbitrary commands and indicate the status of its execution using USB notification light - blink(1).
*By default it runs cargo test. You can customize the commands and LED colors using configuration file.
- run
cargo watch -x blinc - after every file save, it will start blinking with blue light
- it will start execution of
cargo test - after tests finish it will glow red when tests fail or green when tests succeed
To install
cargo install cargo-blinc
To upgrade
cargo install --force cargo-blinc
Make sure that you have correct access rights to access blink(1) device. See udev rules here.
By default, no configuration is required if these settings satisfy you:
- tasks:
cargo check,cargo test - pending task color: blue (blinking)
- failed task color: red
- successful task color: green
You can control all of these by configuration file.
Run cargo blinc --init <path> to initialize config. It will create file, under specified path, with following content:
[[tasks]]
cmd = "cargo"
args = ["check"]
[[tasks]]
cmd = "cargo"
args = ["test"]
[colors]
pending = ["blue", "white"]
failure = "red"
success = "green"
[env]Run cargo blinc --config <path> to specify path to the configuration file. The default value is .blinc.
The [env] section is empty by default. It allows specifying environment variables during execution
of configured [[tasks]]. Example:
[[tasks]]
cmd = "cargo"
args = ["check"]
[[tasks]]
cmd = "cargo"
args = ["test"]
[colors]
pending = ["blue", "white"]
failure = "red"
success = "green"
[env]
RUST_LOG = "debug"
API_KEY = "1231431"If you don't have a need to specify environment variables, you can remove the section.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
At your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.