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
//! `self-depend` subcommand: parse-shape.
//!
//! Holds the clap derive structs only. No I/O, no business logic.
use camino::Utf8PathBuf;
use clap::{Subcommand, ValueEnum};
use crate::self_depend::manager::Manager;
use crate::self_depend::venue::Venue;
/// Wire this tool as a consumer's dependency, warn of a newer release, and move its pin.
#[derive(Debug, clap::Args)]
pub struct SelfDependArgs {
/// The verb to run.
#[command(subcommand)]
pub command: SelfDependCommand,
}
/// Every verb `sdd self-depend` offers.
#[derive(Debug, Subcommand)]
pub enum SelfDependCommand {
/// Report what a target carries, offline: each manager's pin, the shell-entry line, and any leftover.
Status(StatusArgs),
/// Serve the fragments for one manager and venue pair and the shell-entry line; seed the manager file where the target has none.
Add(AddArgs),
/// Warn on stderr when a newer release is out; reads the network at most once every seven days, writes only its cache, exits 0.
Check(CheckArgs),
/// Move the pin to the latest release through the wired manager; the operator's act, never the shell loader's.
Sync(SyncArgs),
/// Remove what a predecessor bump mechanism left, and name what a line scan must not touch.
Clean(CleanArgs),
}
/// Report what a target carries.
#[derive(Debug, clap::Args)]
pub struct StatusArgs {
/// The project to read; absolute, or the working directory.
#[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>,
/// Print one JSON object instead of text.
#[arg(long)]
pub json: bool,
}
/// Serve the fragments for one pair.
#[derive(Debug, clap::Args)]
pub struct AddArgs {
/// The project to wire; absolute, or the working directory.
#[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 sdd 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 this tool 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,
/// Print one JSON object instead of text.
#[arg(long)]
pub json: bool,
}
/// Check for a newer release.
#[derive(Debug, clap::Args)]
pub struct CheckArgs {
/// The project to check; absolute, or the working directory.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
}
/// Who is calling the sync.
#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
pub enum Caller {
/// Retired: the shell-entry line is `sdd self-depend check || true`, so this value is a usage error.
Envrc,
/// A person or an agent at a prompt: every outcome reported, the exit-code matrix.
Operator,
}
/// Move the pin.
#[derive(Debug, clap::Args)]
pub struct SyncArgs {
/// The project to sync; absolute, or the working directory.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// The release tag to pin, in either direction, making no network request; the latest release by default.
#[arg(long)]
pub tag: Option<String>,
/// The manager whose pin moves; the one manager naming this tool by default.
#[arg(long, value_enum)]
pub manager: Option<Manager>,
/// Who is calling: the operator, who sees every outcome; envrc is retired and names `check`.
#[arg(long, value_enum, default_value_t = Caller::Operator)]
pub caller: Caller,
/// Rewrite the pin and refresh the lock; without it the bump is reported and nothing runs.
#[arg(long)]
pub apply: bool,
/// Print one JSON object instead of text.
#[arg(long)]
pub json: bool,
}
/// Remove what a predecessor left.
#[derive(Debug, clap::Args)]
pub struct CleanArgs {
/// The project to clean; absolute, or the working directory.
#[arg(long, default_value = ".")]
pub target: Utf8PathBuf,
/// One extra file to remove, relative to the target, for a predecessor the catalog does not know; repeatable.
#[arg(long)]
pub also: Vec<Utf8PathBuf>,
/// Remove the files, swap the retired shell-entry line, and remove the retired stamps; without it each is listed.
#[arg(long)]
pub apply: bool,
/// Print one JSON object instead of text.
#[arg(long)]
pub json: bool,
}