Struct Cli 

pub struct Cli {
    pub command: Commands,
    pub output: Option<CliOutputMode>,
    pub no_color: bool,
    pub repo: Option<PathBuf>,
    pub verbose: u8,
    pub quiet: bool,
    pub op_id: Option<String>,
}

Heddle: An AI-native version control system.

Fields

command: Commands

output: Option<CliOutputMode>

Output format: text (default), json, or json-compact. See heddle help output-formats

no_color: bool

Disable colored output.

repo: Option<PathBuf>

Repository path (default: find .heddle in ancestors).

verbose: u8

Increase verbosity.

quiet: bool

Decrease verbosity.

op_id: Option<String>

Operation id (UUID v4) for idempotent retries. See heddle help operation-ids

Implementations

impl Cli

pub fn user_config_or_exit() -> &'static UserConfig

Load and cache the process-wide user configuration.

pub fn output_mode(&self) -> Option<OutputMode>

pub fn open_repo(&self) -> Result<Repository>

Open the Heddle repository the command should act on: the --repo path if given, otherwise the current working directory (resolved lazily so a supplied --repo never touches the cwd).

Trait Implementations

impl Args for Cli

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

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

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

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

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl CliContext for Cli

fn repo_path(&self) -> Option<&Path>

--repo override; None means “use the process’s current directory.”

fn operation_id_wire(&self) -> String

--op-id override for idempotent gRPC calls. Empty string means the caller did not supply one and the server should not dedupe.

fn should_output_json(&self, repo_config: Option<&Config>) -> bool

Resolves whether output should be JSON, encapsulating the precedence between the --json / --output cli flags, the user’s global config, and (when supplied) the repo’s output.format config. Hosted commands typically pass Some(repo.config()) after opening the repo and None otherwise.

impl CommandFactory for Cli

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 FromArgMatches for Cli

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( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Cli

fn parse() -> Self

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

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

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

fn parse_from<I, T>(itr: I) -> Self

where 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>

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>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.