Gitiles
Code Review Sign In
android-review.linaro.org / platform / external / rust / crates / semver / refs/heads/main
commit802365cf35f289993f2b059e73bac514cbd215a2[log] [tgz]
authorJeff Vander Stoep <jeffv@google.com>Thu Feb 08 09:22:58 2024 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Thu Feb 08 09:22:58 2024 +0000
treea91f006deda4c22a2b76a5c38b0a7a155e8989bd
parent25cd99f8dc7bc5b77d40b909f0c02b933044a47b [diff]
parent3b053b641ea209ffe7ddf4e0a727115ab382be0d [diff]
Upgrade semver to 1.0.21 am: 3b053b641e

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/semver/+/2953877

Change-Id: I787822576c34b2840b0c96501807eb5f233a2004
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
tree: a91f006deda4c22a2b76a5c38b0a7a155e8989bd
  1. .github/
  2. benches/
  3. src/
  4. tests/
  5. LICENSE ⇨ LICENSE-APACHE
  6. .cargo_vcs_info.json
  7. .gitignore
  8. Android.bp
  9. build.rs
  10. Cargo.toml
  11. Cargo.toml.orig
  12. cargo_embargo.json
  13. LICENSE-APACHE
  14. LICENSE-MIT
  15. METADATA
  16. MODULE_LICENSE_APACHE2
  17. OWNERS
  18. README.md
  19. TEST_MAPPING
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