Struct Version

Source

pub struct Version {
    pub epoch: Option<u32>,
    pub upstream_version: String,
    pub debian_revision: Option<String>,
}

Expand description

A Debian version string

Fields§

§epoch: Option<u32>

The epoch of the version, if any

§upstream_version: String

The upstream version

§debian_revision: Option<String>

The Debian revision, if any

Implementations§

Source §

impl Version

Source

pub fn parse_lenient(text: &str) -> Result<Version, ParseError>

Parse a version string with lenient parsing rules.

This method accepts version strings that may not strictly comply with Debian Policy, such as versions containing underscores. While the standard FromStr implementation enforces strict Debian Policy compliance, this method is more permissive to handle real-world packages that may use non-standard characters.

§Examples

use debversion::Version;
// This version contains underscores, which violates Debian Policy
// but may appear in real-world packages
let v = Version::parse_lenient("2.0.37+cvs.JCW_PRE2_2037-1").unwrap();
assert_eq!(v.upstream_version, "2.0.37+cvs.JCW_PRE2_2037");
assert_eq!(v.debian_revision, Some("1".to_string()));

Source

pub fn is_bin_nmu(&self) -> bool

Is this a binNMU?

A binNMU is a binary-only NMU (Non-Maintainer Upload) where the source package is not changed.

Note that this checks for the presence of the +b[:digit:] suffix, which is not part of the Debian Policy Manual, but it is commonly used to indicate a binNMU.

§Examples

use debversion::Version;
assert!("1.0+b1".parse::<Version>().unwrap().is_bin_nmu());
assert!("1.0-1+b1".parse::<Version>().unwrap().is_bin_nmu());
assert!(!"1.0-1".parse::<Version>().unwrap().is_bin_nmu());
assert!(!"1.0".parse::<Version>().unwrap().is_bin_nmu());

Source

pub fn bin_nmu_count(&self) -> Option<i32>

Return the binNMU count of this version

This will return the binNMU count of this version, or None if this is not a binNMU.

Source

pub fn increment_bin_nmu(self) -> Version

Create a binNMU version from this version

This will increment the binNMU suffix by one, or add a +b1 suffix if there is no binNMU suffix.

Source

pub fn is_nmu(&self) -> bool

Check if this version is a sourceful NMU

A sourceful NMU is a Non-Maintainer Upload where the source package is changed.

This recognises two conventions:

a +nmu[:digit:] suffix, used for native packages (and sometimes derivatives). This is not part of the Debian Policy Manual, but it is commonly used to indicate a sourceful NMU.
the classic non-native form, where the Debian revision of the last maintainer upload is extended with a .[:digit:] component, e.g. 1 becomes 1.1 and 2.1 becomes 2.2.

Source

pub fn nmu_count(&self) -> Option<i32>

Return the sourceful NMU count of this version

This will return the sourceful NMU count of this version, or None if this is not a sourceful NMU. See Version::is_nmu for the conventions that are recognised.

Source

pub fn is_backport(&self) -> bool

Check if this version is a backport.

Backports use a ~bpoN+M suffix, where N is the Debian release number being targeted and M the backport revision, e.g. 1.0-1~bpo12+1. Such uploads are made by the maintainer and are exempt from the sourceful NMU check.

§Examples

use debversion::Version;
assert!("1.0-1~bpo12+1".parse::<Version>().unwrap().is_backport());
assert!("1.0-1~bpo11+2".parse::<Version>().unwrap().is_backport());
assert!(!"1.0-1".parse::<Version>().unwrap().is_backport());

Source

pub fn is_stable_update(&self) -> bool

Check if this version is a stable or security update.

Stable and security updates use a ~debNuM or +debNuM suffix, where N is the Debian release number and M the update revision, e.g. 1.0-1+deb12u1. Such uploads are exempt from the sourceful NMU check.

§Examples

use debversion::Version;
assert!("1.0-1+deb12u1".parse::<Version>().unwrap().is_stable_update());
assert!("1.0-1~deb11u2".parse::<Version>().unwrap().is_stable_update());
assert!(!"1.0-1".parse::<Version>().unwrap().is_stable_update());

Source

pub fn canonicalize(&self) -> Version

Return canonicalized version of this version

§Examples

use debversion::Version;
assert_eq!("1.0-0".parse::<Version>().unwrap().canonicalize(), "1.0".parse::<Version>().unwrap());
assert_eq!("1.0-1".parse::<Version>().unwrap().canonicalize(), "1.0-1".parse::<Version>().unwrap());

Source

pub fn increment_debian(&mut self)

Increment the Debian revision.

For native packages, increment the upstream version number. For other packages, increment the debian revision.

Source

pub fn is_native(&self) -> bool

Return true if this is a native package

Source

pub fn bump_nmu(self) -> Version

Create a sourceful NMU version from this version.

For native packages (those without a Debian revision), this appends a +nmu1 suffix to the upstream version, or bumps an existing +nmuN suffix.

For non-native packages, the Debian revision is bumped following the NMU convention: 1 becomes 1.1, 2 becomes 2.1 (first NMU) and 1.1 becomes 1.2 (further NMU). For revisions that don’t follow the plain integer or integer.integer shape (e.g. 1ubuntu1), where the correct NMU revision cannot be derived mechanically, a +nmuN suffix is appended to the Debian revision instead.

§Examples

use debversion::Version;
assert_eq!(
    "1.0".parse::<Version>().unwrap().bump_nmu(),
    "1.0+nmu1".parse().unwrap()
);
assert_eq!(
    "1.0+nmu1".parse::<Version>().unwrap().bump_nmu(),
    "1.0+nmu2".parse().unwrap()
);
assert_eq!(
    "1.0-1".parse::<Version>().unwrap().bump_nmu(),
    "1.0-1.1".parse().unwrap()
);
assert_eq!(
    "1.0-2.1".parse::<Version>().unwrap().bump_nmu(),
    "1.0-2.2".parse().unwrap()
);