Struct Parser

pub struct Parser<'input> { /* private fields */ }

A recursive-descent parser for parsing version requirements.

Implementations

impl<'input> Parser<'input>

pub fn new(input: &'input str) -> Result<Parser<'input>, Error<'input>>

Construct a new parser for the given input.

pub fn component(&mut self) -> Result<Option<u64>, Error<'input>>

Parse a single component.

Returns None if the component is a wildcard.

pub fn numeric(&mut self) -> Result<u64, Error<'input>>

Parse a single numeric.

pub fn dot_component(&mut self) -> Result<(Option<u64>, bool), Error<'input>>

Optionally parse a dot, then a component.

The second component of the tuple indicates if a wildcard has been encountered, and is always false if the first component is Some.

If a dot is not encountered, (None, false) is returned.

If a wildcard is encountered, (None, true) is returned.

pub fn dot_numeric(&mut self) -> Result<u64, Error<'input>>

Parse a dot, then a numeric.

pub fn dot_numeric_or_zero(&mut self) -> Result<u64, Error<'input>>

Parse a dot, then a numeric. If the dot is missing, returns numeric 0. This allows us to parse versions such as “1.2”, which is a shorthand for “1.2.0”, or “1”, which is a shorthand for “1.0.0”. This is the difference between the parent and this fork.

pub fn identifier(&mut self) -> Result<Identifier, Error<'input>>

Parse an string identifier.

Like, foo, or bar, or beta-1.

pub fn version(&mut self) -> Result<Version, Error<'input>>

Parse a version.

Like, 1.0.0 or 3.0.0-beta.1.

pub fn is_eof(&mut self) -> bool

Check if we have reached the end of input.

pub fn tail(&mut self) -> Result<Vec<Token<'input>>, Error<'input>>

Get the rest of the tokens in the parser.

Useful for debugging.