Struct PackageInfoV2

pub struct PackageInfoV2 {

    pkgname: Name,
    pkgbase: Name,
    pkgver: Version,
    pkgdesc: PackageDescription,
    url: Url,
    builddate: BuildDate,
    packager: Packager,
    size: InstalledSize,
    arch: Architecture,
    license: Vec<License>,
    replaces: Vec<PackageRelation>,
    group: Vec<Group>,
    conflict: Vec<PackageRelation>,
    provides: Vec<RelationOrSoname>,
    backup: Vec<Backup>,
    depend: Vec<RelationOrSoname>,
    optdepend: Vec<OptionalDependency>,
    makedepend: Vec<PackageRelation>,
    checkdepend: Vec<PackageRelation>,
    xdata: Vec<ExtraData>,
}

PKGINFO version 2

PackageInfoV2 is (exclusively) compatible with data following the v2 specification of the PKGINFO file.

Examples

use std::str::FromStr;

use alpm_pkginfo::PackageInfoV2;

let pkginfo_data = r#"pkgname = example
pkgbase = example
xdata = pkgtype=pkg
pkgver = 1:1.0.0-1
pkgdesc = A project that does something
url = https://example.org/
builddate = 1729181726
packager = John Doe <john@example.org>
size = 181849963
arch = any
license = GPL-3.0-or-later
license = LGPL-3.0-or-later
replaces = other-package>0.9.0-3
group = package-group
group = other-package-group
conflict = conflicting-package<1.0.0
conflict = other-conflicting-package<1.0.0
provides = some-component
provides = some-other-component=1:1.0.0-1
provides = libexample.so=1-64
provides = libunversionedexample.so=libunversionedexample.so-64
provides = lib:libexample.so.1
backup = etc/example/config.toml
backup = etc/example/other-config.txt
depend = glibc
depend = gcc-libs
depend = libother.so=0-64
depend = libunversioned.so=libunversioned.so-64
depend = lib:libother.so.0
optdepend = python: for special-python-script.py
optdepend = ruby: for special-ruby-script.rb
makedepend = cmake
makedepend = python-sphinx
checkdepend = extra-test-tool
checkdepend = other-extra-test-tool"#;
let pkginfo = PackageInfoV2::from_str(pkginfo_data)?;
assert_eq!(pkginfo.to_string(), pkginfo_data);

Fields

pkgname: Name

pkgbase: Name

pkgver: Version

pkgdesc: PackageDescription

url: Url

builddate: BuildDate

packager: Packager

size: InstalledSize

arch: Architecture

license: Vec<License>

replaces: Vec<PackageRelation>

group: Vec<Group>

conflict: Vec<PackageRelation>

provides: Vec<RelationOrSoname>

backup: Vec<Backup>

depend: Vec<RelationOrSoname>

optdepend: Vec<OptionalDependency>

makedepend: Vec<PackageRelation>

checkdepend: Vec<PackageRelation>

xdata: Vec<ExtraData>

Implementations

impl PackageInfoV2

pub fn pkgname(&self) -> &Name

Returns the name of the package

pub fn pkgbase(&self) -> &Name

Returns the base name of the package

pub fn pkgver(&self) -> &Version

Returns the version of the package

pub fn pkgdesc(&self) -> &PackageDescription

Returns the description of the package

pub fn url(&self) -> &Url

Returns the URL of the package

pub fn builddate(&self) -> &BuildDate

Returns the build date of the package

pub fn packager(&self) -> &Packager

Returns the packager of the package

pub fn size(&self) -> &InstalledSize

Returns the size of the package

pub fn arch(&self) -> &Architecture

Returns the architecture of the package

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

Returns the licenses of the package

pub fn replaces(&self) -> &[PackageRelation]

Returns the packages this package replaces

pub fn group(&self) -> &[Group]

Returns the group of the package

pub fn conflict(&self) -> &[PackageRelation]

Returns the packages this package conflicts with

pub fn provides(&self) -> &[RelationOrSoname]

Returns the packages this package provides

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

Returns the backup files of the package

pub fn depend(&self) -> &[RelationOrSoname]

Returns the packages this package depends on

pub fn optdepend(&self) -> &[OptionalDependency]

Returns the optional dependencies of the package

pub fn makedepend(&self) -> &[PackageRelation]

Returns the packages this package is built with

pub fn checkdepend(&self) -> &[PackageRelation]

Returns the packages this package is checked with

impl PackageInfoV2

pub fn new( pkgname: Name, pkgbase: Name, pkgver: Version, pkgdesc: PackageDescription, url: Url, builddate: BuildDate, packager: Packager, size: InstalledSize, arch: Architecture, license: Vec<License>, replaces: Vec<PackageRelation>, group: Vec<Group>, conflict: Vec<PackageRelation>, provides: Vec<RelationOrSoname>, backup: Vec<Backup>, depend: Vec<RelationOrSoname>, optdepend: Vec<OptionalDependency>, makedepend: Vec<PackageRelation>, checkdepend: Vec<PackageRelation>, xdata: Vec<ExtraData>, ) -> Result<Self, Error>

Create a new PackageInfoV2 from all required components

pub fn xdata(&self) -> &Vec<ExtraData>

Get the extra data

pub fn pkg_type(&self) -> PackageType

Returns the package type.

Panics

This function panics if the xdata field does not contain a pkgtype key.

fn check_pkg_type(&self) -> Result<(), Error>

Checks if the package type exists.

Errors

This function returns an error in the following cases:

• if the xdata field does not contain a pkgtype key.
• if the pkgtype key does not contain a valid package type.

Trait Implementations

impl Clone for PackageInfoV2

fn clone(&self) -> PackageInfoV2

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PackageInfoV2

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PackageInfoV2

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PackageInfoV2

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

Formats the value using the given formatter.

impl FromStr for PackageInfoV2

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

Create a PackageInfoV2 from a &str

Errors

Returns an Error if any of the fields in input can not be validated according to PackageInfoV2 or their respective own specification.

type Err = Error

The associated error which can be returned from parsing.

impl Serialize for PackageInfoV2

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

where __S: Serializer,

Serialize this value into the given Serde serializer.