casile 0.14.4

The command line interface to the CaSILE toolkit, a book publishing workflow employing SILE and other wizardry
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

// use clap::FromArgMatches as _;
use clap::{Args, Subcommand};
use std::{ffi::OsString, path};

// FTL: help-description
/// The command line interface to the CaSILE toolkit,
/// a publishing workflow employing SILE and other wizardry.
#[derive(Args, Debug)]
#[clap(author)]
pub struct Cli {
    // FTL: help-flag-debug
    /// Enable extra debug output from tooling
    #[clap(short, long)]
    pub debug: bool,

    // FTL: help-flag-language
    /// Set language
    #[clap(short, long)]
    pub language: Option<String>,

    // FTL: help-flag-passthrough
    /// Eschew all UI output and just pass the subprocess output through
    #[clap(short, long)]
    pub passthrough: bool,

    // FTL: help-flag-project
    /// Set project root path
    #[clap(short = 'P', long, default_value = "./", value_hint = clap::ValueHint::DirPath)]
    pub project: path::PathBuf,

    // FTL: help-flag-quiet
    /// Discard all non-error output messages
    #[clap(short, long)]
    pub quiet: bool,

    // FTL: help-flag-verbose
    /// Enable extra verbose output from tooling
    #[clap(short, long)]
    pub verbose: bool,

    #[clap(subcommand)]
    pub subcommand: Commands,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    // FTL: help-subcommand-make
    /// Build specified target(s) with ‘make’
    Make {
        // FTL: help-subcommand-make-target
        /// Target(s) as defined by CaSILE in project rules
        #[clap(value_hint = clap::ValueHint::AnyPath)]
        target: Vec<String>,
    },

    // FTL: help-subcommand-run
    /// Run helper script inside CaSILE environment
    Run {
        // FTL: help-subcommand-run-name
        /// Run script name as supplied by CaSILE, toolkit, or project
        #[clap(value_hint = clap::ValueHint::CommandName)]
        name: String,

        // FTL: help-subcommand-run-arguments
        /// Arguments to pass to script being run
        #[clap(value_hint = clap::ValueHint::Unknown)]
        arguments: Vec<OsString>,
    },

    // FTL: help-subcommand-setup
    /// Configure a publishing project repository
    Setup {},

    // FTL: help-subcommand-status
    /// Show status information about setup, configuration, and build state
    Status {},
}