zfish 0.1.10

Ultra-light, zero-dependency Rust CLI framework for building beautiful command-line applications
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

// Copyright (c) 2025 Jeet Karena <karenajeet@proton.me>
// Example: Complete CLI - Putting it all together

use std::thread;
use std::time::Duration;
use zfish::{Args, Color, Level, Logger, ProgressBar, Style};

fn main() {
    let args = Args::parse();

    // Setup logger based on verbosity
    let log_level = if args.has_flag("verbose") || args.has_flag("v") {
        Level::Debug
    } else {
        Level::Info
    };
    let logger = Logger::new().level(log_level);

    // Show help
    if args.has_flag("help") || args.has_flag("h") {
        show_help();
        return;
    }

    // Show version
    if args.has_flag("version") {
        println!(
            "{}",
            Color::Cyan
                .paint("zfish Example CLI v0.1.0")
                .style(Style::Bold)
        );
        return;
    }

    // Get configuration from arguments
    let iterations = args
        .get_option("iterations")
        .and_then(|s| s.parse::<u64>().ok())
        .unwrap_or(50);

    let output_file = args
        .get_option("output")
        .map(|s| s.as_str())
        .unwrap_or("output.txt");

    // Start the application
    logger.info(&format!(
        "{}",
        Color::Green
            .paint("Starting application...")
            .style(Style::Bold)
    ));
    logger.debug(&format!("Iterations: {}", iterations));
    logger.debug(&format!("Output file: {}", output_file));

    // Process with progress bar
    logger.info("Processing data...");
    let mut pb = ProgressBar::new(iterations);

    for i in 0..iterations {
        thread::sleep(Duration::from_millis(50));

        if i % 10 == 0 {
            logger.debug(&format!("Processed {} items", i));
        }

        pb.set(i + 1);
    }

    pb.finish(&format!("{}", Color::Green.paint("✓ Processing complete!")));

    // Final output
    logger.info(&format!(
        "Results saved to: {}",
        Color::Cyan.paint(output_file)
    ));
    logger.info(&format!(
        "{}",
        Color::Green.paint("✓ Done!").style(Style::Bold)
    ));

    // Summary
    println!(
        "\n{}",
        Color::Magenta.paint("=== Summary ===").style(Style::Bold)
    );
    println!("Processed: {} items", iterations);
    println!("Output: {}", output_file);
    println!("Status: {}", Color::Green.paint("Success"));
}

fn show_help() {
    println!(
        "{}",
        Color::Cyan.paint("zfish Example CLI").style(Style::Bold)
    );
    println!();
    println!("USAGE:");
    println!("    {} [OPTIONS]", std::env::args().next().unwrap());
    println!();
    println!("OPTIONS:");
    println!("    -h, --help                 Print help information");
    println!("    --version                  Print version");
    println!("    -v, --verbose              Enable verbose logging");
    println!("    --iterations <N>           Number of iterations [default: 50]");
    println!("    -o, --output <FILE>        Output file path [default: output.txt]");
    println!();
    println!("EXAMPLES:");
    println!("    {} --iterations 100", std::env::args().next().unwrap());
    println!(
        "    {} --verbose -o results.txt",
        std::env::args().next().unwrap()
    );
}

// Run with:
// cargo run --example 08_complete_cli -- --help
// cargo run --example 08_complete_cli -- --verbose --iterations 30
// cargo run --example 08_complete_cli -- -o myfile.txt