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


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


411 lines


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


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.


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

version-number = "0.2"


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);


Licensed under either of

at your option.


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.


~26K SLoC