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
//! Arguments for `rk self-depend`.
use camino::Utf8PathBuf;
use clap::{Args, Subcommand, ValueEnum};
use crate::self_depend::manager::Manager;
use crate::self_depend::venue::Venue;
/// Wire release-kit as a consumer's dependency and keep its pin fresh.
#[derive(Debug, Args)]
pub struct SelfDependArgs {
/// What to do with the pin wiring.
#[command(subcommand)]
pub action: SelfDependAction,
}
/// The self-depend operations.
#[derive(Debug, Subcommand)]
pub enum SelfDependAction {
/// Report what a target carries, offline: each manager's pin, the .envrc line, and any leftover.
Status(StatusArgs),
/// Serve the fragments for one manager and venue pair and the .envrc line; seed the manager file where the target has none.
Add(AddArgs),
/// Remove what a predecessor bump mechanism left, and name what a line scan must not touch.
Clean(CleanArgs),
/// Move the pin to the latest release through the wired manager; the flake pair locks and builds, both files or neither. The operator's act, refused inside an .envrc evaluation.
Sync(SyncArgs),
/// Warn where a newer release is out, from a cache read weekly; the .envrc line runs it on every directory entry. Writes nothing but its cache, and exits 0.
Check(CheckArgs),
}
/// Arguments for `rk self-depend status`.
#[derive(Debug, Args)]
pub struct StatusArgs {
/// The project to read.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// Report one manager's entry alone; every manager by default, absent ones included.
#[arg(long, value_enum)]
pub manager: Option<Manager>,
/// Emit one JSON object on stdout instead of the human report.
#[arg(long)]
pub json: bool,
}
/// Arguments for `rk self-depend add`.
#[derive(Debug, Args)]
pub struct AddArgs {
/// The project to wire.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// The release tag to pin: v0.2.16, 0.2.16, or the release URL; this binary's version by default.
#[arg(long)]
pub tag: Option<String>,
/// Record that every host installs rk itself, at this release or newer, instead of pinning it in a manager file.
#[arg(long, conflicts_with_all = ["tag", "manager", "venue"])]
pub host: bool,
/// The target's tool manager; required when the target carries several, the flake when it carries none.
#[arg(long, value_enum)]
pub manager: Option<Manager>,
/// Where rk is fetched from; the first venue the manager renders a fragment for by default.
#[arg(long, value_enum)]
pub venue: Option<Venue>,
/// Write the seed files; without it the fragments are printed and nothing is written.
#[arg(long)]
pub apply: bool,
/// Emit one JSON object on stdout instead of the human report.
#[arg(long)]
pub json: bool,
}
/// Arguments for `rk self-depend clean`.
#[derive(Debug, Args)]
pub struct CleanArgs {
/// The project to clean.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// One extra file to remove, for a predecessor the catalog does not know; repeatable.
#[arg(long, value_name = "PATH")]
pub also: Vec<Utf8PathBuf>,
/// Remove the files and rewrite .envrc; without it every leftover is listed.
#[arg(long)]
pub apply: bool,
/// Emit one JSON object on stdout instead of the human report.
#[arg(long)]
pub json: bool,
}
/// Arguments for `rk self-depend sync`.
#[derive(Debug, Args)]
pub struct SyncArgs {
/// The project to sync.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// The release tag to pin, in either direction, making no network request; the latest release by default, forward only.
#[arg(long)]
pub tag: Option<String>,
/// The manager whose pin moves; the one manager naming release-kit by default.
#[arg(long, value_enum)]
pub manager: Option<Manager>,
/// Who is calling: the operator, the only caller a sync serves; envrc is retired, and `rk self-depend check` serves directory entry.
#[arg(long, value_enum, default_value_t = Caller::Operator)]
pub caller: Caller,
/// Rewrite the pin, refresh the lock, and build; without it the bump is reported and nothing runs.
#[arg(long)]
pub apply: bool,
/// Emit one JSON object on stdout instead of the human report.
#[arg(long)]
pub json: bool,
}
/// Who invoked the sync. A sync moves the pin only as the operator's act,
/// so `envrc` stays a value only to be refused by name.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
#[value(rename_all = "kebab-case")]
pub enum Caller {
/// Retired: the `.envrc` line runs `rk self-depend check`, which never moves a pin.
Envrc,
/// A person or an agent at a prompt: every outcome reported, the exit-code matrix.
Operator,
}
/// Arguments for `rk self-depend check`.
#[derive(Debug, Args)]
pub struct CheckArgs {
/// The project whose pin is checked.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// Emit one JSON object on stdout instead of the human report.
#[arg(long)]
pub json: bool,
}