git-stk 0.9.4

Git-native stacked branch workflow helper
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

use anyhow::Result;
use clap::ArgAction;
use clap_complete::engine::ArgValueCompleter;

use crate::commands::Run;
use crate::completions;
use crate::providers::{detect_review_provider, owned_review_for_branch};
use crate::style;
use crate::{git, stack};

/// Rename a branch and retarget its stack children.
#[derive(Debug, clap::Args)]
pub struct Rename {
    /// New name for the current branch, or a branch and its new name.
    #[arg(
        required = true,
        num_args = 1..=2,
        value_name = "[BRANCH] NEW_NAME",
        add = ArgValueCompleter::new(completions::branch_candidates),
    )]
    names: Vec<String>,
    /// Print the rename and retargets without changing anything.
    #[arg(long, short = 'n', action = ArgAction::SetTrue)]
    dry_run: bool,
}

impl Run for Rename {
    fn run(self) -> Result<()> {
        let (old, new) = match self.names.as_slice() {
            [new] => (git::current_branch()?, new.clone()),
            [old, new] => (old.clone(), new.clone()),
            _ => unreachable!("clap enforces one or two names"),
        };
        rename(&old, &new, self.dry_run)
    }
}

fn rename(old: &str, new: &str, dry_run: bool) -> Result<()> {
    stack::rename_branch(old, new, dry_run)?;

    // Best effort: an existing review still heads the old branch name, and
    // the platform does not follow local renames. Mark the rename so the next
    // submit opens a fresh review for `new` and closes the stale one.
    if let Ok((_, review_provider)) = detect_review_provider()
        && let Ok(Some(review)) = owned_review_for_branch(review_provider.as_ref(), old)
    {
        if !dry_run {
            stack::set_renamed_from(new, old)?;
        }
        anstream::println!(
            "{} review {} still heads {old}; your next submit opens a fresh \
                 review for {new} and closes {}",
            style::paint(style::WARN, "warning:"),
            review.id,
            review.id
        );
    }

    Ok(())
}