m3u8-parser 0.8.0

A Rust crate for parsing and creating M3U8 files (HLS).
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

/// Represents different types of validation errors that can occur when processing an M3U8 playlist.
///
/// This enum captures specific validation issues that may arise when checking the conformity
/// of a playlist to the M3U8 specification. Each variant represents a distinct error, providing
/// context for what went wrong during validation.
#[derive(Debug, PartialEq)]
#[non_exhaustive]
pub enum ValidationError {
    /// Error indicating that the #EXTM3U tag is missing from the playlist.
    MissingExtM3U,
    /// Error indicating that #EXTM3U is not the first tag in the playlist.
    ExtM3UNotFirst,
    /// Error indicating that a tag that may occur only once is duplicated.
    DuplicateTag(String),
    /// Error indicating that Master Playlist and Media Playlist tags are mixed.
    MixedPlaylistTypes,
    /// Error indicating that a Media Playlist is missing EXT-X-TARGETDURATION.
    MissingTargetDuration,
    /// Error indicating that an EXT-X-STREAM-INF tag is not followed by a URI.
    MissingVariantUri,
    /// Error indicating that a stream rendition-group reference cannot be resolved.
    UnresolvedRenditionGroup { attribute: String, group_id: String },
    /// Error indicating that a tag requires a newer EXT-X-VERSION.
    InsufficientVersion {
        tag: String,
        required: u8,
        actual: u8,
    },
    /// Error indicating that a tag was removed in the playlist's protocol version.
    RemovedTag { tag: String, removed_in: u8 },
    /// Error indicating that a media segment exceeds EXT-X-TARGETDURATION.
    SegmentDurationExceedsTarget { duration: f64, target_duration: u64 },

    /// Error indicating that the specified version is outside 1 through 12,
    /// the versions defined by draft-pantos-hls-rfc8216bis.
    ///
    /// # Arguments
    ///
    /// * `u8` - The invalid version number that was encountered.
    InvalidVersion(u8),

    /// Error indicating that the duration specified is invalid.
    ///
    /// # Arguments
    ///
    /// * `f64` - The invalid duration value that was encountered.
    InvalidDuration(f64),

    /// Error indicating that the target duration specified is invalid.
    ///
    /// # Arguments
    ///
    /// * `u64` - The invalid target duration value that was encountered.
    InvalidTargetDuration(u64),

    /// Error indicating that an invalid key method was specified.
    ///
    /// # Arguments
    ///
    /// * `String` - The invalid key method that was encountered.
    InvalidKeyMethod(String),
    /// Error indicating that key attributes are inconsistent with the selected method.
    InvalidKeyAttributes(String),

    /// Error indicating that the URI specified in a map tag is invalid.
    InvalidMapUri,

    /// Error indicating that the program date and time specified is invalid.
    InvalidProgramDateTime,

    /// Error indicating that the ID specified in a date range is invalid.
    InvalidDateRangeId,

    /// Error indicating that the start date specified in a date range is invalid.
    InvalidDateRangeStartDate,

    /// Error indicating that the end date specified in a date range is invalid.
    InvalidDateRangeEndDate,

    /// Error indicating that the planned duration specified in a date range is invalid.
    ///
    /// # Arguments
    ///
    /// * `f64` - The invalid planned duration value that was encountered in the date range.
    InvalidDateRangePlannedDuration(f64),
    /// Error indicating incompatible EXT-X-DATERANGE attributes.
    InvalidDateRangeAttributes(String),

    /// Error indicating that a media tag is missing required fields.
    MissingMediaFields,

    /// Error indicating that EXT-X-MEDIA attributes are inconsistent with its TYPE.
    InvalidMediaAttributes(String),

    /// Error indicating that a preload hint URI is invalid.
    InvalidPreloadHintUri,

    /// Error indicating that a rendition report URI is invalid.
    InvalidRenditionReportUri,

    /// Error indicating that a tag does not survive being written and read back,
    /// typically because a string contains a newline or a double quote that would
    /// alter the playlist's structure. Holds the tag as it would be written.
    UnserializableTag(String),

    /// Error indicating that a URI line is not preceded by EXTINF or EXT-X-STREAM-INF.
    OrphanUri(String),

    /// Error indicating that an EXT-X-DATERANGE ID is used more than once.
    DuplicateDateRangeId(String),

    /// Error indicating that two EXT-X-SESSION-DATA tags share a DATA-ID and LANGUAGE.
    DuplicateSessionData {
        id: String,
        language: Option<String>,
    },

    /// Error indicating that EXT-X-PART is used without EXT-X-PART-INF.
    MissingPartInf,

    /// Error indicating that EXT-X-SERVER-CONTROL hold-back values are too short
    /// for the playlist's target durations.
    InvalidServerControl(String),

    /// Error indicating that a tag must precede the first media segment but follows it.
    TagAfterFirstSegment(String),

    /// Error indicating that a segment's EXT-X-BYTERANGE has no offset but does not
    /// follow a sub-range of the same resource. Holds the segment URI.
    InvalidByteRange(String),
}