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
//! What:
//! The plan for one `git worktree remove` that the wrapper may serve with a subvolume destroy: the one directory it names.
//! Why:
//! Only the plain form (one directory, no option, a non-empty name) is served; `--force` and every other option change what Git checks, and a
//! name Git resolves by its last path component is not a directory here, so those stay with Git.
//!
//! In TS you'd write (pseudocode):
//! ```ts
//! const plan = parseRemovePlan(['worktree', 'remove', '../topic'], 0, cwd); // undefined: Git removes it
//! ```
use std::ffi::OsString;
use std::path::{Path, PathBuf};
/// What:
/// The worktree a `git worktree remove <path>` names, resolved to a directory that exists.
/// Why:
/// The removal needs the worktree's real path; Git also accepts a unique last component, which the wrapper leaves to
/// Git by finding no such directory.
///
/// In TS you'd write (pseudocode):
/// ```ts
/// type RemovePlan = { target: string; operand: string };
/// ```
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct RemovePlan {
/// The real path of the worktree directory.
pub target: PathBuf,
/// The operand as the person typed it, which Git also matches against the last components of every registered path.
pub operand: OsString,
}
/// What:
/// Plan one invocation of `git worktree remove` that names exactly one directory and no option.
/// Why:
/// `--force` and every other option change what Git checks, so those forms stay with Git.
///
/// In TS you'd write (pseudocode):
/// ```ts
/// function parseRemovePlan(args: string[], subcommandIndex: number, start: string): RemovePlan | undefined;
/// ```
pub fn parse_remove_plan(arguments: &[OsString], subcommand_index: usize, start: &Path) -> Option<RemovePlan> {
if arguments.get(subcommand_index)?.as_encoded_bytes() != b"worktree" || arguments.get(subcommand_index + 1)?.as_encoded_bytes() != b"remove" {
return None;
}
let rest: &[OsString] = &arguments[subcommand_index + 2..];
let operand: &OsString = match rest {
[only] if !only.as_encoded_bytes().starts_with(b"-") => only,
[separator, only] if separator.as_encoded_bytes() == b"--" => only,
_ => return None,
};
// Joined to the start directory an empty operand would name that directory, while Git answers that '' is not a working tree.
if operand.is_empty() {
return None;
}
let target: PathBuf = std::fs::canonicalize(start.join(operand)).ok()?;
return target.is_dir().then_some(RemovePlan { target, operand: operand.clone() });
}
/// Removal plan controls stay out of the release executable.
#[cfg(test)]
#[path = "worktree_remove_plan_tests.rs"]
mod tests;