Skip to content
This repository has been archived by the owner on Aug 12, 2024. It is now read-only.

flip1995/rustc-semver

Coverage Tests

Rustc Semver

This crate provides a minimalistic parser for Rust versions.

Archive Note

This crate was mainly used in Clippy. But since then, a rustc implementation has been created. Clippy moved to that in rust-clippy#13243, so this crate will no longer be maintained.

Description

The parser will only accept Versions in the form

<major>.<minor>.<patch>

and 3 special versions:

  • 1.0.0-alpha
  • 1.0.0-alpha.2
  • 1.0.0-beta

This covers every version of rustc that were released to date.

Usage

There are 2 functions to create a RustcVersion:

  1. const RustcVersion::new(u32, u32, u32): This is mainly used to create constants
  2. RustcVersion::parse(&str): Usually you want to parse a version with this function

If you have a RustcVersion you can compare them, like you would expect:

assert!(RustcVersion::parse("1.42.0")? < RustcVersion::parse("1.43")?);

If you want to check whether one version meets another version according to the Caret Requirements, there is the method RustcVersion::meets:

assert!(RustcVersion::new(1, 48, 0).meets(RustcVersion::parse("1.42")?));

Code of Conduct

This repository adopts the Contributor Covenant Code of Conduct

License

Copyright 2020 Philipp Krones

Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option. Files in the project may not be copied, modified, or distributed except according to those terms.