forjar 1.12.0

Rust-native Infrastructure as Code — bare-metal first, BLAKE3 state, provenance tracing
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

//! CLI Args structs for plan-related commands.

use std::path::PathBuf;

/// CLI arguments for the `plan` command.
#[derive(clap::Args, Debug)]
pub struct PlanArgs {
    /// Path to forjar.yaml
    #[arg(short, long, default_value = "forjar.yaml")]
    pub file: PathBuf,

    /// Target specific machine
    #[arg(short, long)]
    pub machine: Option<String>,

    /// Target specific resource
    #[arg(short, long)]
    pub resource: Option<String>,

    /// Filter to resources with this tag
    #[arg(short, long)]
    pub tag: Option<String>,

    /// FJ-281: Filter to resources in this group
    #[arg(short, long)]
    pub group: Option<String>,

    /// State directory
    #[arg(long, default_value = "state")]
    pub state_dir: PathBuf,

    /// Output plan as JSON
    #[arg(long)]
    pub json: bool,

    /// Write generated scripts to directory for auditing
    #[arg(long)]
    pub output_dir: Option<PathBuf>,

    /// FJ-211: Load param overrides from external YAML file
    #[arg(long)]
    pub env_file: Option<PathBuf>,

    /// FJ-210: Use workspace (overrides state dir to state/<workspace>/)
    #[arg(short = 'w', long)]
    pub workspace: Option<String>,

    /// FJ-255: Suppress content diff in plan output
    #[arg(long)]
    pub no_diff: bool,

    /// FJ-285: Plan single resource and its transitive dependencies
    #[arg(long)]
    pub target: Option<String>,

    /// FJ-312: Show estimated change cost per resource type
    #[arg(long)]
    pub cost: bool,

    /// FJ-333: Hypothetical param override — show plan as if param had this value
    #[arg(long = "what-if", value_name = "KEY=VALUE")]
    pub what_if: Vec<String>,

    /// FJ-1250: Write plan to file for later execution with `apply --plan-file`
    #[arg(long)]
    pub out: Option<PathBuf>,

    /// FJ-1379: Show per-resource explanation of why each change is needed
    #[arg(long)]
    pub why: bool,
}

/// CLI arguments for the `plan --compact` command.
#[derive(clap::Args, Debug)]
pub struct PlanCompactArgs {
    /// Path to forjar.yaml
    #[arg(short, long, default_value = "forjar.yaml")]
    pub file: PathBuf,

    /// State directory
    #[arg(long, default_value = "state")]
    pub state_dir: PathBuf,

    /// Target specific machine
    #[arg(short, long)]
    pub machine: Option<String>,

    /// Output as JSON
    #[arg(long)]
    pub json: bool,
}

/// CLI arguments for `forjar make [GOALS...]`.
///
/// Deliberately small and make-flavoured. `ApplyArgs` has ~40 flags; reusing it
/// wholesale would produce a `forjar make --help` nobody could read. The flags
/// here are the ones that have a `make` counterpart, named the same way.
#[derive(clap::Args, Debug)]
pub struct MakeArgs {
    /// Goals to build, with their prerequisites. No goals = the whole config.
    pub goals: Vec<String>,

    /// Path to forjar.yaml
    #[arg(short, long, default_value = "forjar.yaml")]
    pub file: PathBuf,

    /// Print what would run without running it (make -n)
    #[arg(short = 'n', long)]
    pub dry_run: bool,

    /// Unconditionally rebuild every goal (make -B)
    #[arg(short = 'B', long = "always-make")]
    pub always_make: bool,

    /// Maximum resources to converge in parallel (make -j)
    #[arg(short = 'j', long)]
    pub jobs: Option<usize>,

    /// Override a parameter (KEY=VALUE)
    #[arg(short, long)]
    pub param: Vec<String>,

    /// State directory
    #[arg(long, default_value = "state")]
    pub state_dir: PathBuf,

    /// Target specific machine
    #[arg(short, long)]
    pub machine: Option<String>,

    /// Skip provenance tracing
    #[arg(long)]
    pub no_tripwire: bool,

    /// Skip the confirmation prompt (CI mode)
    #[arg(long)]
    pub yes: bool,

    /// Output results as JSON
    #[arg(long)]
    pub json: bool,
}

/// FJ-2726: CLI arguments for `forjar import-makefile`.
#[derive(clap::Args, Debug)]
pub struct ImportMakefileArgs {
    /// Path to the Makefile to import
    #[arg(default_value = "Makefile")]
    pub makefile: PathBuf,

    /// Output file ("-" writes to stdout)
    #[arg(short, long, default_value = "-")]
    pub output: PathBuf,

    /// Machine name for the generated resources
    #[arg(short, long, default_value = "local")]
    pub machine: String,
}