Google Git
Sign in
android / platform / external / rust / crates / semver / 5bee7d8b8de3d753a2b4b240f5dcc9a6846369cd
commit5bee7d8b8de3d753a2b4b240f5dcc9a6846369cd[log] [tgz]
authorAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Sat Mar 05 04:06:14 2022 +0000
committerAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Sat Mar 05 04:06:14 2022 +0000
treea7850806f24cb5d7da3c50388fbf956a6bedbce1
parent25e9146fc4e931ec36ba926ec0ba292afad28cb8 [diff]
parent7dab06a28227a030b0002a9cae09fa256e713300 [diff]
Snap for 8254899 from 7dab06a28227a030b0002a9cae09fa256e713300 to tm-release

Change-Id: I5f395b54e1d4e0b2e7a4ddb69722c123e33d5cbd
tree: a7850806f24cb5d7da3c50388fbf956a6bedbce1
  1. benches/
  2. src/
  3. tests/
  4. LICENSE ⇨ LICENSE-APACHE
  5. Android.bp
  6. build.rs
  7. Cargo.lock
  8. Cargo.toml
  9. Cargo.toml.orig
  10. cargo2android.json
  11. LICENSE-APACHE
  12. LICENSE-MIT
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. OWNERS
  16. README.md
README.md

semver

A parser and evaluator for Cargo's flavor of Semantic Versioning.

Semantic Versioning (see https://semver.org) is a guideline for how version numbers are assigned and incremented. It is widely followed within the Cargo/crates.io ecosystem for Rust.

[dependencies]
semver = "1.0"

Compiler support: requires rustc 1.31+

Example

use semver::{BuildMetadata, Prerelease, Version, VersionReq};

fn main() {
    let req = VersionReq::parse(">=1.2.3, <1.8.0").unwrap();

    // Check whether this requirement matches version 1.2.3-alpha.1 (no)
    let version = Version {
        major: 1,
        minor: 2,
        patch: 3,
        pre: Prerelease::new("alpha.1").unwrap(),
        build: BuildMetadata::EMPTY,
    };
    assert!(!req.matches(&version));

    // Check whether it matches 1.3.0 (yes it does)
    let version = Version::parse("1.3.0").unwrap();
    assert!(req.matches(&version));
}

Scope of this crate

Besides Cargo, several other package ecosystems and package managers for other languages also use SemVer: RubyGems/Bundler for Ruby, npm for JavaScript, Composer for PHP, CocoaPods for Objective-C...

The semver crate is specifically intended to implement Cargo's interpretation of Semantic Versioning.

Where the various tools differ in their interpretation or implementation of the spec, this crate follows the implementation choices made by Cargo. If you are operating on version numbers from some other package ecosystem, you will want to use a different semver library which is appropriate to that ecosystem.

The extent of Cargo's SemVer support is documented in the Specifying Dependencies chapter of the Cargo reference.

License