Google Git
Sign in
android / platform / external / rust / crates / semver / refs/tags/android-security-13.0.0_r3
tagea3677d4ffc2d274036ebc6eff1465cf1fb3501b
taggerThe Android Open Source Project <initial-contribution@android.com>Tue Mar 14 09:07:50 2023 -0700
objectd41744d131bb677158e54c35cb8e7f4cc248a08a 
Android security 13.0.0 release 3
commitd41744d131bb677158e54c35cb8e7f4cc248a08a[log] [tgz]
authorAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Mar 10 02:06:04 2022 +0000
committerAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Mar 10 02:06:04 2022 +0000
tree7668fafc4b8f49e97f33c7a9f1e64ead0767419e
parent5bee7d8b8de3d753a2b4b240f5dcc9a6846369cd [diff]
parent0d133695401afcd1dc63898b60d2c4983532ec1d [diff]
Snap for 8283941 from 0d133695401afcd1dc63898b60d2c4983532ec1d to tm-release

Change-Id: I2e1de407a6ab90df609950bd01359b14748c2597
tree: 7668fafc4b8f49e97f33c7a9f1e64ead0767419e
  1. .github/
  2. benches/
  3. src/
  4. tests/
  5. LICENSE ⇨ LICENSE-APACHE
  6. .cargo_vcs_info.json
  7. .clippy.toml
  8. .gitignore
  9. Android.bp
  10. build.rs
  11. Cargo.toml
  12. Cargo.toml.orig
  13. cargo2android.json
  14. LICENSE-APACHE
  15. LICENSE-MIT
  16. METADATA
  17. MODULE_LICENSE_APACHE2
  18. OWNERS
  19. README.md
  20. 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