Skip to content

Clientele makes it easy to write superb command-line utilities in Rust that follow consistent best practices on Linux, macOS, and Windows.

License

Notifications You must be signed in to change notification settings

artob/clientele.rs

Repository files navigation

Clientele.rs

License Compatibility Package

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.

✨ Features

  • Showcases how to structure a CLI program in Rust (see the examples).
  • Loads environment variables from .env files (using the dotenvy crate).
  • Expands wildcards (globs) on Windows (using the wild crate).
  • Expands @argfiles similarly to javac or Python (using the argfile crate).
  • Defines a standard set of essential CLI options (using the clap crate).
  • Provides the Utf8Path and Utf8PathBuf types (using the camino 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.

🛠️ Prerequisites

⬇️ Installation

Installation via Cargo

cargo add clientele

👉 Examples

See lib/clientele/examples/skeleton/main.rs for a complete example.

Importing the library

use clientele::*;

📚 Reference

Options

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

👨‍💻 Development

git clone https://github.com/artob/clientele.rs.git

Share on Twitter Share on Reddit Share on Hacker News Share on Facebook

About

Clientele makes it easy to write superb command-line utilities in Rust that follow consistent best practices on Linux, macOS, and Windows.

Topics

Resources

License

Stars

Watchers

Forks