Rust 库：version-compare

Rust 库，用于轻松比较不带特定格式的版本号，并测试各种比较运算符。

比较版本号很困难，尤其是当版本号格式奇特时。

该库可以帮助您使用最佳努力方法轻松地比较任何类型的版本号（无特定格式）。可以将两个版本号进行比较以获取比较运算符（<、==、>），或测试它们是否满足比较运算符。

除了版本比较外，该库还提供各种其他用于处理版本号的工具。

受 PHP 的 version_compare() 启发。

注意：仍在开发中。当前可配置性非常有限。事情将会改变。

格式

可以成功解析的版本号包括
1、3.10.4.1、1.2.alpha、1.2.dev.4、 、 . -32 . 1、MyApp 3.2.0 / build 0932 ...

有关版本号比较的列表，请参阅此处。

示例

该库非常易于使用。以下是一个基本用法示例

Cargo.toml:

[dependencies]
version-compare = "0.1"

example.rs:

use version_compare::{compare, compare_to, Cmp, Version};

fn main() {
    let a = "1.2";
    let b = "1.5.1";

    // The following comparison operators are used:
    // - Cmp::Eq -> Equal
    // - Cmp::Ne -> Not equal
    // - Cmp::Lt -> Less than
    // - Cmp::Le -> Less than or equal
    // - Cmp::Ge -> Greater than or equal
    // - Cmp::Gt -> Greater than

    // Easily compare version strings
    assert_eq!(compare(a, b), Ok(Cmp::Lt));
    assert_eq!(compare_to(a, b, Cmp::Le), Ok(true));
    assert_eq!(compare_to(a, b, Cmp::Gt), Ok(false));

    // Parse and wrap version strings as a Version
    let a = Version::from(a).unwrap();
    let b = Version::from(b).unwrap();

    // The Version can easily be compared with
    assert_eq!(a < b, true);
    assert_eq!(a <= b, true);
    assert_eq!(a > b, false);
    assert_eq!(a != b, true);
    assert_eq!(a.compare(&b), Cmp::Lt);
    assert_eq!(a.compare_to(&b, Cmp::Lt), true);

    // Or match the comparison operators
    match a.compare(b) {
        Cmp::Lt => println!("Version a is less than b"),
        Cmp::Eq => println!("Version a is equal to b"),
        Cmp::Gt => println!("Version a is greater than b"),
        _ => unreachable!(),
    }
}

有关更多信息，请参阅examples 目录。

功能

• 比较版本号，获取：<，==，>
• 与比较运算符（<，<=，==，!=，>=，>）进行比较
• 解析复杂和不指定的格式
• 静态、独立的方法，可以轻松地在单行代码中比较版本字符串

未来想法

• 版本范围
• 支持npm样式运算符（例如^1.0或~1.0）
• 清单：扩展Manifest以支持广泛的约束
• 构建块，用于构建您自己的特定版本号解析器
• 批量比较

semver

使用semver格式的版本号可以正确比较，无需额外配置。

如果您的版本号字符串遵循此精确格式，您可能更倾向于使用semver crate以获取更多格式特定功能。

如果不确定，则version-compare使比较变得轻而易举。

构建

此库每天自动构建和测试，并针对每个提交使用CI服务。

在此处查看当前状态：https://gitlab.com/timvisee/version-compare/-/pipelines

许可证

本项目采用MIT许可证发布。有关更多信息，请查看LICENSE文件。