Enum PartialVersion 

pub enum PartialVersion {
    Pre10m(u32, u32),
    Pre10mm(u32, u32, u32),
    Post10m(u32),
    Post10mm(u32, u32),
}

Represents a PostgreSQL version with some parts missing. This is the kind of thing we might find in a cluster’s PG_VERSION file.

The “Version” column on the PostgreSQL “Versioning Policy” page is roughly what this models, but this can also optionally represent the “Current minor” column too.

Variants

Pre10m(u32, u32)

Pre-PostgreSQL 10, with major and point version numbers, e.g. 9.6. It is an error to create this variant with a major number >= 10; see checked for a way to guard against this.

Pre10mm(u32, u32, u32)

Pre-PostgreSQL 10, with major, point, and minor version numbers, e.g. 9.6.17. It is an error to create this variant with a major number >=§ 10; see checked for a way to guard against this.

Post10m(u32)

PostgreSQL 10+, with major version number, e.g. 10. It is an error to create this variant with a major number < 10; see checked for a way to guard against this.

Post10mm(u32, u32)

PostgreSQL 10+, with major and minor version number, e.g. 10.3. It is an error to create this variant with a major number < 10; see checked for a way to guard against this.

Implementations

impl PartialVersion

pub fn checked(self) -> Result<Self, VersionError>

Return self if it is a valid PartialVersion.

This can be necessary when a PartialVersion has been constructed directly. It checks that PartialVersion::Pre10m and PartialVersion::Pre10mm have a major version number less than 10, and that PartialVersion::Post10m and PartialVersion::Post10mm have a major version number greater than or equal to 10.

pub fn compatible(&self, version: Version) -> bool

Is the given Version compatible with this PartialVersion?

Put another way: can a server of the given Version be used to run a cluster of this PartialVersion?

This is an interesting question to answer because clusters contain a file named PG_VERSION which containing just the major version number of the cluster’s files, e.g. “15”, or the major.point number for older PostgreSQL releases, e.g. “9.6”.

For versions of PostgreSQL before 10, this means that the given version’s major and point numbers must match exactly, and the minor number must be greater than or equal to this PartialVersion’s minor number. When this PartialVersion has no point or minor number, the given version is assumed to be compatible.

For versions of PostgreSQL after and including 10, this means that the given version’s major number must match exactly, and the minor number must be greater than or equal to this PartialVersion’s minor number. When this PartialVersion has no minor number, the given version is assumed to be compatible.

pub fn widened(&self) -> PartialVersion

Remove minor number.

pub fn sort_key(&self) -> (u32, Option<u32>, Option<u32>)

Provide a sort key that implements Ord.

PartialVersion does not implement Eq or Ord because they would disagree with its PartialEq and PartialOrd implementations, so this function provides a sort key that implements Ord and can be used with sorting functions, e.g. slice::sort_by_key.

Trait Implementations

impl Clone for PartialVersion

fn clone(&self) -> PartialVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartialVersion

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

Formats the value using the given formatter.

impl Display for PartialVersion

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

Formats the value using the given formatter.

impl From<&PartialVersion> for Version

Convert a PartialVersion into a Version that’s useful for comparisons.

The Version returned has 0 (zero) in the place of the missing parts. For example, a partial version of 9.6.* becomes 9.6.0, and 12.* becomes 12.0.

fn from(partial: &PartialVersion) -> Self

Converts to this type from the input type.

impl From<&Version> for PartialVersion

Convert a Version into a PartialVersion.

fn from(version: &Version) -> Self

Converts to this type from the input type.

impl From<PartialVersion> for Constraint

fn from(version: PartialVersion) -> Self

Convert a PartialVersion into a Constraint::Version.

impl From<PartialVersion> for Version

See From<&PartialVersion> for Version.

fn from(partial: PartialVersion) -> Self

Converts to this type from the input type.

impl From<Version> for PartialVersion

See From<&Version> for PartialVersion.

fn from(version: Version) -> Self

Converts to this type from the input type.

impl FromStr for PartialVersion

type Err = VersionError

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 PartialEq for PartialVersion

fn eq(&self, other: &Self) -> 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 PartialOrd for PartialVersion

fn partial_cmp(&self, other: &Self) -> 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 Copy for PartialVersion