#sorting #version #gnu #algorithm

vsort

GNU Version Sort Rust implementation

2 unstable releases

0.2.0 Aug 4, 2023
0.1.0 Jun 30, 2023

#716 in Algorithms

Download history 627/week @ 2023-12-14 322/week @ 2023-12-21 336/week @ 2023-12-28 446/week @ 2024-01-04 501/week @ 2024-01-11 442/week @ 2024-01-18 451/week @ 2024-01-25 498/week @ 2024-02-01 508/week @ 2024-02-08 919/week @ 2024-02-15 564/week @ 2024-02-22 760/week @ 2024-02-29 660/week @ 2024-03-07 458/week @ 2024-03-14 1767/week @ 2024-03-21 1249/week @ 2024-03-28

4,262 downloads per month
Used in lsd

MIT license

22KB
385 lines

TESTS License: MIT Latest version

vsort

A Rust library that implements the GNU version sort algorithm. It follows the spec given here.

Installation

cargo add vsort

Why vsort?

Other version sort implementations don't match the GNU spec, and some were missing tests. The goal is to match the behavior of the core utils implementation as close as possible. If you notice any discrepancies please open an issue.

Why not FFI?

FFI is probably your best bet if you need absolute parity with GNU version sort. In the case you want their algorithm in Rust here it is :)

Usage:

use vsort::{compare, sort};

fn main() {
    let mut file_names = vec![
        "a.txt",
        "b 1.txt",
        "b 10.txt",
        "b 11.txt",
        "b 5.txt",
        "Ssm.txt",
    ];

    // Pass to sort_by
    file_names.sort_by(|a, b| compare(a, b));
    assert_eq!(
        file_names,
        vec!["Ssm.txt", "a.txt", "b 1.txt", "b 5.txt", "b 10.txt", "b 11.txt"]
    );

    let mut file_names = vec![
        "a.txt",
        "b 1.txt",
        "b 10.txt",
        "b 11.txt",
        "b 5.txt",
        "Ssm.txt",
    ];
    // Alternatively
    sort(&mut file_names);
    assert_eq!(
        file_names,
        vec!["Ssm.txt", "a.txt", "b 1.txt", "b 5.txt", "b 10.txt", "b 11.txt"]
    );
}

No runtime deps