Struct parse_changelog::Parser

pub struct Parser { /* fields omitted */ }

A changelog parser.

Implementations

impl Parser

pub fn new() -> Self

Creates a new changelog parser.

pub fn version_format(
    &mut self,
    version_format: &str
) -> Result<&mut Self, Error>

Sets the version format.

## v0.1.0 -- 2020-01-01
    ^^^^^

The default version format is based on Semantic Versioning and is the following regular expression:

^\d+\.\d+\.\d+(-[\w\.-]+)?(\+[\w\.-]+)?

Note: Most projects that adopt Semantic Versioning do not need to change this.

To customize the text before the version number (e.g., “v” in “# v0.1.0”, “Version “ in “# Version 0.1.0”, etc.), use the prefix_format method instead of this method.

Errors

Returns an error if any of the following:

• The specified format is not a valid regular expression or supported by regex crate.
• The specified format is empty or contains only whitespace.

pub fn prefix_format(&mut self, prefix_format: &str) -> Result<&mut Self, Error>

Sets the prefix format.

“Prefix” means the range from the first non-whitespace character after heading to the character before the version (including whitespace characters). For example:

## Version 0.1.0 -- 2020-01-01
   ^^^^^^^^

## v0.1.0 -- 2020-01-01
   ^

The default prefix format is the following regular expression:

^(v|Version |Release )?

Errors

Returns an error if any of the following:

• The specified format is not a valid regular expression or supported by regex crate.
• The specified format is empty or contains only whitespace.

pub fn parse<'a>(&self, text: &'a str) -> Result<Changelog<'a>, Error>

Parses release notes from the given text.

See crate level documentation for changelog and version format supported by default.

Errors

Returns an error if any of the following:

• There are multiple release notes for one version.
• No release was found. This usually means that the changelog isn’t written in the supported format, or that the specified format is wrong if you specify your own format.

pub fn parse_iter<'a, 'b>(&'b self, text: &'a str) -> ParseIter<'a, 'b>

An iterator over all release notes in the given text.

Unlike parse method, this method doesn’t error on duplicate release notes or empty changelog.

See crate level documentation for changelog and version format supported by default.

Trait Implementations

impl Debug for Parser

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

Formats the value using the given formatter.

impl Default for Parser

fn default() -> Parser

Returns the “default value” for a type.