Google Git
Sign in
android / platform / external / rust / crates / semver / refs/heads/main
commit15a4fed5e3ea28d6b9e57a9a29842694f797c54f[log] [tgz]
authorJames Farrell <[email protected]>Fri Aug 30 03:38:53 2024 +0000
committerAutomerger Merge Worker <[email protected]>Fri Aug 30 03:38:53 2024 +0000
treef6bc5adbb77666f7eba851b3188d736d1757bb04
parent9e18c62e0201672fdf09cbbb638fbc0290368c4e [diff]
parent22cbf44b0d906fa82658557eead43b8d1f9caac0 [diff]
Migrate 25 crates to monorepo. am: 22cbf44b0d

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

Change-Id: I8ae3359c2090f880f5b85f8f72d9d3723988f04d
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: f6bc5adbb77666f7eba851b3188d736d1757bb04
  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. LICENSE-APACHE
  13. LICENSE-MIT
  14. METADATA
  15. MODULE_LICENSE_APACHE2
  16. OWNERS
  17. 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