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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

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

use std::{path::Path, time::Duration};

use unbundle::{AudioFormat, MediaFile};

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

#[test]
fn extract_complete_audio_wav() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("Failed to open test video");
    let audio_bytes = unbundler
        .audio()
        .extract(AudioFormat::Wav)
        .expect("Failed to extract WAV audio");

    assert!(!audio_bytes.is_empty(), "Expected non-empty WAV audio data");
    // WAV files start with RIFF header.
    assert_eq!(
        &audio_bytes[..4],
        b"RIFF",
        "Expected RIFF header in WAV output"
    );
}

#[test]
fn extract_audio_range() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("Failed to open test video");
    let audio_bytes = unbundler
        .audio()
        .extract_range(
            Duration::from_secs(1),
            Duration::from_secs(3),
            AudioFormat::Wav,
        )
        .expect("Failed to extract audio range");

    assert!(
        !audio_bytes.is_empty(),
        "Expected non-empty audio range data"
    );
}

#[test]
fn save_audio_to_file() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let output = tempfile::NamedTempFile::new().expect("Failed to create temp file");
    let output_path = output.path().with_extension("wav");

    let mut unbundler = MediaFile::open(path).expect("Failed to open test video");
    unbundler
        .audio()
        .save(&output_path, AudioFormat::Wav)
        .expect("Failed to save audio to file");

    let written_bytes = std::fs::read(&output_path).expect("Failed to read output file");
    assert!(
        !written_bytes.is_empty(),
        "Expected non-empty output WAV file"
    );
    assert_eq!(&written_bytes[..4], b"RIFF");

    // Clean up.
    let _ = std::fs::remove_file(&output_path);
}

#[test]
fn save_audio_range_to_file() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let output = tempfile::NamedTempFile::new().expect("Failed to create temp file");
    let output_path = output.path().with_extension("wav");

    let mut unbundler = MediaFile::open(path).expect("Failed to open test video");
    unbundler
        .audio()
        .save_range(
            &output_path,
            Duration::from_secs(1),
            Duration::from_secs(3),
            AudioFormat::Wav,
        )
        .expect("Failed to save audio range to file");

    let written_bytes = std::fs::read(&output_path).expect("Failed to read output file");
    assert!(!written_bytes.is_empty());

    let _ = std::fs::remove_file(&output_path);
}

#[test]
fn no_audio_stream_returns_error() {
    let path = "tests/fixtures/sample_video_only.mp4";
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("Failed to open video-only file");
    let result = unbundler.audio().extract(AudioFormat::Wav);

    assert!(result.is_err(), "Expected NoAudioStream error");
}

#[test]
fn audio_only_file_works() {
    let path = "tests/fixtures/sample_audio_only.mp4";
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("Failed to open audio-only file");
    assert!(unbundler.metadata().audio.is_some());
    assert!(unbundler.metadata().video.is_none());

    let audio_bytes = unbundler
        .audio()
        .extract(AudioFormat::Wav)
        .expect("Failed to extract audio from audio-only file");
    assert!(!audio_bytes.is_empty());
}

#[test]
fn audio_metadata_is_populated() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let unbundler = MediaFile::open(path).expect("Failed to open test video");
    let audio_metadata = unbundler
        .metadata()
        .audio
        .as_ref()
        .expect("No audio metadata");

    assert!(
        audio_metadata.sample_rate > 0,
        "Expected positive sample rate"
    );
    assert!(audio_metadata.channels > 0, "Expected at least 1 channel");
    assert!(
        !audio_metadata.codec.is_empty(),
        "Expected non-empty codec name"
    );
}