Struct Srcinfo

#[non_exhaustive]
pub struct Srcinfo {
    pub comment: String,
    pub base: PackageBase,
    pub pkg: Package,
    pub pkgs: Vec<Package>,
}

A complete representation of a .SRCINFO file.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

comment: String

The header comment

base: PackageBase

Fields belonging to the pkgbase

pkg: Package

Fields belonging to the pkgbase, may be overridden inside of each package

pkgs: Vec<Package>

The packages this .SRCINFO contains

Implementations

impl Srcinfo

pub fn from_buf<T: BufRead>(b: T) -> Result<Srcinfo, Error>

Parse a BufRead. If you are parsing a string directly from_str() should be used instead.

// from_str() would be better here.
// from_buf() is only used for the sake of example.
use srcinfo::Srcinfo;

let buf = "
pkgbase = example
pkgver = 1.5.0
pkgrel = 5

pkgname = example".as_bytes();

Srcinfo::from_buf(buf)?;

pub fn from_path<P: AsRef<Path>>(s: P) -> Result<Srcinfo, Error>

Parse the file at a given path.

use srcinfo::Srcinfo;

let file = ".SRCINFO";
let srcinfo = Srcinfo::from_path(file)?;

pub fn version(&self) -> String

Builds a complete version string in the format: “epoch-pkgver-pkgrel”.

If the epoch is none then the epoch and connecting hyphen will be omitted.

use srcinfo::Srcinfo;

let srcinfo: Srcinfo = "
pkgbase = example
pkgver = 1.5.0
pkgrel = 5

pkgname = example".parse()?;

assert_eq!(srcinfo.version(), "1.5.0-5");

pub fn pkgnames(&self) -> impl Iterator<Item = &str>

Returns an Iterator over all the pkgnames the Package contains.

use srcinfo::Srcinfo;

let srcinfo: Srcinfo = "
pkgbase = example
pkgver = 1.5.0
pkgrel = 5
pkgdesc = 1

pkgname = example

pkgname = foo
pkgdesc = 2

pkgname = bar
pkgdesc = 3".parse()?;

let mut names = srcinfo.pkgnames().collect::<Vec<_>>();
assert_eq!(names, vec!["example", "foo", "bar"]);

pub fn pkg<S: AsRef<str>>(&self, name: S) -> Option<&Package>

Searches for a package with a given pkgname

use srcinfo::Srcinfo;

let srcinfo: Srcinfo = "
pkgbase = example
pkgver = 1.5.0
pkgrel = 5
pkgdesc = 1

pkgname = example

pkgname = foo
pkgdesc = 2

pkgname = bar
pkgdesc = 3".parse()?;

let pkg = srcinfo.pkg("foo").unwrap();
assert_eq!(pkg.pkgname, "foo");

pub fn pkgs(&self) -> &[Package]

Returns the list of packages in this Srcinfo

pub fn comment(&self) -> &str

pub fn pkgbase(&self) -> &str

pub fn pkgver(&self) -> &str

pub fn pkgrel(&self) -> &str

pub fn epoch(&self) -> Option<&str>

pub fn source(&self) -> &ArchVecs

pub fn valid_pgp_keys(&self) -> &[String]

pub fn no_extract(&self) -> &[String]

pub fn md5sums(&self) -> &ArchVecs

pub fn sha1sums(&self) -> &ArchVecs

pub fn sha224sums(&self) -> &ArchVecs

pub fn sha256sums(&self) -> &ArchVecs

pub fn sha384sums(&self) -> &ArchVecs

pub fn sha512sums(&self) -> &ArchVecs

pub fn b2sums(&self) -> &ArchVecs

pub fn makedepends(&self) -> &ArchVecs

pub fn checkdepends(&self) -> &ArchVecs

pub fn pkgdesc(&self) -> Option<&str>

pub fn arch(&self) -> &[String]

pub fn url(&self) -> Option<&str>

pub fn license(&self) -> &[String]

pub fn groups(&self) -> &[String]

pub fn depends(&self) -> &ArchVecs

pub fn optdepends(&self) -> &ArchVecs

pub fn provides(&self) -> &ArchVecs

pub fn conflicts(&self) -> &ArchVecs

pub fn replaces(&self) -> &ArchVecs

pub fn backup(&self) -> &[String]

pub fn options(&self) -> &[String]

pub fn install(&self) -> Option<&str>

pub fn changelog(&self) -> Option<&str>

Trait Implementations

impl Clone for Srcinfo

fn clone(&self) -> Srcinfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Srcinfo

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

Formats the value using the given formatter.

impl Default for Srcinfo

fn default() -> Srcinfo

Returns the “default value” for a type.

impl Display for Srcinfo

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

Formats the value using the given formatter.

impl FromStr for Srcinfo

type Err = Error

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl Hash for Srcinfo

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Srcinfo

fn cmp(&self, other: &Srcinfo) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Srcinfo

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

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

const 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 PartialOrd for Srcinfo

fn partial_cmp(&self, other: &Srcinfo) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Srcinfo

impl StructuralPartialEq for Srcinfo