audiobook-forge 2.10.0

CLI tool for converting audiobook directories to M4B format with chapters and metadata
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Natural sorting utilities

use std::cmp::Ordering;
use std::path::Path;

/// Sort paths using natural (human-friendly) ordering
///
/// Examples:
/// - track1.mp3 < track2.mp3 < track10.mp3 (not track1, track10, track2)
/// - Chapter 1 < Chapter 2 < Chapter 10
pub fn natural_sort<P: AsRef<Path>>(paths: &mut [P]) {
    paths.sort_by(|a, b| natural_compare(a.as_ref(), b.as_ref()));
}

/// Compare two paths using natural ordering
fn natural_compare(a: &Path, b: &Path) -> Ordering {
    let a_str = a.to_string_lossy();
    let b_str = b.to_string_lossy();

    natord::compare(&a_str, &b_str)
}

/// Sort strings using natural ordering
#[allow(dead_code)]  // Utility function for future use
pub fn natural_sort_strings(strings: &mut [String]) {
    strings.sort_by(|a, b| natord::compare(a, b));
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::path::PathBuf;

    #[test]
    fn test_natural_sort() {
        let mut paths = vec![
            PathBuf::from("track10.mp3"),
            PathBuf::from("track2.mp3"),
            PathBuf::from("track1.mp3"),
            PathBuf::from("track20.mp3"),
        ];

        natural_sort(&mut paths);

        assert_eq!(paths[0], PathBuf::from("track1.mp3"));
        assert_eq!(paths[1], PathBuf::from("track2.mp3"));
        assert_eq!(paths[2], PathBuf::from("track10.mp3"));
        assert_eq!(paths[3], PathBuf::from("track20.mp3"));
    }

    #[test]
    fn test_natural_sort_strings() {
        let mut strings = vec![
            "Chapter 10".to_string(),
            "Chapter 2".to_string(),
            "Chapter 1".to_string(),
        ];

        natural_sort_strings(&mut strings);

        assert_eq!(strings[0], "Chapter 1");
        assert_eq!(strings[1], "Chapter 2");
        assert_eq!(strings[2], "Chapter 10");
    }
}