Struct git_cliff::args::Opt

pub struct Opt {

    pub verbose: u8,
    pub config: PathBuf,
    pub workdir: Option<PathBuf>,
    pub repository: Option<PathBuf>,
    pub include_path: Option<Vec<Pattern>>,
    pub exclude_path: Option<Vec<Pattern>>,
    pub with_commit: Option<Vec<String>>,
    pub prepend: Option<PathBuf>,
    pub output: Option<PathBuf>,
    pub tag: Option<String>,
    pub body: Option<String>,
    pub init: bool,
    pub latest: bool,
    pub current: bool,
    pub unreleased: bool,
    pub topo_order: bool,
    pub context: bool,
    pub strip: Option<Strip>,
    pub sort: Sort,
    pub range: Option<String>,
}

Command-line arguments to parse.

Fields

verbose: u8

Increases the logging verbosity.

config: PathBuf

Sets the configuration file.

workdir: Option<PathBuf>

Sets the working directory.

repository: Option<PathBuf>

Sets the git repository.

include_path: Option<Vec<Pattern>>

Sets the path to include related commits.

exclude_path: Option<Vec<Pattern>>

Sets the path to exclude related commits.

with_commit: Option<Vec<String>>

Sets custom commit messages to include in the changelog.

prepend: Option<PathBuf>

Prepends entries to the given changelog file.

output: Option<PathBuf>

Writes output to the given file.

tag: Option<String>

Sets the tag for the latest version.

body: Option<String>

Sets the template for the changelog body.

init: bool

Writes the default configuration file to cliff.toml

latest: bool

Processes the commits starting from the latest tag.

current: bool

Processes the commits that belong to the current tag.

unreleased: bool

Processes the commits that do not belong to a tag.

topo_order: bool

Sorts the tags topologically.

context: bool

Prints changelog context as JSON.

strip: Option<Strip>

Strips the given parts from the changelog.

sort: Sort

Sets sorting of the commits inside sections.

range: Option<String>

Sets the commit range to process.

Trait Implementations

impl Args for Opt

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

Append to Command so it can instantiate Self.

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

Append to Command so it can update self.

impl CommandFactory for Opt

fn into_app<'b>() -> Command<'b>

Deprecated, replaced with CommandFactory::command

fn into_app_for_update<'b>() -> Command<'b>

Deprecated, replaced with CommandFactory::command_for_update

fn command<'help>() -> App<'help>

Build a Command that can instantiate Self.

fn command_for_update<'help>() -> App<'help>

Build a Command that can update self.

impl Debug for Opt

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

Formats the value using the given formatter.

impl FromArgMatches for Opt

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 Opt

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) -> 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>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.