Clientele makes it easy to write superb command-line utilities in Rust that
follow consistent best practices on all target platforms including Linux, macOS,
and Windows. It packages and re-exports clap
, camino
, dotenvy
,
argfile
, and wild
into a single easy dependency.
- Showcases how to structure a CLI program in Rust (see the examples).
- Loads environment variables from
.env
files (using thedotenvy
crate). - Expands wildcards (globs) on Windows (using the
wild
crate). - Expands @argfiles similarly to
javac
or Python (using theargfile
crate). - Defines a standard set of essential CLI options (using the
clap
crate). - Provides the
Utf8Path
andUtf8PathBuf
types (using thecamino
crate). - Supports opting out of any feature using comprehensive feature flags.
- Adheres to the Rust API Guidelines in its naming conventions.
- 100% free and unencumbered public domain software.
- Rust 1.70+
cargo add clientele
See lib/clientele/examples/skeleton/main.rs
for a complete example.
use clientele::*;
Options:
--color <COLOR> Set the color output mode [default: auto] [possible values: auto, always, never]
-d, --debug Enable debugging output
--license Show license information
-v, --verbose... Enable verbose output (may be repeated for more verbosity)
-V, --version Print version information
-h, --help Print help
git clone https://github.com/artob/clientele.rs.git