Struct RevParseCommand 

pub struct RevParseCommand {
    pub executor: CommandExecutor,
    pub rev_args: Vec<String>,
    pub verify: bool,
    pub abbrev_ref: bool,
    pub short: Option<Option<u32>>,
    pub show_toplevel: bool,
    pub git_dir: bool,
    pub is_inside_work_tree: bool,
    pub is_bare_repository: bool,
    pub absolute_git_dir: bool,
}

Builder for git rev-parse.

Fields

executor: CommandExecutor

Shared executor.

rev_args: Vec<String>

Arguments / refs / flags to pass to rev-parse.

verify: bool

--verify.

abbrev_ref: bool

--abbrev-ref.

short: Option<Option<u32>>

--short[=N].

show_toplevel: bool

--show-toplevel.

git_dir: bool

--git-dir.

is_inside_work_tree: bool

--is-inside-work-tree.

is_bare_repository: bool

--is-bare-repository.

absolute_git_dir: bool

--absolute-git-dir.

Implementations

impl RevParseCommand

pub fn new() -> Self

New empty rev-parse command.

pub fn arg_str(&mut self, s: impl Into<String>) -> &mut Self

Add a ref/rev string (e.g. "HEAD", "main", "HEAD~3").

pub fn verify(&mut self) -> &mut Self

--verify: error if the argument is not a valid object.

pub fn abbrev_ref(&mut self) -> &mut Self

--abbrev-ref: print the short ref name.

pub fn short(&mut self) -> &mut Self

--short with default length.

pub fn short_len(&mut self, n: u32) -> &mut Self

--short=N.

pub fn show_toplevel(&mut self) -> &mut Self

--show-toplevel.

pub fn git_dir(&mut self) -> &mut Self

--git-dir.

pub fn absolute_git_dir(&mut self) -> &mut Self

--absolute-git-dir.

pub fn is_inside_work_tree(&mut self) -> &mut Self

--is-inside-work-tree.

pub fn is_bare_repository(&mut self) -> &mut Self

--is-bare-repository.

Trait Implementations

impl Clone for RevParseCommand

fn clone(&self) -> RevParseCommand

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RevParseCommand

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

Formats the value using the given formatter.

impl Default for RevParseCommand

fn default() -> RevParseCommand

Returns the “default value” for a type.

impl GitCommand for RevParseCommand

type Output = String

Trimmed stdout — typically a SHA, path, or true/false string.

fn get_executor(&self) -> &CommandExecutor

Borrow the shared executor.

fn get_executor_mut(&mut self) -> &mut CommandExecutor

Mutably borrow the shared executor.

fn build_command_args(&self) -> Vec<String>

Build the full argument vector (subcommand + flags + positionals) excluding the leading git program.

fn execute<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Run the command and decode its output into Self::Output.

fn execute_raw<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait,

Spawn git with the given arguments and return the raw output.

fn arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut Self

Append a single raw argument.

fn args<I, S>(&mut self, args: I) -> &mut Self

where I: IntoIterator<Item = S>, S: AsRef<OsStr>,

Append several raw arguments.

fn flag(&mut self, flag: &str) -> &mut Self

Append a --flag (or -f if a single character).

fn option(&mut self, key: &str, value: &str) -> &mut Self

Append a --key value pair.

fn current_dir<P: Into<PathBuf>>(&mut self, dir: P) -> &mut Self

Run git in the given working directory.

fn env<K: Into<OsString>, V: Into<OsString>>( &mut self, key: K, value: V, ) -> &mut Self

Set an environment variable for this invocation.

fn with_timeout(&mut self, timeout: Duration) -> &mut Self

Cap execution time. On expiry the process is killed and Error::Timeout is returned.

fn with_timeout_secs(&mut self, seconds: u64) -> &mut Self

Convenience: set timeout in whole seconds.