Crate clap_version_flag 

A production-ready crate for adding colorful version output to clap applications.

This crate provides utilities to override the default -V/--version flag behavior in clap applications with colorful output using hex color codes.

Examples

Basic usage with derive

use clap::Parser;
use clap_version_flag::colorful_version;

#[derive(Parser)]
#[command(name = "myapp")]
struct Cli {
    #[arg(short, long)]
    input: String,
}

fn main() {
    let version = colorful_version!();
    let cli = Cli::parse();
     
    // Check version flag manually if needed
    // version.print(); // This would print colored version
}

Using with custom colors

use clap_version_flag::colorful_version;

let version = colorful_version!("#FF0000", "#0000FF", "#00FF00", "#FFFF00");
version.print();

Modules

macros

Macros for creating and working with ColorfulVersion

Macros

colorful_version

Main macro for easy creation of ColorfulVersion from Cargo.toml

colorful_version_full

Macro to create a colorful version with complete configuration

colorful_version_rgb

Macro to create a colorful version with RGB colors

Structs

ColorfulVersion

Configuration for colorful version output

Enums

VersionError

Error type for clap-version-flag

Traits

ColorfulVersionExt

Extension trait for clap::Command to add colorful version flag

Functions

parse_with_version

Helper function to parse command-line arguments with version handling