src/opts.rs

   1 use std::path::PathBuf;
   2
   3 use clap::{Parser, ValueHint};
   4
   5 // Ouch command line options (docstrings below are part of --help)
   6 /// A command-line utility for easily compressing and decompressing files and directories.
   7 ///
   8 /// Supported formats: tar, zip, bz/bz2, gz, lz4, xz/lz/lzma, zst.
   9 ///
  10 /// Repository: https://github.com/ouch-org/ouch
  11 #[derive(Parser, Debug)]
  12 #[command(about, version)]
  13 // Disable rustdoc::bare_urls because rustdoc parses URLs differently than Clap
  14 #[allow(rustdoc::bare_urls)]
  15 pub struct Opts {
  16     /// Skip [Y/n] questions positively
  17     #[arg(short, long, conflicts_with = "no", global = true)]
  18     pub yes: bool,
  19
  20     /// Skip [Y/n] questions negatively
  21     #[arg(short, long, global = true)]
  22     pub no: bool,
  23
  24     /// Activate accessibility mode, reducing visual noise
  25     #[arg(short = 'A', long, env = "ACCESSIBLE", global = true)]
  26     pub accessible: bool,
  27
  28     /// Ignores hidden files
  29     #[arg(short = 'H', long)]
  30     pub hidden: bool,
  31
  32     /// Ignores files matched by git's ignore files
  33     #[arg(short = 'g', long)]
  34     pub gitignore: bool,
  35
  36     /// Ouch and claps subcommands
  37     #[command(subcommand)]
  38     pub cmd: Subcommand,
  39 }
  40
  41 #[derive(Parser, PartialEq, Eq, Debug)]
  42 #[allow(rustdoc::bare_urls)]
  43 pub enum Subcommand {
  44     /// Compress one or more files into one output file
  45     #[command(visible_alias = "c")]
  46     Compress {
  47         /// Files to be compressed
  48         #[arg(required = true, num_args = 1..)]
  49         files: Vec<PathBuf>,
  50
  51         /// The resulting file. Its extensions can be used to specify the compression formats
  52         #[arg(required = true, value_hint = ValueHint::FilePath)]
  53         output: PathBuf,
  54     },
  55     /// Decompresses one or more files, optionally into another folder
  56     #[command(visible_alias = "d")]
  57     Decompress {
  58         /// Files to be decompressed
  59         #[arg(required = true, num_args = 1..)]
  60         files: Vec<PathBuf>,
  61
  62         /// Place results in a directory other than the current one
  63         #[arg(short = 'd', long = "dir", value_hint = ValueHint::DirPath)]
  64         output_dir: Option<PathBuf>,
  65     },
  66     /// List contents of an archive
  67     #[command(visible_alias = "l")]
  68     List {
  69         /// Archives whose contents should be listed
  70         #[arg(required = true, num_args = 1..)]
  71         archives: Vec<PathBuf>,
  72
  73         /// Show archive contents as a tree
  74         #[arg(short, long)]
  75         tree: bool,
  76     },
  77 }