unbundle 5.2.0

Unbundle media files - extract still frames, audio tracks, and subtitles from video files
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

//! Chapter metadata integration tests.
//!
//! These tests require the fixture files generated by
//! `tests/fixtures/generate_fixtures.sh` (or `.bat` on Windows).

use std::path::Path;

use unbundle::MediaFile;

fn sample_with_chapters_path() -> &'static str {
    "tests/fixtures/sample_with_chapters.mkv"
}

fn sample_video_path() -> &'static str {
    "tests/fixtures/sample_video.mp4"
}

#[test]
fn chapters_present_in_file_with_chapters() {
    let path = sample_with_chapters_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    let metadata = unbundler.metadata();
    let chapters = metadata
        .chapters
        .as_ref()
        .expect("Expected chapters in fixture");

    assert_eq!(chapters.len(), 3, "Expected 3 chapters");
}

#[test]
fn chapter_titles_match() {
    let path = sample_with_chapters_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    let chapters = unbundler
        .metadata()
        .chapters
        .as_ref()
        .expect("Expected chapters")
        .clone();

    assert_eq!(chapters[0].title.as_deref(), Some("Introduction"));
    assert_eq!(chapters[1].title.as_deref(), Some("Main Content"));
    assert_eq!(chapters[2].title.as_deref(), Some("Conclusion"));
}

#[test]
fn chapter_timestamps_are_ordered() {
    let path = sample_with_chapters_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    let chapters = unbundler
        .metadata()
        .chapters
        .as_ref()
        .expect("Expected chapters")
        .clone();

    for window in chapters.windows(2) {
        assert!(
            window[0].end <= window[1].start || window[0].end == window[1].start,
            "Chapters should be ordered: {:?} should end before {:?} starts",
            window[0],
            window[1]
        );
    }
}

#[test]
fn chapter_indices_are_sequential() {
    let path = sample_with_chapters_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    let chapters = unbundler
        .metadata()
        .chapters
        .as_ref()
        .expect("Expected chapters")
        .clone();

    for (i, chapter) in chapters.iter().enumerate() {
        assert_eq!(chapter.index, i, "Chapter index should be sequential");
    }
}

#[test]
fn no_chapters_in_file_without() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    assert!(
        unbundler.metadata().chapters.is_none(),
        "sample_video.mp4 should have no chapters"
    );
}

#[test]
fn chapter_start_end_durations() {
    let path = sample_with_chapters_path();
    if !Path::new(path).exists() {
        eprintln!("Skipping: fixture '{path}' not found.");
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open");
    let chapters = unbundler
        .metadata()
        .chapters
        .as_ref()
        .expect("Expected chapters")
        .clone();

    // First chapter: 0s–2s
    let first = &chapters[0];
    assert!(
        first.start.as_secs_f64() < 0.1,
        "First chapter should start near 0"
    );
    assert!(
        (first.end.as_secs_f64() - 2.0).abs() < 0.1,
        "First chapter should end near 2s, got {:?}",
        first.end,
    );
}