Enum git_branchless_opts::Command

pub enum Command {
    Amend {
        move_options: MoveOptions,
        reparent: bool,
    },
    BugReport,
    Difftool(Opts),
    Gc,
    Hide {
        revsets: Vec<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
        delete_branches: bool,
        recursive: bool,
    },
    Hook(HookArgs),
    Init(InitArgs),
    InstallManPages(InstallManPagesArgs),
    Move {
        source: Vec<Revset>,
        base: Vec<Revset>,
        exact: Vec<Revset>,
        dest: Option<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
        move_options: MoveOptions,
        fixup: bool,
        insert: bool,
    },
    Next {
        traverse_commits_options: TraverseCommitsOptions,
    },
    Prev {
        traverse_commits_options: TraverseCommitsOptions,
    },
    Query(QueryArgs),
    Repair {
        dry_run: bool,
    },
    Restack {
        revsets: Vec<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
        move_options: MoveOptions,
    },
    Record(RecordArgs),
    Reword {
        revsets: Vec<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
        force_rewrite_public_commits: bool,
        messages: Vec<String>,
        discard: bool,
        commit_to_fixup: Option<Revset>,
    },
    Smartlog(SmartlogArgs),
    Snapshot {
        subcommand: SnapshotSubcommand,
    },
    Submit(SubmitArgs),
    Switch {
        switch_options: SwitchOptions,
    },
    Sync {
        pull: bool,
        move_options: MoveOptions,
        revsets: Vec<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
    },
    Test(TestArgs),
    Undo {
        interactive: bool,
        yes: bool,
    },
    Unhide {
        revsets: Vec<Revset>,
        resolve_revset_options: ResolveRevsetOptions,
        recursive: bool,
    },
    Wrap {
        git_executable: Option<PathBuf>,
        command: WrappedCommand,
    },
}

FIXME: write man-page text

Variants

Amend

Fields

move_options: MoveOptions

Options for moving commits.

reparent: bool

Modify the contents of the current HEAD commit, but keep all contents of descendant commits exactly the same (i.e. “reparent” them). This can be useful when applying formatting or refactoring changes.

Amend the current HEAD commit.

BugReport

Gather information about recent operations to upload as part of a bug report.

Difftool(Opts)

Use the partial commit selector UI as a Git-compatible difftool; see git-difftool(1) for more information on Git difftools.

Gc

Run internal garbage collection.

Hide

Fields

revsets: Vec<Revset>

Zero or more commits to hide.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

delete_branches: bool

Also delete any branches that are abandoned as a result of this hide.

recursive: bool

Also recursively hide all visible children commits of the provided commits.

Hide the provided commits from the smartlog.

Hook(HookArgs)

Internal use.

Init(InitArgs)

Initialize the branchless workflow for this repository.

InstallManPages(InstallManPagesArgs)

Install git-branchless’s man-pages to the given path.

Move

Fields

source: Vec<Revset>

The source commit to move. This commit, and all of its descendants, will be moved.

base: Vec<Revset>

A commit inside a subtree to move. The entire subtree, starting from the main branch, will be moved, not just the commits descending from this commit.

exact: Vec<Revset>

A set of specific commits to move. These will be removed from their current locations and any unmoved children will be moved to their nearest unmoved ancestor.

dest: Option<Revset>

The destination commit to move all source commits onto. If not provided, defaults to the current commit.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

move_options: MoveOptions

Options for moving commits.

fixup: bool

Combine the moved commits and squash them into the destination commit.

insert: bool

Insert the subtree between the destination and it’s children, if any. Only supported if the moved subtree has a single head.

Move a subtree of commits from one location to another.

By default, git move tries to move the entire current stack if you don’t pass a --source or --base option (equivalent to writing --base HEAD).

By default, git move attempts to rebase all commits in-memory. If you want to force an on-disk rebase, pass the --on-disk flag. Note that post-commit hooks are not called during in-memory rebases.

Next

Fields

traverse_commits_options: TraverseCommitsOptions

Options for traversing commits.

Move to a later commit in the current stack.

Prev

Fields

traverse_commits_options: TraverseCommitsOptions

Options for traversing commits.

Move to an earlier commit in the current stack.

Query(QueryArgs)

Query the commit graph using the “revset” language and print matching commits.

See https://github.com/arxanas/git-branchless/wiki/Reference:-Revsets to learn more about revsets.

The outputted commits are guaranteed to be topologically sorted, with ancestor commits appearing first.

Repair

Fields

dry_run: bool

Apply changes.

Restore internal invariants by reconciling the internal operation log with the state of the Git repository.

Restack

Fields

revsets: Vec<Revset>

The IDs of the abandoned commits whose descendants should be restacked. If not provided, all abandoned commits are restacked.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

move_options: MoveOptions

Options for moving commits.

Fix up commits abandoned by a previous rewrite operation.

Record(RecordArgs)

Create a commit by interactively selecting which changes to include.

Reword

Fields

revsets: Vec<Revset>

Zero or more commits to reword.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

force_rewrite_public_commits: bool

Force rewording public commits, even though other people may have access to those commits.

messages: Vec<String>

Message to apply to commits. Multiple messages will be combined as separate paragraphs, similar to git commit.

discard: bool

Throw away the original commit messages.

If commit.template is set, then the editor is pre-populated with that; otherwise, the editor starts empty.

commit_to_fixup: Option<Revset>

A commit to “fix up”. The reworded commits will become fixup! commits (suitable for use with git rebase --autosquash) targeting the supplied commit.

Reword commits.

Smartlog(SmartlogArgs)

smartlog command.

Snapshot

Fields

subcommand: SnapshotSubcommand

The subcommand to run.

Manage working copy snapshots.

Submit(SubmitArgs)

Push commits to a remote.

Switch

Fields

switch_options: SwitchOptions

Options for switching.

Switch to the provided branch or commit.

Sync

Fields

pull: bool

Run git fetch to update remote references before carrying out the sync.

move_options: MoveOptions

Options for moving commits.

revsets: Vec<Revset>

The commits whose stacks will be moved on top of the main branch. If no commits are provided, all draft commits will be synced.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

Move any local commit stacks on top of the main branch.

Test(TestArgs)

Run a command on each commit in a given set and aggregate the results.

Undo

Fields

interactive: bool

Interactively browse through previous states of the repository before selecting one to return to.

yes: bool

Skip confirmation and apply changes immediately.

Browse or return to a previous state of the repository.

Unhide

Fields

revsets: Vec<Revset>

Zero or more commits to unhide.

resolve_revset_options: ResolveRevsetOptions

Options for resolving revset expressions.

recursive: bool

Also recursively unhide all children commits of the provided commits.

Unhide previously-hidden commits from the smartlog.

Wrap

Fields

git_executable: Option<PathBuf>

The git executable to invoke.

command: WrappedCommand

The arguments to pass to git.

Wrap a Git command inside a branchless transaction.

Trait Implementations

impl CommandFactory for Command

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for Command

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Command

fn parse() -> Self

Parse from std::env::args_os(), exit on error

fn try_parse() -> Result<Self, Error<RichFormatter>>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Selfwhere I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error<RichFormatter>>where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error<RichFormatter>>where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self.

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can update self.

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand