climer

Crates.ioclimer
lib.rsclimer
version0.7.1
sourcesrc
created_at2019-08-12 14:56:29.43453
updated_at2023-02-10 16:08:25.239026
descriptionCLI timer app
homepage
repositoryhttps://github.com/Noah2610/climer
max_upload_size
id156148
size53,640
Noah Rosenzweig (Noah2610)

documentation

README

Climer

A simple CLI timer, written in Rust.

CLI app

This project's main use is as a CLI app, but it can also be used as a crate / library.

Installation

From crates.io

cargo install climer

From source

You will need cargo to compile from source, which is shipped with Rust.

git clone https://github.com/Noah2610/climer # Clone the repository
cargo install --path ./climer                # Compile and install

Usage

For the very basic timing feature, you can run something like:

climer 2m 30s

This will run the timer and print a readable representation of the remaining time to stdout.
When the time is up, the app will simply exit with exit code 0,
so it is up to you to then play an alarm sound or whatever you may want it to trigger;
for example:

climer 1h 2m 30s && mpv ~/Music/alarm.mp3

For more detailed usage information, check out the help page with:

climer -h      # Brief help
climer --help  # More detailed help

Library crate

In your Cargo.toml ...

[dependencies]
climer = { version = "0.7.0", default-features = false }

See below for available features.

Compilation features

Name Description Default?
cli Required for the binary app. You should disable this for library crates true
serialize Adds serde dependency and implements Serialize and Deserialize for time::Time false
parser Adds regex dependency and adds time::parser module with functions for parsing a time from a given string enabled by cli feature

Documentation

Documentation should be available at docs.rs/climer.

License

MIT License

Commit count: 58

cargo fmt