#version #semver #version-core #semver-shorthand #rust-version

version-number

Two and three component 'major.minor' and 'major.minor.patch' version number parsing

3 unstable releases

0.2.2 May 15, 2022
0.2.1 May 15, 2022
0.1.0 May 1, 2022

#7 in #rustup

MIT/Apache

19KB
411 lines

version-number

Parsing the "version core" of semver numbers and their shorthands

Introduction

A crate to parse two- and three component version numbers. The three component version numbers are a subset of semver, namely, just the "version core" of a semver version (that is, pre-release and/or build modifiers are not supported). Two component versions are a shorthand of the three component version number, where the patch number is not specified.

Examples of two- respectively three component version numbers are 1.51 and 1.7.0.

An example where this version type is found, is the package.rust-version field in the Cargo manifest (which crate authors use to set the MSRV).

If you would like to use this library to just parse two xor three component versions, please open an issue :), I would be happy to support this.

Install

Run cargo add version-number or add the version-number crate manually to your Cargo manifest (Cargo.toml) as a dependency:

[dependencies]
version-number = "0.2"

Usage

use version_number::Version;

fn main() {
    let major_minor = Version::parse("1.27").unwrap();
    println!("Two component version: {}", major_minor);
  
    let major_minor_patch = Version::parse("1.27.0").unwrap();
    println!("Three component version: {}", major_minor_patch);
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.6–1MB
~26K SLoC