git_stk/
cli.rs

1use clap::{ArgAction, Parser, Subcommand};
2
3#[derive(Debug, Parser)]
4#[command(name = "git-stk")]
5#[command(about = "Git-native stacked branch workflow helper, with GitHub and GitLab integration")]
6pub struct Cli {
7    #[command(subcommand)]
8    pub command: Command,
9}
10
11#[derive(Debug, Subcommand)]
12pub enum Command {
13    /// Create a new child branch from the current branch.
14    New { branch: String },
15    /// Print a branch's stack parent.
16    Parent { branch: Option<String> },
17    /// Print a branch's stack children.
18    Children { branch: Option<String> },
19    /// Check out the current branch's stack parent.
20    Up,
21    /// Check out a stack child of the current branch.
22    Down { branch: Option<String> },
23    /// Print the current stack.
24    List,
25    /// Print local and remote stack status for a branch.
26    Status { branch: Option<String> },
27    /// Attach an existing branch to a parent.
28    Adopt {
29        branch: String,
30        #[arg(long)]
31        parent: String,
32    },
33    /// Remove stack parent metadata from a branch.
34    Detach { branch: Option<String> },
35    /// Rebase the current branch and descendants onto their stack parents.
36    Restack {
37        /// Pass --update-refs to git rebase.
38        #[arg(long, action = ArgAction::SetTrue, conflicts_with = "no_update_refs")]
39        update_refs: bool,
40        /// Do not pass --update-refs to git rebase.
41        #[arg(long, action = ArgAction::SetTrue)]
42        no_update_refs: bool,
43    },
44    /// Continue an interrupted restack after resolving conflicts.
45    Continue,
46    /// Abort an interrupted restack.
47    Abort,
48    /// Print detected review provider.
49    Provider,
50    /// Print the review request for a branch.
51    Review { branch: Option<String> },
52    /// Sync local stack metadata from remote review requests.
53    Sync {
54        branch: Option<String>,
55        /// Print what would change without updating local metadata.
56        #[arg(long, action = ArgAction::SetTrue)]
57        dry_run: bool,
58    },
59    /// Create or update a remote review request for a branch.
60    Submit {
61        branch: Option<String>,
62        /// Print what would change without creating or updating reviews.
63        #[arg(long, action = ArgAction::SetTrue)]
64        dry_run: bool,
65        /// Submit the branch and its descendants parent-first.
66        #[arg(long, conflicts_with = "branch")]
67        stack: bool,
68    },
69    /// Print shell completions.
70    Completions {
71        /// Shell to print completions for.
72        #[arg(value_enum)]
73        shell: clap_complete::Shell,
74    },
75    /// Upgrade git-stk to the latest release.
76    Upgrade {
77        /// Build and install the latest unreleased commit instead.
78        #[arg(long, action = ArgAction::SetTrue, conflicts_with = "force")]
79        head: bool,
80        /// Reinstall the latest release even when already up to date.
81        #[arg(long, action = ArgAction::SetTrue)]
82        force: bool,
83        /// Skip the --head confirmation prompt.
84        #[arg(long, short = 'y', action = ArgAction::SetTrue, requires = "head")]
85        yes: bool,
86    },
87    /// Clean up local metadata for merged review requests.
88    Cleanup {
89        branch: Option<String>,
90        /// Print what would change without updating local metadata.
91        #[arg(long, action = ArgAction::SetTrue)]
92        dry_run: bool,
93        /// Delete cleaned merged branches after updating stack metadata.
94        #[arg(long, action = ArgAction::SetTrue)]
95        delete_branch: bool,
96    },
97}
98
99#[derive(Debug, Clone, Copy, Eq, PartialEq)]
100pub enum UpdateRefsMode {
101    Config,
102    Enabled,
103    Disabled,
104}
105
106impl UpdateRefsMode {
107    pub fn from_flags(update_refs: bool, no_update_refs: bool) -> Self {
108        match (update_refs, no_update_refs) {
109            (true, false) => Self::Enabled,
110            (false, true) => Self::Disabled,
111            _ => Self::Config,
112        }
113    }
114}
git_stk/cli.rs

git_stk/
cli.rs
