Struct SourceUrl 

pub struct SourceUrl {
    pub url: Url,
    pub vcs_info: Option<VcsInfo>,
}

A URL for package sources.

Wraps the Url type and provides optional information on VCS systems.

Can be created from custom URL strings, that in part resemble the default URL syntax, e.g.:

git+https://example.org/example-project.git#tag=v1.0.0?signed

The above example provides an overview of the custom URL syntax:

• The optional VCS specifier git is prepended, directly followed by a “+” sign as delimiter,
• specific URL fragment types such as tag are used to encode information about the particular VCS objects to address,
• the URL query component signed is used to indicate that OpenPGP signature verification is required for a VCS type.

Note

The URL format used by SourceUrl deviates from the default URL syntax by allowing to change the order of the query and fragment component!

Refer to the alpm-package-source documentation for a more detailed overview of the custom URL syntax.

Examples

use std::str::FromStr;

use alpm_types::SourceUrl;

// Create Url from &str
let url =
    SourceUrl::from_str("git+https://your-vcs.org/example-project.git?signed#tag=v1.0.0")?;
assert_eq!(
    &url.to_string(),
    "git+https://your-vcs.org/example-project.git?signed#tag=v1.0.0"
);

Fields

url: Url

The URL from where the sources are retrieved.

vcs_info: Option<VcsInfo>

Optional data on VCS systems using the URL for the retrieval of sources.

Trait Implementations

impl Clone for SourceUrl

fn clone(&self) -> SourceUrl

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SourceUrl

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SourceUrl

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SourceUrl

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

Formats the value using the given formatter.

impl FromStr for SourceUrl

fn from_str(s: &str) -> Result<Self, Self::Err>

Creates a SourceUrl from a string slice.

Delegates to SourceUrl::parser_until.

Errors

Returns an error if SourceUrl::parser_until fails.

Examples

use std::str::FromStr;

use alpm_types::SourceUrl;

let url =
    SourceUrl::from_str("git+https://your-vcs.org/example-project.git?signed#tag=v1.0.0")?;
assert_eq!(
    &url.to_string(),
    "git+https://your-vcs.org/example-project.git?signed#tag=v1.0.0"
);

type Err = Error

The associated error which can be returned from parsing.

impl ParserUntil for SourceUrl

For SourceUrl, we only define a ParserUntil trait and not the AlpmParser trait, as we don’t provide the Url type parser ourselves. Hence, the indicator for its supposed “end” must be provided by the caller of the parser.

fn parser_until<'a, P>( delimiter: P, ) -> impl Parser<&'a str, Self, ErrMode<ContextError>>

where P: Parser<&'a str, &'a str, ErrMode<ContextError>>,

Recognizes an SourceUrl in an input string until a given delimiter.

Errors

Returns an error if input does not begin with a valid SourceUrl, followed by the specified delimiter.

fn parser_until_eof(input: &mut &str) -> Result<Self, ErrMode<ContextError>>

Returns a [Parser] that parses an entire input.

fn parser_until_line_ending( input: &mut &str, ) -> Result<Self, ErrMode<ContextError>>

Returns a [Parser] that parses until the end of line or [eof].

impl PartialEq for SourceUrl

fn eq(&self, other: &SourceUrl) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SourceUrl

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SourceUrl

impl StructuralPartialEq for SourceUrl