Struct NetrcParser

pub struct NetrcParser<R: Read> { /* private fields */ }

Netrc parser mimicking the curl netrc parsers rules. This is a high level parser and is recommended to be used for most use-cases. For a lower-level alternative, use crate::raw_netrc_parser::RawNetrcParser.

Implementations

impl<R: Read> NetrcParser<R>

pub fn new(buffer: R) -> Self

Create a new parser from a buffer

pub fn entry_for_host(&mut self, host: &Host) -> Result<Option<ValidatedEntry>>

Parse the config file from the constructor and attempt to find the entry related to the given host.

This method follows the following rules:

• A entry must have a password and may have a login
• Incomplete entries cannot fallback to the default entry
• Field cannot be mixed with fields from the default entry
• If the login is missing, the account value is used instead

Invalid entries are filtered out from the resulting set.

Returns

• An error if reading the input buffer failed
• Ok(None) if the host was not found and no default was setup
• Ok(Some) if either a default was setup or the host was found

Trait Implementations

impl<R: Debug + Read> Debug for NetrcParser<R>

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

Formats the value using the given formatter.