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

//! Container tags and colorspace metadata integration tests.

use std::path::Path;

use unbundle::MediaFile;

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

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

    let unbundler = MediaFile::open(path).expect("open");
    let meta = unbundler.metadata();

    // Tags may or may not be present depending on how the fixture was created.
    // We just check the field exists and is accessible.
    if let Some(tags) = &meta.tags {
        // FFmpeg usually sets "encoder" or "major_brand".
        assert!(
            !tags.is_empty() || tags.is_empty(),
            "tags field should be accessible"
        );
    }
}

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

    let unbundler = MediaFile::open(path).expect("open");
    let meta = unbundler.metadata();
    let video = meta.video.as_ref().expect("video metadata");

    // These fields should be populated (may be None for unknown).
    // We just verify they are accessible without panic.
    let _ = &video.color_space;
    let _ = &video.color_range;
    let _ = &video.color_primaries;
    let _ = &video.color_transfer;
    let _ = &video.bits_per_raw_sample;
    let _ = &video.pixel_format_name;
}

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

    let unbundler = MediaFile::open(path).expect("open");
    let meta = unbundler.metadata();

    if let Some(tracks) = &meta.video_tracks {
        assert!(!tracks.is_empty(), "expected at least one video track");
        for track in tracks {
            assert!(track.width > 0);
            assert!(track.height > 0);
        }
    }
}

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

    let mut unbundler = MediaFile::open(path).expect("open");

    // Track 0 should always be valid for a video file.
    let extractor = unbundler.video_track(0);
    assert!(extractor.is_ok(), "track 0 should be valid");

    // Track 99 should be out of range.
    let err = unbundler.video_track(99);
    assert!(err.is_err(), "track 99 should be out of range");
}