Enum Source

pub enum Source {
    File {
        filename: Option<PathBuf>,
        location: PathBuf,
    },
    Url {
        filename: Option<PathBuf>,
        url: Url,
    },
}

Represents the location that a source file should be retrieved from

It can be either a local file (next to the PKGBUILD) or a URL.

Variants

File

A local file source.

The location must be a pure file name, without any path components (/). Hence, the file must be located directly next to the PKGBUILD.

Fields

filename: Option<PathBuf>

location: PathBuf

Url

A URL source.

Fields

filename: Option<PathBuf>

url: Url

Implementations

impl Source

pub fn filename(&self) -> Option<&PathBuf>

Returns the filename of the source if it is set.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl Display for Source

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

Formats the value using the given formatter.

impl FromStr for Source

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

Parses a Source from string.

It is either a filename (in the same directory as the PKGBUILD) or a url, optionally prefixed by a destination file name (separated by ::).

Errors

This function returns an error in the following cases:

• The destination file name or url/source file name are malformed.
• The source file name is an absolute path.

Examples

use std::path::Path;
use std::str::FromStr;

use alpm_types::Source;
use url::Url;

let source = Source::from_str("foopkg-1.2.3.tar.gz::https://example.com/download").unwrap();
assert_eq!(source.filename().unwrap(), Path::new("foopkg-1.2.3.tar.gz"));

let Source::Url { url, .. } = source else {
    panic!()
};
assert_eq!(url.host_str(), Some("example.com"));

let source = Source::from_str("renamed-source.tar.gz::test.tar.gz").unwrap();
assert_eq!(
    source.filename().unwrap(),
    Path::new("renamed-source.tar.gz")
);

let Source::File { location, .. } = source else {
    panic!()
};
assert_eq!(location, Path::new("test.tar.gz"));

type Err = Error

The associated error which can be returned from parsing.

impl PartialEq for Source

fn eq(&self, other: &Source) -> 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 Eq for Source

impl StructuralPartialEq for Source