pixa 0.1.7

Fast image processing CLI: compress, resize, convert, split sheets, generate favicons
Documentation 
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

mod commands;

use anyhow::Result;
use clap::{CommandFactory, Parser, Subcommand};

use commands::{
    completions, compress, convert, detect, favicon, info, install, remove_watermark, split,
    transparent,
};

const EXAMPLES: &str = "\
Examples:
  pixa compress hero.png -o hero.webp --max 1920
  pixa split sheet.png -o ./out --names neutral,happy,thinking,surprised,sad
  pixa transparent fox.png --bg '#FF00FF'
  pixa favicon logo.png -o ./favicon
  pixa convert photo.png photo.webp
  pixa info photo.jpg
  pixa remove-watermark image.jpg -o clean.jpg
  pixa install --skills
  pixa completions zsh > ~/.zfunc/_pixa
";

#[derive(Parser)]
#[command(
    name = "pixa",
    version,
    about = "A fast image processing toolkit",
    after_help = EXAMPLES,
)]
pub struct Cli {
    /// Enable verbose (debug) logging
    #[arg(short, long, global = true)]
    verbose: bool,

    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Remove Gemini watermark from an image or directory
    #[command(alias = "rw")]
    RemoveWatermark(remove_watermark::RemoveWatermarkArgs),

    /// Detect whether a Gemini watermark is present
    Detect(detect::DetectArgs),

    /// Compress / optimize images (MozJPEG, OxiPNG, WebP)
    Compress(compress::CompressArgs),

    /// Convert between image formats
    Convert(convert::ConvertArgs),

    /// Show image metadata and dimensions
    Info(info::InfoArgs),

    /// Generate a web-ready favicon/icon set from an image
    Favicon(favicon::FaviconArgs),

    /// Auto-detect and crop individual objects from a sheet image
    Split(split::SplitArgs),

    /// Replace a solid background color with transparency (chroma-key)
    Transparent(transparent::TransparentArgs),

    /// Install integrations (Claude Code skill, etc.)
    Install(install::InstallArgs),

    /// Generate shell completion scripts
    Completions(completions::CompletionsArgs),
}

fn main() -> Result<()> {
    let cli = Cli::parse();

    let filter = if cli.verbose { "debug" } else { "warn" };
    tracing_subscriber::fmt()
        .with_env_filter(
            tracing_subscriber::EnvFilter::try_from_default_env()
                .unwrap_or_else(|_| tracing_subscriber::EnvFilter::new(filter)),
        )
        .with_target(false)
        .without_time()
        .with_writer(std::io::stderr)
        .init();

    match cli.command {
        Commands::RemoveWatermark(a) => remove_watermark::run(a),
        Commands::Detect(a) => detect::run(a),
        Commands::Compress(a) => compress::run(a),
        Commands::Convert(a) => convert::run(a),
        Commands::Info(a) => info::run(a),
        Commands::Favicon(a) => favicon::run(a),
        Commands::Split(a) => split::run(a),
        Commands::Transparent(a) => transparent::run(a),
        Commands::Install(a) => install::run(a),
        Commands::Completions(a) => {
            let mut cmd = Cli::command();
            completions::run(a, &mut cmd)
        }
    }
}