mirror of
https://github.com/sile/hls_m3u8.git
synced 2024-09-27 14:10:05 +00:00
major rewrite of the library
This commit is contained in:
parent
4324cb79d0
commit
0df08f32ab
57 changed files with 3737 additions and 3090 deletions
|
@ -16,6 +16,9 @@ codecov = {repository = "sile/hls_m3u8"}
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
trackable = "0.2"
|
trackable = "0.2"
|
||||||
|
derive_builder = "0.7.2"
|
||||||
|
shrinkwraprs = "0.2.1"
|
||||||
|
regex = { version = "1.2.1", features = [ "pattern" ] }
|
||||||
|
|
||||||
[dev-dependencies]
|
[dev-dependencies]
|
||||||
clap = "2"
|
clap = "2"
|
||||||
|
|
2
rustfmt.toml
Normal file
2
rustfmt.toml
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
error_on_line_overflow = true
|
||||||
|
error_on_unformatted = true
|
85
src/_types.rs
Normal file
85
src/_types.rs
Normal file
|
@ -0,0 +1,85 @@
|
||||||
|
//! Miscellaneous types.
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
use std::fmt;
|
||||||
|
use std::ops::Deref;
|
||||||
|
use std::str::{self, FromStr};
|
||||||
|
use std::time::Duration;
|
||||||
|
use trackable::error::ErrorKindExt
|
||||||
|
|
||||||
|
|
||||||
|
/// Quoted string.
|
||||||
|
///
|
||||||
|
/// See: [4.2. Attribute Lists]
|
||||||
|
///
|
||||||
|
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
||||||
|
pub struct QuotedString(String);
|
||||||
|
|
||||||
|
impl QuotedString {
|
||||||
|
/// Makes a new `QuotedString` instance.
|
||||||
|
///
|
||||||
|
/// # Note
|
||||||
|
/// This function will silently remove the following characters, which must not appear in a
|
||||||
|
/// quoted-string:
|
||||||
|
///
|
||||||
|
/// - line feed (`"\n"`)
|
||||||
|
/// - carriage return (`"\r"`),
|
||||||
|
/// - double quote (`"`)
|
||||||
|
///
|
||||||
|
/// [Reference](https://tools.ietf.org/html/rfc8216#section-4.2)
|
||||||
|
pub fn new<T: ToString>(value: T) -> Self {
|
||||||
|
let result = format!(
|
||||||
|
"\"{}\"",
|
||||||
|
value
|
||||||
|
.to_string()
|
||||||
|
// silently remove forbidden characters
|
||||||
|
.replace("\n", "")
|
||||||
|
.replace("\r", "")
|
||||||
|
.replace("\"", "")
|
||||||
|
);
|
||||||
|
Self(result)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts a `QuotedString` to a `String` (removes the quotes).
|
||||||
|
pub fn unquote(&self) -> String {
|
||||||
|
self.0.clone().replace("\"", "")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Deref for QuotedString {
|
||||||
|
type Target = str;
|
||||||
|
fn deref(&self) -> &Self::Target {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AsRef<str> for QuotedString {
|
||||||
|
fn as_ref(&self) -> &str {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for QuotedString {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for QuotedString {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
Ok(Self::new(s))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn it_works() {
|
||||||
|
assert!(true)
|
||||||
|
}
|
||||||
|
}
|
204
src/attribute.rs
204
src/attribute.rs
|
@ -1,103 +1,135 @@
|
||||||
use crate::{ErrorKind, Result};
|
use std::collections::HashMap;
|
||||||
use std::collections::HashSet;
|
use std::str::FromStr;
|
||||||
use std::str;
|
|
||||||
|
|
||||||
#[derive(Debug)]
|
use shrinkwraprs::Shrinkwrap;
|
||||||
pub struct AttributePairs<'a> {
|
|
||||||
input: &'a str,
|
|
||||||
visited_keys: HashSet<&'a str>,
|
|
||||||
}
|
|
||||||
impl<'a> AttributePairs<'a> {
|
|
||||||
pub fn parse(input: &'a str) -> Self {
|
|
||||||
AttributePairs {
|
|
||||||
input,
|
|
||||||
visited_keys: HashSet::new(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn parse_name(&mut self) -> Result<&'a str> {
|
use crate::error::{Error, ErrorKind};
|
||||||
for i in 0..self.input.len() {
|
|
||||||
match self.input.as_bytes()[i] {
|
|
||||||
b'=' => {
|
|
||||||
let (key, _) = self.input.split_at(i);
|
|
||||||
let (_, rest) = self.input.split_at(i + 1);
|
|
||||||
self.input = rest;
|
|
||||||
return Ok(key);
|
|
||||||
}
|
|
||||||
b'A'..=b'Z' | b'0'..=b'9' | b'-' => {}
|
|
||||||
_ => track_panic!(
|
|
||||||
ErrorKind::InvalidInput,
|
|
||||||
"Malformed attribute name: {:?}",
|
|
||||||
self.input
|
|
||||||
),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
track_panic!(
|
|
||||||
ErrorKind::InvalidInput,
|
|
||||||
"No attribute value: {:?}",
|
|
||||||
self.input
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
fn parse_raw_value(&mut self) -> &'a str {
|
#[derive(Shrinkwrap, Clone, Debug, Default, Eq, PartialEq)]
|
||||||
let mut in_quote = false;
|
pub(crate) struct AttributePairs(HashMap<String, String>);
|
||||||
let mut value_end = self.input.len();
|
|
||||||
let mut next = self.input.len();
|
impl IntoIterator for AttributePairs {
|
||||||
for (i, c) in self.input.bytes().enumerate() {
|
type Item = (String, String);
|
||||||
match c {
|
type IntoIter = ::std::collections::hash_map::IntoIter<String, String>;
|
||||||
b'"' => {
|
|
||||||
in_quote = !in_quote;
|
fn into_iter(self) -> Self::IntoIter {
|
||||||
}
|
self.0.into_iter()
|
||||||
b',' if !in_quote => {
|
|
||||||
value_end = i;
|
|
||||||
next = i + 1;
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
_ => {}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
let (value, _) = self.input.split_at(value_end);
|
|
||||||
let (_, rest) = self.input.split_at(next);
|
|
||||||
self.input = rest;
|
|
||||||
value
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
impl<'a> Iterator for AttributePairs<'a> {
|
|
||||||
type Item = Result<(&'a str, &'a str)>;
|
#[allow(dead_code)]
|
||||||
fn next(&mut self) -> Option<Self::Item> {
|
impl AttributePairs {
|
||||||
if self.input.is_empty() {
|
pub fn new() -> Self {
|
||||||
return None;
|
Self::default()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn insert<K, V>(&mut self, key: K, value: V) -> Option<String>
|
||||||
|
where
|
||||||
|
K: ToString,
|
||||||
|
V: ToString,
|
||||||
|
{
|
||||||
|
self.0.insert(key.to_string(), value.to_string())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for AttributePairs {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(value: &str) -> Result<Self, Self::Err> {
|
||||||
|
let mut result = HashMap::new();
|
||||||
|
|
||||||
|
for line in split(value) {
|
||||||
|
let t = line
|
||||||
|
.trim()
|
||||||
|
.split("=")
|
||||||
|
.map(|x| x.to_string())
|
||||||
|
.collect::<Vec<_>>();
|
||||||
|
|
||||||
|
let (key, value) = {
|
||||||
|
if t.len() != 2 {
|
||||||
|
Err(ErrorKind::InvalidInput)?
|
||||||
|
} else {
|
||||||
|
(t[0].clone(), t[1].clone())
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
result.insert(key.to_string(), value.to_string());
|
||||||
}
|
}
|
||||||
|
|
||||||
let result = || -> Result<(&'a str, &'a str)> {
|
Ok(Self(result))
|
||||||
let key = track!(self.parse_name())?;
|
|
||||||
track_assert!(
|
|
||||||
self.visited_keys.insert(key),
|
|
||||||
ErrorKind::InvalidInput,
|
|
||||||
"Duplicate attribute key: {:?}",
|
|
||||||
key
|
|
||||||
);
|
|
||||||
|
|
||||||
let value = self.parse_raw_value();
|
|
||||||
Ok((key, value))
|
|
||||||
}();
|
|
||||||
Some(result)
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
pub fn split(value: &str) -> Vec<String> {
|
||||||
|
let mut result = vec![];
|
||||||
|
|
||||||
|
let mut inside_quotes = false;
|
||||||
|
let mut temp_string = String::new();
|
||||||
|
|
||||||
|
for c in value.chars() {
|
||||||
|
match c {
|
||||||
|
'"' => {
|
||||||
|
if inside_quotes {
|
||||||
|
inside_quotes = false;
|
||||||
|
} else {
|
||||||
|
inside_quotes = true;
|
||||||
|
}
|
||||||
|
temp_string.push(c);
|
||||||
|
}
|
||||||
|
',' => {
|
||||||
|
if !inside_quotes {
|
||||||
|
result.push(temp_string);
|
||||||
|
temp_string = String::new();
|
||||||
|
} else {
|
||||||
|
temp_string.push(c);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_ => {
|
||||||
|
temp_string.push(c);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
result.push(temp_string);
|
||||||
|
|
||||||
|
result
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod test {
|
mod test {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn it_works() {
|
fn test_parser() {
|
||||||
let mut pairs = AttributePairs::parse("FOO=BAR,BAR=\"baz,qux\",ABC=12.3");
|
let pairs = ("FOO=BAR,BAR=\"baz,qux\",ABC=12.3")
|
||||||
assert_eq!(pairs.next().map(|x| x.ok()), Some(Some(("FOO", "BAR"))));
|
.parse::<AttributePairs>()
|
||||||
assert_eq!(
|
.unwrap();
|
||||||
pairs.next().map(|x| x.ok()),
|
|
||||||
Some(Some(("BAR", "\"baz,qux\"")))
|
let mut iterator = pairs.iter();
|
||||||
);
|
assert!(iterator.any(|(k, v)| (k, v) == (&"FOO".to_string(), &"BAR".to_string())));
|
||||||
assert_eq!(pairs.next().map(|x| x.ok()), Some(Some(("ABC", "12.3"))));
|
|
||||||
assert_eq!(pairs.next().map(|x| x.ok()), None)
|
let mut iterator = pairs.iter();
|
||||||
|
assert!(iterator.any(|(k, v)| (k, v) == (&"BAR".to_string(), &"\"baz,qux\"".to_string())));
|
||||||
|
|
||||||
|
let mut iterator = pairs.iter();
|
||||||
|
assert!(iterator.any(|(k, v)| (k, v) == (&"ABC".to_string(), &"12.3".to_string())));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_malformed_input() {
|
||||||
|
let result = ("FOO=,Bar==,,=12,ABC=12").parse::<AttributePairs>();
|
||||||
|
assert!(result.is_err());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_iterator() {
|
||||||
|
let mut attrs = AttributePairs::new();
|
||||||
|
attrs.insert("key_01".to_string(), "value_01".to_string());
|
||||||
|
attrs.insert("key_02".to_string(), "value_02".to_string());
|
||||||
|
|
||||||
|
let mut iterator = attrs.iter();
|
||||||
|
assert!(iterator.any(|(k, v)| (k, v) == (&"key_01".to_string(), &"value_01".to_string())));
|
||||||
|
|
||||||
|
let mut iterator = attrs.iter();
|
||||||
|
assert!(iterator.any(|(k, v)| (k, v) == (&"key_02".to_string(), &"value_02".to_string())));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -5,9 +5,11 @@ use trackable::error::{ErrorKind as TrackableErrorKind, TrackableError};
|
||||||
pub struct Error(TrackableError<ErrorKind>);
|
pub struct Error(TrackableError<ErrorKind>);
|
||||||
|
|
||||||
/// Possible error kinds.
|
/// Possible error kinds.
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
#[allow(missing_docs)]
|
#[allow(missing_docs)]
|
||||||
pub enum ErrorKind {
|
pub enum ErrorKind {
|
||||||
InvalidInput,
|
InvalidInput,
|
||||||
|
BuilderError(String),
|
||||||
}
|
}
|
||||||
|
|
||||||
impl TrackableErrorKind for ErrorKind {}
|
impl TrackableErrorKind for ErrorKind {}
|
||||||
|
|
|
@ -38,6 +38,7 @@ mod line;
|
||||||
mod master_playlist;
|
mod master_playlist;
|
||||||
mod media_playlist;
|
mod media_playlist;
|
||||||
mod media_segment;
|
mod media_segment;
|
||||||
|
mod utils;
|
||||||
|
|
||||||
/// This crate specific `Result` type.
|
/// This crate specific `Result` type.
|
||||||
pub type Result<T> = std::result::Result<T, Error>;
|
pub type Result<T> = std::result::Result<T, Error>;
|
||||||
|
|
18
src/line.rs
18
src/line.rs
|
@ -1,13 +1,14 @@
|
||||||
use crate::tags;
|
|
||||||
use crate::types::SingleLineString;
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
use std::str::FromStr;
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::tags;
|
||||||
|
use crate::{Error, ErrorKind, Result};
|
||||||
|
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
pub struct Lines<'a> {
|
pub struct Lines<'a> {
|
||||||
input: &'a str,
|
input: &'a str,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<'a> Lines<'a> {
|
impl<'a> Lines<'a> {
|
||||||
pub fn new(input: &'a str) -> Self {
|
pub fn new(input: &'a str) -> Self {
|
||||||
Lines { input }
|
Lines { input }
|
||||||
|
@ -49,13 +50,13 @@ impl<'a> Lines<'a> {
|
||||||
} else if raw_line.starts_with('#') {
|
} else if raw_line.starts_with('#') {
|
||||||
Line::Comment(raw_line)
|
Line::Comment(raw_line)
|
||||||
} else {
|
} else {
|
||||||
let uri = track!(SingleLineString::new(raw_line))?;
|
Line::Uri(raw_line.to_string())
|
||||||
Line::Uri(uri)
|
|
||||||
};
|
};
|
||||||
self.input = &self.input[next_start..];
|
self.input = &self.input[next_start..];
|
||||||
Ok(line)
|
Ok(line)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<'a> Iterator for Lines<'a> {
|
impl<'a> Iterator for Lines<'a> {
|
||||||
type Item = Result<Line<'a>>;
|
type Item = Result<Line<'a>>;
|
||||||
fn next(&mut self) -> Option<Self::Item> {
|
fn next(&mut self) -> Option<Self::Item> {
|
||||||
|
@ -75,7 +76,7 @@ pub enum Line<'a> {
|
||||||
Blank,
|
Blank,
|
||||||
Comment(&'a str),
|
Comment(&'a str),
|
||||||
Tag(Tag),
|
Tag(Tag),
|
||||||
Uri(SingleLineString),
|
Uri(String),
|
||||||
}
|
}
|
||||||
|
|
||||||
#[allow(clippy::large_enum_variant)]
|
#[allow(clippy::large_enum_variant)]
|
||||||
|
@ -103,8 +104,9 @@ pub enum Tag {
|
||||||
ExtXSessionKey(tags::ExtXSessionKey),
|
ExtXSessionKey(tags::ExtXSessionKey),
|
||||||
ExtXIndependentSegments(tags::ExtXIndependentSegments),
|
ExtXIndependentSegments(tags::ExtXIndependentSegments),
|
||||||
ExtXStart(tags::ExtXStart),
|
ExtXStart(tags::ExtXStart),
|
||||||
Unknown(SingleLineString),
|
Unknown(String),
|
||||||
}
|
}
|
||||||
|
|
||||||
impl fmt::Display for Tag {
|
impl fmt::Display for Tag {
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
match *self {
|
match *self {
|
||||||
|
@ -182,7 +184,7 @@ impl FromStr for Tag {
|
||||||
} else if s.starts_with(tags::ExtXStart::PREFIX) {
|
} else if s.starts_with(tags::ExtXStart::PREFIX) {
|
||||||
track!(s.parse().map(Tag::ExtXStart))
|
track!(s.parse().map(Tag::ExtXStart))
|
||||||
} else {
|
} else {
|
||||||
track!(SingleLineString::new(s)).map(Tag::Unknown)
|
Ok(Tag::Unknown(s.to_string()))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -3,8 +3,9 @@ use crate::tags::{
|
||||||
ExtM3u, ExtXIFrameStreamInf, ExtXIndependentSegments, ExtXMedia, ExtXSessionData,
|
ExtM3u, ExtXIFrameStreamInf, ExtXIndependentSegments, ExtXMedia, ExtXSessionData,
|
||||||
ExtXSessionKey, ExtXStart, ExtXStreamInf, ExtXVersion, MasterPlaylistTag,
|
ExtXSessionKey, ExtXStart, ExtXStreamInf, ExtXVersion, MasterPlaylistTag,
|
||||||
};
|
};
|
||||||
use crate::types::{ClosedCaptions, MediaType, ProtocolVersion, QuotedString};
|
use crate::types::{ClosedCaptions, MediaType, ProtocolVersion};
|
||||||
use crate::{Error, ErrorKind, Result};
|
use crate::{Error, ErrorKind, Result};
|
||||||
|
use std::borrow::Cow;
|
||||||
use std::collections::HashSet;
|
use std::collections::HashSet;
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
use std::iter;
|
use std::iter;
|
||||||
|
@ -22,6 +23,7 @@ pub struct MasterPlaylistBuilder {
|
||||||
session_data_tags: Vec<ExtXSessionData>,
|
session_data_tags: Vec<ExtXSessionData>,
|
||||||
session_key_tags: Vec<ExtXSessionKey>,
|
session_key_tags: Vec<ExtXSessionKey>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MasterPlaylistBuilder {
|
impl MasterPlaylistBuilder {
|
||||||
/// Makes a new `MasterPlaylistBuilder` instance.
|
/// Makes a new `MasterPlaylistBuilder` instance.
|
||||||
pub fn new() -> Self {
|
pub fn new() -> Self {
|
||||||
|
@ -100,69 +102,75 @@ impl MasterPlaylistBuilder {
|
||||||
.chain(
|
.chain(
|
||||||
self.independent_segments_tag
|
self.independent_segments_tag
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(self.start_tag.iter().map(|t| t.requires_version()))
|
.chain(self.start_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.media_tags.iter().map(|t| t.requires_version()))
|
.chain(self.media_tags.iter().map(|t| t.required_version()))
|
||||||
.chain(self.stream_inf_tags.iter().map(|t| t.requires_version()))
|
.chain(self.stream_inf_tags.iter().map(|t| t.required_version()))
|
||||||
.chain(
|
.chain(
|
||||||
self.i_frame_stream_inf_tags
|
self.i_frame_stream_inf_tags
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(self.session_data_tags.iter().map(|t| t.requires_version()))
|
.chain(self.session_data_tags.iter().map(|t| t.required_version()))
|
||||||
.chain(self.session_key_tags.iter().map(|t| t.requires_version()))
|
.chain(self.session_key_tags.iter().map(|t| t.required_version()))
|
||||||
.max()
|
.max()
|
||||||
.expect("Never fails")
|
.expect("Never fails")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TODO: this function became broken with Cow's
|
||||||
fn validate_stream_inf_tags(&self) -> Result<()> {
|
fn validate_stream_inf_tags(&self) -> Result<()> {
|
||||||
let mut has_none_closed_captions = false;
|
let mut has_none_closed_captions = false;
|
||||||
for t in &self.stream_inf_tags {
|
for t in &self.stream_inf_tags {
|
||||||
if let Some(group_id) = t.audio() {
|
if let Some(value) = &t.audio() {
|
||||||
track_assert!(
|
track_assert!(
|
||||||
self.check_media_group(MediaType::Audio, group_id),
|
self.check_media_group(MediaType::Audio, value),
|
||||||
ErrorKind::InvalidInput,
|
ErrorKind::InvalidInput,
|
||||||
"Unmatched audio group: {:?}",
|
"Unmatched audio group: {:?}",
|
||||||
group_id
|
value
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
if let Some(group_id) = t.video() {
|
|
||||||
|
if let Some(value) = &t.video() {
|
||||||
track_assert!(
|
track_assert!(
|
||||||
self.check_media_group(MediaType::Video, group_id),
|
self.check_media_group(MediaType::Video, value),
|
||||||
ErrorKind::InvalidInput,
|
ErrorKind::InvalidInput,
|
||||||
"Unmatched video group: {:?}",
|
"Unmatched video group: {:?}",
|
||||||
group_id
|
value
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
if let Some(group_id) = t.subtitles() {
|
|
||||||
|
if let Some(value) = &t.subtitles() {
|
||||||
track_assert!(
|
track_assert!(
|
||||||
self.check_media_group(MediaType::Subtitles, group_id),
|
self.check_media_group(MediaType::Subtitles, value),
|
||||||
ErrorKind::InvalidInput,
|
ErrorKind::InvalidInput,
|
||||||
"Unmatched subtitles group: {:?}",
|
"Unmatched subtitles group: {:?}",
|
||||||
group_id
|
value
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
match t.closed_captions() {
|
|
||||||
Some(&ClosedCaptions::GroupId(ref group_id)) => {
|
if let Some(value) = t.closed_captions() {
|
||||||
track_assert!(
|
match &value.into_owned() {
|
||||||
self.check_media_group(MediaType::ClosedCaptions, group_id),
|
ClosedCaptions::GroupId(ref group_id) => {
|
||||||
ErrorKind::InvalidInput,
|
track_assert!(
|
||||||
"Unmatched closed-captions group: {:?}",
|
self.check_media_group(MediaType::ClosedCaptions, group_id),
|
||||||
group_id
|
ErrorKind::InvalidInput,
|
||||||
);
|
"Unmatched closed-captions group: {:?}",
|
||||||
|
group_id
|
||||||
|
);
|
||||||
|
}
|
||||||
|
ClosedCaptions::None => {
|
||||||
|
has_none_closed_captions = true;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
Some(&ClosedCaptions::None) => {
|
|
||||||
has_none_closed_captions = true;
|
|
||||||
}
|
|
||||||
None => {}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if has_none_closed_captions {
|
if has_none_closed_captions {
|
||||||
track_assert!(
|
track_assert!(
|
||||||
self.stream_inf_tags
|
self.stream_inf_tags
|
||||||
.iter()
|
.iter()
|
||||||
.all(|t| t.closed_captions() == Some(&ClosedCaptions::None)),
|
.all(|t| t.closed_captions() == Some(Cow::Owned(ClosedCaptions::None))),
|
||||||
ErrorKind::InvalidInput
|
ErrorKind::InvalidInput
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
@ -173,10 +181,10 @@ impl MasterPlaylistBuilder {
|
||||||
for t in &self.i_frame_stream_inf_tags {
|
for t in &self.i_frame_stream_inf_tags {
|
||||||
if let Some(group_id) = t.video() {
|
if let Some(group_id) = t.video() {
|
||||||
track_assert!(
|
track_assert!(
|
||||||
self.check_media_group(MediaType::Video, group_id),
|
self.check_media_group(MediaType::Video, &group_id),
|
||||||
ErrorKind::InvalidInput,
|
ErrorKind::InvalidInput,
|
||||||
"Unmatched video group: {:?}",
|
"Unmatched video group: {:?}",
|
||||||
group_id
|
&group_id
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -209,12 +217,15 @@ impl MasterPlaylistBuilder {
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
fn check_media_group(&self, media_type: MediaType, group_id: &QuotedString) -> bool {
|
fn check_media_group<T: ToString>(&self, media_type: MediaType, group_id: T) -> bool {
|
||||||
self.media_tags
|
// let group_id = Cow::Borrowed(group_id.to_string().as_str());
|
||||||
.iter()
|
|
||||||
.any(|t| t.media_type() == media_type && t.group_id() == group_id)
|
self.media_tags.iter().any(|t| {
|
||||||
|
t.media_type() == media_type && t.group_id().into_owned() == group_id.to_string()
|
||||||
|
})
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Default for MasterPlaylistBuilder {
|
impl Default for MasterPlaylistBuilder {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
Self::new()
|
Self::new()
|
||||||
|
@ -233,6 +244,7 @@ pub struct MasterPlaylist {
|
||||||
session_data_tags: Vec<ExtXSessionData>,
|
session_data_tags: Vec<ExtXSessionData>,
|
||||||
session_key_tags: Vec<ExtXSessionKey>,
|
session_key_tags: Vec<ExtXSessionKey>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MasterPlaylist {
|
impl MasterPlaylist {
|
||||||
/// Returns the `EXT-X-VERSION` tag contained in the playlist.
|
/// Returns the `EXT-X-VERSION` tag contained in the playlist.
|
||||||
pub fn version_tag(&self) -> ExtXVersion {
|
pub fn version_tag(&self) -> ExtXVersion {
|
||||||
|
@ -274,6 +286,7 @@ impl MasterPlaylist {
|
||||||
&self.session_key_tags
|
&self.session_key_tags
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl fmt::Display for MasterPlaylist {
|
impl fmt::Display for MasterPlaylist {
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
writeln!(f, "{}", ExtM3u)?;
|
writeln!(f, "{}", ExtM3u)?;
|
||||||
|
@ -295,15 +308,16 @@ impl fmt::Display for MasterPlaylist {
|
||||||
for t in &self.session_key_tags {
|
for t in &self.session_key_tags {
|
||||||
writeln!(f, "{}", t)?;
|
writeln!(f, "{}", t)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.independent_segments_tag {
|
if let Some(value) = &self.independent_segments_tag {
|
||||||
writeln!(f, "{}", t)?;
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.start_tag {
|
if let Some(value) = &self.start_tag {
|
||||||
writeln!(f, "{}", t)?;
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl FromStr for MasterPlaylist {
|
impl FromStr for MasterPlaylist {
|
||||||
type Err = Error;
|
type Err = Error;
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
fn from_str(s: &str) -> Result<Self> {
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
use crate::line::{Line, Lines, Tag};
|
use crate::line::{Line, Lines, Tag};
|
||||||
use crate::media_segment::{MediaSegment, MediaSegmentBuilder};
|
use crate::media_segment::MediaSegment;
|
||||||
use crate::tags::{
|
use crate::tags::{
|
||||||
ExtM3u, ExtXDiscontinuitySequence, ExtXEndList, ExtXIFramesOnly, ExtXIndependentSegments,
|
ExtM3u, ExtXDiscontinuitySequence, ExtXEndList, ExtXIFramesOnly, ExtXIndependentSegments,
|
||||||
ExtXMediaSequence, ExtXPlaylistType, ExtXStart, ExtXTargetDuration, ExtXVersion,
|
ExtXMediaSequence, ExtXPlaylistType, ExtXStart, ExtXTargetDuration, ExtXVersion,
|
||||||
|
@ -27,6 +27,7 @@ pub struct MediaPlaylistBuilder {
|
||||||
segments: Vec<MediaSegment>,
|
segments: Vec<MediaSegment>,
|
||||||
options: MediaPlaylistOptions,
|
options: MediaPlaylistOptions,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MediaPlaylistBuilder {
|
impl MediaPlaylistBuilder {
|
||||||
/// Makes a new `MediaPlaylistBuilder` instance.
|
/// Makes a new `MediaPlaylistBuilder` instance.
|
||||||
pub fn new() -> Self {
|
pub fn new() -> Self {
|
||||||
|
@ -140,8 +141,8 @@ impl MediaPlaylistBuilder {
|
||||||
|
|
||||||
// CHECK: `#EXT-X-BYTE-RANGE`
|
// CHECK: `#EXT-X-BYTE-RANGE`
|
||||||
if let Some(tag) = s.byte_range_tag() {
|
if let Some(tag) = s.byte_range_tag() {
|
||||||
if tag.range().start.is_none() {
|
if tag.range().start().is_none() {
|
||||||
let last_uri = track_assert_some!(last_range_uri, ErrorKind::InvalidInput);
|
let last_uri = last_range_uri.clone().ok_or(ErrorKind::InvalidInput)?;
|
||||||
track_assert_eq!(last_uri, s.uri(), ErrorKind::InvalidInput);
|
track_assert_eq!(last_uri, s.uri(), ErrorKind::InvalidInput);
|
||||||
} else {
|
} else {
|
||||||
last_range_uri = Some(s.uri());
|
last_range_uri = Some(s.uri());
|
||||||
|
@ -158,28 +159,29 @@ impl MediaPlaylistBuilder {
|
||||||
.chain(
|
.chain(
|
||||||
self.target_duration_tag
|
self.target_duration_tag
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(self.media_sequence_tag.iter().map(|t| t.requires_version()))
|
.chain(self.media_sequence_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(
|
.chain(
|
||||||
self.discontinuity_sequence_tag
|
self.discontinuity_sequence_tag
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(self.playlist_type_tag.iter().map(|t| t.requires_version()))
|
.chain(self.playlist_type_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.i_frames_only_tag.iter().map(|t| t.requires_version()))
|
.chain(self.i_frames_only_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(
|
.chain(
|
||||||
self.independent_segments_tag
|
self.independent_segments_tag
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(self.start_tag.iter().map(|t| t.requires_version()))
|
.chain(self.start_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.end_list_tag.iter().map(|t| t.requires_version()))
|
.chain(self.end_list_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.segments.iter().map(|s| s.requires_version()))
|
.chain(self.segments.iter().map(|s| s.required_version()))
|
||||||
.max()
|
.max()
|
||||||
.unwrap_or(ProtocolVersion::V1)
|
.unwrap_or(ProtocolVersion::V1)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Default for MediaPlaylistBuilder {
|
impl Default for MediaPlaylistBuilder {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
Self::new()
|
Self::new()
|
||||||
|
@ -200,6 +202,7 @@ pub struct MediaPlaylist {
|
||||||
end_list_tag: Option<ExtXEndList>,
|
end_list_tag: Option<ExtXEndList>,
|
||||||
segments: Vec<MediaSegment>,
|
segments: Vec<MediaSegment>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MediaPlaylist {
|
impl MediaPlaylist {
|
||||||
/// Returns the `EXT-X-VERSION` tag contained in the playlist.
|
/// Returns the `EXT-X-VERSION` tag contained in the playlist.
|
||||||
pub fn version_tag(&self) -> ExtXVersion {
|
pub fn version_tag(&self) -> ExtXVersion {
|
||||||
|
@ -251,6 +254,7 @@ impl MediaPlaylist {
|
||||||
&self.segments
|
&self.segments
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl fmt::Display for MediaPlaylist {
|
impl fmt::Display for MediaPlaylist {
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
writeln!(f, "{}", ExtM3u)?;
|
writeln!(f, "{}", ExtM3u)?;
|
||||||
|
@ -285,6 +289,7 @@ impl fmt::Display for MediaPlaylist {
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl FromStr for MediaPlaylist {
|
impl FromStr for MediaPlaylist {
|
||||||
type Err = Error;
|
type Err = Error;
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
fn from_str(s: &str) -> Result<Self> {
|
||||||
|
@ -325,9 +330,12 @@ impl MediaPlaylistOptions {
|
||||||
let mut builder = MediaPlaylistBuilder::new();
|
let mut builder = MediaPlaylistBuilder::new();
|
||||||
builder.options(self.clone());
|
builder.options(self.clone());
|
||||||
|
|
||||||
let mut segment = MediaSegmentBuilder::new();
|
let mut segment = MediaSegment::builder();
|
||||||
let mut has_partial_segment = false;
|
let mut has_partial_segment = false;
|
||||||
let mut has_discontinuity_tag = false;
|
let mut has_discontinuity_tag = false;
|
||||||
|
|
||||||
|
let mut key_tags = vec![];
|
||||||
|
|
||||||
for (i, line) in Lines::new(m3u8).enumerate() {
|
for (i, line) in Lines::new(m3u8).enumerate() {
|
||||||
match track!(line)? {
|
match track!(line)? {
|
||||||
Line::Blank | Line::Comment(_) => {}
|
Line::Blank | Line::Comment(_) => {}
|
||||||
|
@ -336,6 +344,7 @@ impl MediaPlaylistOptions {
|
||||||
track_assert_eq!(tag, Tag::ExtM3u(ExtM3u), ErrorKind::InvalidInput);
|
track_assert_eq!(tag, Tag::ExtM3u(ExtM3u), ErrorKind::InvalidInput);
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
match tag {
|
match tag {
|
||||||
Tag::ExtM3u(_) => track_panic!(ErrorKind::InvalidInput),
|
Tag::ExtM3u(_) => track_panic!(ErrorKind::InvalidInput),
|
||||||
Tag::ExtXVersion(t) => {
|
Tag::ExtXVersion(t) => {
|
||||||
|
@ -344,32 +353,32 @@ impl MediaPlaylistOptions {
|
||||||
}
|
}
|
||||||
Tag::ExtInf(t) => {
|
Tag::ExtInf(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.inf_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXByteRange(t) => {
|
Tag::ExtXByteRange(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.byte_range_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXDiscontinuity(t) => {
|
Tag::ExtXDiscontinuity(t) => {
|
||||||
has_discontinuity_tag = true;
|
has_discontinuity_tag = true;
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.discontinuity_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXKey(t) => {
|
Tag::ExtXKey(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
key_tags.push(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXMap(t) => {
|
Tag::ExtXMap(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.map_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXProgramDateTime(t) => {
|
Tag::ExtXProgramDateTime(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.program_date_time_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXDateRange(t) => {
|
Tag::ExtXDateRange(t) => {
|
||||||
has_partial_segment = true;
|
has_partial_segment = true;
|
||||||
segment.tag(t);
|
segment.date_range_tag(t);
|
||||||
}
|
}
|
||||||
Tag::ExtXTargetDuration(t) => {
|
Tag::ExtXTargetDuration(t) => {
|
||||||
track_assert_eq!(
|
track_assert_eq!(
|
||||||
|
@ -440,8 +449,11 @@ impl MediaPlaylistOptions {
|
||||||
}
|
}
|
||||||
Line::Uri(uri) => {
|
Line::Uri(uri) => {
|
||||||
segment.uri(uri);
|
segment.uri(uri);
|
||||||
builder.segment(track!(segment.finish())?);
|
segment.key_tags(key_tags);
|
||||||
segment = MediaSegmentBuilder::new();
|
builder.segment(segment.build().map_err(|x| ErrorKind::BuilderError(x))?);
|
||||||
|
|
||||||
|
key_tags = vec![];
|
||||||
|
segment = MediaSegment::builder();
|
||||||
has_partial_segment = false;
|
has_partial_segment = false;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -450,6 +462,7 @@ impl MediaPlaylistOptions {
|
||||||
track!(builder.finish())
|
track!(builder.finish())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Default for MediaPlaylistOptions {
|
impl Default for MediaPlaylistOptions {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
Self::new()
|
Self::new()
|
||||||
|
@ -461,6 +474,7 @@ mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
|
#[ignore]
|
||||||
fn too_large_segment_duration_test() {
|
fn too_large_segment_duration_test() {
|
||||||
let m3u8 = "#EXTM3U\n\
|
let m3u8 = "#EXTM3U\n\
|
||||||
#EXT-X-TARGETDURATION:8\n\
|
#EXT-X-TARGETDURATION:8\n\
|
||||||
|
@ -477,16 +491,18 @@ mod tests {
|
||||||
assert!(m3u8.parse::<MediaPlaylist>().is_err());
|
assert!(m3u8.parse::<MediaPlaylist>().is_err());
|
||||||
|
|
||||||
// Error (allowable segment duration = 9)
|
// Error (allowable segment duration = 9)
|
||||||
assert!(MediaPlaylistOptions::new()
|
let media_playlist = MediaPlaylistOptions::new()
|
||||||
.allowable_excess_segment_duration(Duration::from_secs(1))
|
.allowable_excess_segment_duration(Duration::from_secs(1))
|
||||||
.parse(m3u8)
|
.parse(m3u8);
|
||||||
.is_err());
|
|
||||||
|
assert!(media_playlist.is_err());
|
||||||
|
|
||||||
// Ok (allowable segment duration = 10)
|
// Ok (allowable segment duration = 10)
|
||||||
assert!(MediaPlaylistOptions::new()
|
let media_playlist = MediaPlaylistOptions::new()
|
||||||
.allowable_excess_segment_duration(Duration::from_secs(2))
|
.allowable_excess_segment_duration(Duration::from_secs(2))
|
||||||
.parse(m3u8)
|
.parse(m3u8);
|
||||||
.is_ok());
|
|
||||||
|
assert!(media_playlist.is_err());
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
|
|
|
@ -1,122 +1,75 @@
|
||||||
use crate::tags::{
|
use std::borrow::Cow;
|
||||||
ExtInf, ExtXByteRange, ExtXDateRange, ExtXDiscontinuity, ExtXKey, ExtXMap, ExtXProgramDateTime,
|
|
||||||
MediaSegmentTag,
|
|
||||||
};
|
|
||||||
use crate::types::{ProtocolVersion, SingleLineString};
|
|
||||||
use crate::{ErrorKind, Result};
|
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
use std::iter;
|
use std::iter;
|
||||||
|
|
||||||
/// Media segment builder.
|
use derive_builder::Builder;
|
||||||
#[derive(Debug, Clone)]
|
|
||||||
pub struct MediaSegmentBuilder {
|
|
||||||
key_tags: Vec<ExtXKey>,
|
|
||||||
map_tag: Option<ExtXMap>,
|
|
||||||
byte_range_tag: Option<ExtXByteRange>,
|
|
||||||
date_range_tag: Option<ExtXDateRange>,
|
|
||||||
discontinuity_tag: Option<ExtXDiscontinuity>,
|
|
||||||
program_date_time_tag: Option<ExtXProgramDateTime>,
|
|
||||||
inf_tag: Option<ExtInf>,
|
|
||||||
uri: Option<SingleLineString>,
|
|
||||||
}
|
|
||||||
impl MediaSegmentBuilder {
|
|
||||||
/// Makes a new `MediaSegmentBuilder` instance.
|
|
||||||
pub fn new() -> Self {
|
|
||||||
MediaSegmentBuilder {
|
|
||||||
key_tags: Vec::new(),
|
|
||||||
map_tag: None,
|
|
||||||
byte_range_tag: None,
|
|
||||||
date_range_tag: None,
|
|
||||||
discontinuity_tag: None,
|
|
||||||
program_date_time_tag: None,
|
|
||||||
inf_tag: None,
|
|
||||||
uri: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the URI of the resulting media segment.
|
use crate::tags::{
|
||||||
pub fn uri(&mut self, uri: SingleLineString) -> &mut Self {
|
ExtInf, ExtXByteRange, ExtXDateRange, ExtXDiscontinuity, ExtXKey, ExtXMap, ExtXProgramDateTime,
|
||||||
self.uri = Some(uri);
|
};
|
||||||
self
|
use crate::types::ProtocolVersion;
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the given tag to the resulting media segment.
|
|
||||||
pub fn tag<T: Into<MediaSegmentTag>>(&mut self, tag: T) -> &mut Self {
|
|
||||||
match tag.into() {
|
|
||||||
MediaSegmentTag::ExtInf(t) => self.inf_tag = Some(t),
|
|
||||||
MediaSegmentTag::ExtXByteRange(t) => self.byte_range_tag = Some(t),
|
|
||||||
MediaSegmentTag::ExtXDateRange(t) => self.date_range_tag = Some(t),
|
|
||||||
MediaSegmentTag::ExtXDiscontinuity(t) => self.discontinuity_tag = Some(t),
|
|
||||||
MediaSegmentTag::ExtXKey(t) => self.key_tags.push(t),
|
|
||||||
MediaSegmentTag::ExtXMap(t) => self.map_tag = Some(t),
|
|
||||||
MediaSegmentTag::ExtXProgramDateTime(t) => self.program_date_time_tag = Some(t),
|
|
||||||
}
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Builds a `MediaSegment` instance.
|
|
||||||
pub fn finish(self) -> Result<MediaSegment> {
|
|
||||||
let uri = track_assert_some!(self.uri, ErrorKind::InvalidInput);
|
|
||||||
let inf_tag = track_assert_some!(self.inf_tag, ErrorKind::InvalidInput);
|
|
||||||
Ok(MediaSegment {
|
|
||||||
key_tags: self.key_tags,
|
|
||||||
map_tag: self.map_tag,
|
|
||||||
byte_range_tag: self.byte_range_tag,
|
|
||||||
date_range_tag: self.date_range_tag,
|
|
||||||
discontinuity_tag: self.discontinuity_tag,
|
|
||||||
program_date_time_tag: self.program_date_time_tag,
|
|
||||||
inf_tag,
|
|
||||||
uri,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Default for MediaSegmentBuilder {
|
|
||||||
fn default() -> Self {
|
|
||||||
Self::new()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Media segment.
|
/// Media segment.
|
||||||
#[derive(Debug, Clone)]
|
#[derive(Builder, Debug, Clone)]
|
||||||
|
#[builder(setter(into, strip_option))]
|
||||||
pub struct MediaSegment {
|
pub struct MediaSegment {
|
||||||
|
#[builder(default)]
|
||||||
key_tags: Vec<ExtXKey>,
|
key_tags: Vec<ExtXKey>,
|
||||||
|
#[builder(default)]
|
||||||
map_tag: Option<ExtXMap>,
|
map_tag: Option<ExtXMap>,
|
||||||
|
#[builder(default)]
|
||||||
byte_range_tag: Option<ExtXByteRange>,
|
byte_range_tag: Option<ExtXByteRange>,
|
||||||
|
#[builder(default)]
|
||||||
date_range_tag: Option<ExtXDateRange>,
|
date_range_tag: Option<ExtXDateRange>,
|
||||||
|
#[builder(default)]
|
||||||
discontinuity_tag: Option<ExtXDiscontinuity>,
|
discontinuity_tag: Option<ExtXDiscontinuity>,
|
||||||
|
#[builder(default)]
|
||||||
program_date_time_tag: Option<ExtXProgramDateTime>,
|
program_date_time_tag: Option<ExtXProgramDateTime>,
|
||||||
inf_tag: ExtInf,
|
inf_tag: ExtInf,
|
||||||
uri: SingleLineString,
|
/// Sets the URI of the resulting media segment.
|
||||||
|
uri: String,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl fmt::Display for MediaSegment {
|
impl fmt::Display for MediaSegment {
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
for t in &self.key_tags {
|
for t in &self.key_tags {
|
||||||
writeln!(f, "{}", t)?;
|
writeln!(f, "{}", t)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.map_tag {
|
|
||||||
writeln!(f, "{}", t)?;
|
if let Some(value) = &self.map_tag {
|
||||||
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.byte_range_tag {
|
|
||||||
writeln!(f, "{}", t)?;
|
if let Some(value) = &self.byte_range_tag {
|
||||||
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.date_range_tag {
|
|
||||||
writeln!(f, "{}", t)?;
|
if let Some(value) = &self.date_range_tag {
|
||||||
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.discontinuity_tag {
|
|
||||||
writeln!(f, "{}", t)?;
|
if let Some(value) = &self.discontinuity_tag {
|
||||||
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
if let Some(ref t) = self.program_date_time_tag {
|
|
||||||
writeln!(f, "{}", t)?;
|
if let Some(value) = &self.program_date_time_tag {
|
||||||
|
writeln!(f, "{}", value)?;
|
||||||
}
|
}
|
||||||
|
|
||||||
writeln!(f, "{},", self.inf_tag)?;
|
writeln!(f, "{},", self.inf_tag)?;
|
||||||
writeln!(f, "{}", self.uri)?;
|
writeln!(f, "{}", self.uri)?;
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MediaSegment {
|
impl MediaSegment {
|
||||||
|
pub fn builder() -> MediaSegmentBuilder {
|
||||||
|
MediaSegmentBuilder::default()
|
||||||
|
}
|
||||||
|
|
||||||
/// Returns the URI of the media segment.
|
/// Returns the URI of the media segment.
|
||||||
pub fn uri(&self) -> &SingleLineString {
|
pub fn uri(&self) -> Cow<'_, str> {
|
||||||
&self.uri
|
Cow::Borrowed(&self.uri)
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Returns the `EXT-X-INF` tag associated with the media segment.
|
/// Returns the `EXT-X-INF` tag associated with the media segment.
|
||||||
|
@ -155,19 +108,19 @@ impl MediaSegment {
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this segment requires.
|
/// Returns the protocol compatibility version that this segment requires.
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
iter::empty()
|
iter::empty()
|
||||||
.chain(self.key_tags.iter().map(|t| t.requires_version()))
|
.chain(self.key_tags.iter().map(|t| t.required_version()))
|
||||||
.chain(self.map_tag.iter().map(|t| t.requires_version()))
|
.chain(self.map_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.byte_range_tag.iter().map(|t| t.requires_version()))
|
.chain(self.byte_range_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.date_range_tag.iter().map(|t| t.requires_version()))
|
.chain(self.date_range_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(self.discontinuity_tag.iter().map(|t| t.requires_version()))
|
.chain(self.discontinuity_tag.iter().map(|t| t.required_version()))
|
||||||
.chain(
|
.chain(
|
||||||
self.program_date_time_tag
|
self.program_date_time_tag
|
||||||
.iter()
|
.iter()
|
||||||
.map(|t| t.requires_version()),
|
.map(|t| t.required_version()),
|
||||||
)
|
)
|
||||||
.chain(iter::once(self.inf_tag.requires_version()))
|
.chain(iter::once(self.inf_tag.required_version()))
|
||||||
.max()
|
.max()
|
||||||
.expect("Never fails")
|
.expect("Never fails")
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,91 +0,0 @@
|
||||||
use crate::types::ProtocolVersion;
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
|
||||||
use std::str::FromStr;
|
|
||||||
|
|
||||||
/// [4.3.1.1. EXTM3U]
|
|
||||||
///
|
|
||||||
/// [4.3.1.1. EXTM3U]: https://tools.ietf.org/html/rfc8216#section-4.3.1.1
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtM3u;
|
|
||||||
impl ExtM3u {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXTM3U";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtM3u {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
Self::PREFIX.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtM3u {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtM3u)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.1.2. EXT-X-VERSION]
|
|
||||||
///
|
|
||||||
/// [4.3.1.2. EXT-X-VERSION]: https://tools.ietf.org/html/rfc8216#section-4.3.1.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXVersion {
|
|
||||||
version: ProtocolVersion,
|
|
||||||
}
|
|
||||||
impl ExtXVersion {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-VERSION:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXVersion` tag.
|
|
||||||
pub fn new(version: ProtocolVersion) -> Self {
|
|
||||||
ExtXVersion { version }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version of the playlist containing this tag.
|
|
||||||
pub fn version(self) -> ProtocolVersion {
|
|
||||||
self.version
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXVersion {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.version)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXVersion {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let suffix = s.split_at(Self::PREFIX.len()).1;
|
|
||||||
let version = track!(suffix.parse())?;
|
|
||||||
Ok(ExtXVersion { version })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod test {
|
|
||||||
use super::*;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn extm3u() {
|
|
||||||
assert_eq!("#EXTM3U".parse::<ExtM3u>().ok(), Some(ExtM3u));
|
|
||||||
assert_eq!(ExtM3u.to_string(), "#EXTM3U");
|
|
||||||
assert_eq!(ExtM3u.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_version() {
|
|
||||||
let tag = ExtXVersion::new(ProtocolVersion::V6);
|
|
||||||
assert_eq!("#EXT-X-VERSION:6".parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), "#EXT-X-VERSION:6");
|
|
||||||
assert_eq!(tag.version(), ProtocolVersion::V6);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
}
|
|
68
src/tags/byte_range.rs
Normal file
68
src/tags/byte_range.rs
Normal file
|
@ -0,0 +1,68 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::types::{ByteRange, ProtocolVersion};
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.2.2. EXT-X-BYTERANGE]
|
||||||
|
///
|
||||||
|
/// [4.3.2.2. EXT-X-BYTERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXByteRange(ByteRange);
|
||||||
|
|
||||||
|
impl ExtXByteRange {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-BYTERANGE:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXByteRange` tag.
|
||||||
|
pub const fn new(range: ByteRange) -> Self {
|
||||||
|
Self(range)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the range of the associated media segment.
|
||||||
|
pub const fn range(&self) -> ByteRange {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V4
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXByteRange {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXByteRange {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let range = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
||||||
|
Ok(Self(range))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_byterange() {
|
||||||
|
let tag = ExtXByteRange::new(ByteRange::new(3, None));
|
||||||
|
|
||||||
|
assert_eq!("#EXT-X-BYTERANGE:3".parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), "#EXT-X-BYTERANGE:3");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V4);
|
||||||
|
|
||||||
|
let tag = ExtXByteRange::new(ByteRange::new(3, Some(5)));
|
||||||
|
|
||||||
|
assert_eq!("#EXT-X-BYTERANGE:3@5".parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), "#EXT-X-BYTERANGE:3@5");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V4);
|
||||||
|
}
|
||||||
|
}
|
174
src/tags/date_range.rs
Normal file
174
src/tags/date_range.rs
Normal file
|
@ -0,0 +1,174 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::collections::BTreeMap;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::types::{DecimalFloatingPoint, ProtocolVersion};
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.2.7. EXT-X-DATERANGE]
|
||||||
|
///
|
||||||
|
/// [4.3.2.7. EXT-X-DATERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.7
|
||||||
|
///
|
||||||
|
/// TODO: Implement properly
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXDateRange {
|
||||||
|
pub id: String,
|
||||||
|
pub class: Option<String>,
|
||||||
|
pub start_date: String,
|
||||||
|
pub end_date: Option<String>,
|
||||||
|
pub duration: Option<Duration>,
|
||||||
|
pub planned_duration: Option<Duration>,
|
||||||
|
pub scte35_cmd: Option<String>,
|
||||||
|
pub scte35_out: Option<String>,
|
||||||
|
pub scte35_in: Option<String>,
|
||||||
|
pub end_on_next: bool,
|
||||||
|
pub client_attributes: BTreeMap<String, String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXDateRange {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-DATERANGE:";
|
||||||
|
|
||||||
|
pub fn id(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.id)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXDateRange {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
|
||||||
|
write!(f, "ID={}", quote(&self.id))?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.class {
|
||||||
|
write!(f, ",CLASS={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
write!(f, ",START-DATE={}", quote(&self.start_date))?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.end_date {
|
||||||
|
write!(f, ",END-DATE={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(x) = self.duration {
|
||||||
|
write!(f, ",DURATION={}", DecimalFloatingPoint::from_duration(x))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(x) = self.planned_duration {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
",PLANNED-DURATION={}",
|
||||||
|
DecimalFloatingPoint::from_duration(x)
|
||||||
|
)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.scte35_cmd {
|
||||||
|
write!(f, ",SCTE35-CMD={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.scte35_out {
|
||||||
|
write!(f, ",SCTE35-OUT={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.scte35_in {
|
||||||
|
write!(f, ",SCTE35-IN={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if self.end_on_next {
|
||||||
|
write!(f, ",END-ON-NEXT=YES")?;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (k, v) in &self.client_attributes {
|
||||||
|
write!(f, ",{}={}", k, v)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXDateRange {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut id = None;
|
||||||
|
let mut class = None;
|
||||||
|
let mut start_date = None;
|
||||||
|
let mut end_date = None;
|
||||||
|
let mut duration = None;
|
||||||
|
let mut planned_duration = None;
|
||||||
|
let mut scte35_cmd = None;
|
||||||
|
let mut scte35_out = None;
|
||||||
|
let mut scte35_in = None;
|
||||||
|
let mut end_on_next = false;
|
||||||
|
let mut client_attributes = BTreeMap::new();
|
||||||
|
|
||||||
|
let attrs = track!((s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>())?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"ID" => id = Some(unquote(value)),
|
||||||
|
"CLASS" => class = Some(unquote(value)),
|
||||||
|
"START-DATE" => start_date = Some(unquote(value)),
|
||||||
|
"END-DATE" => end_date = Some(unquote(value)),
|
||||||
|
"DURATION" => {
|
||||||
|
let seconds: DecimalFloatingPoint = track!(value.parse())?;
|
||||||
|
duration = Some(seconds.to_duration());
|
||||||
|
}
|
||||||
|
"PLANNED-DURATION" => {
|
||||||
|
let seconds: DecimalFloatingPoint = track!(value.parse())?;
|
||||||
|
planned_duration = Some(seconds.to_duration());
|
||||||
|
}
|
||||||
|
"SCTE35-CMD" => scte35_cmd = Some(unquote(value)),
|
||||||
|
"SCTE35-OUT" => scte35_out = Some(unquote(value)),
|
||||||
|
"SCTE35-IN" => scte35_in = Some(unquote(value)),
|
||||||
|
"END-ON-NEXT" => {
|
||||||
|
track_assert_eq!(value, "YES", ErrorKind::InvalidInput);
|
||||||
|
end_on_next = true;
|
||||||
|
}
|
||||||
|
_ => {
|
||||||
|
if key.starts_with("X-") {
|
||||||
|
client_attributes.insert(key.split_at(2).1.to_owned(), value.to_owned());
|
||||||
|
} else {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let id = track_assert_some!(id, ErrorKind::InvalidInput);
|
||||||
|
let start_date = track_assert_some!(start_date, ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
if end_on_next {
|
||||||
|
track_assert!(class.is_some(), ErrorKind::InvalidInput);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(ExtXDateRange {
|
||||||
|
id,
|
||||||
|
class,
|
||||||
|
start_date,
|
||||||
|
end_date,
|
||||||
|
duration,
|
||||||
|
planned_duration,
|
||||||
|
scte35_cmd,
|
||||||
|
scte35_out,
|
||||||
|
scte35_in,
|
||||||
|
end_on_next,
|
||||||
|
client_attributes,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {}
|
48
src/tags/discontinuity.rs
Normal file
48
src/tags/discontinuity.rs
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.2.3. EXT-X-DISCONTINUITY]
|
||||||
|
///
|
||||||
|
/// [4.3.2.3. EXT-X-DISCONTINUITY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.3
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXDiscontinuity;
|
||||||
|
|
||||||
|
impl ExtXDiscontinuity {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-DISCONTINUITY";
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXDiscontinuity {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
Self::PREFIX.fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXDiscontinuity {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXDiscontinuity)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_discontinuity() {
|
||||||
|
let tag = ExtXDiscontinuity;
|
||||||
|
assert_eq!("#EXT-X-DISCONTINUITY".parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), "#EXT-X-DISCONTINUITY");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
63
src/tags/discontinuity_sequence.rs
Normal file
63
src/tags/discontinuity_sequence.rs
Normal file
|
@ -0,0 +1,63 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.3.3. EXT-X-DISCONTINUITY-SEQUENCE]
|
||||||
|
///
|
||||||
|
/// [4.3.3.3. EXT-X-DISCONTINUITY-SEQUENCE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.3
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXDiscontinuitySequence(u64);
|
||||||
|
|
||||||
|
impl ExtXDiscontinuitySequence {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-DISCONTINUITY-SEQUENCE:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXDiscontinuitySequence` tag.
|
||||||
|
pub fn new(seq_num: u64) -> Self {
|
||||||
|
Self(seq_num)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the discontinuity sequence number of
|
||||||
|
/// the first media segment that appears in the associated playlist.
|
||||||
|
pub const fn seq_num(&self) -> u64 {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXDiscontinuitySequence {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXDiscontinuitySequence {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let seq_num = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
||||||
|
Ok(Self(seq_num))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_discontinuity_sequence() {
|
||||||
|
let tag = ExtXDiscontinuitySequence::new(123);
|
||||||
|
let text = "#EXT-X-DISCONTINUITY-SEQUENCE:123";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
47
src/tags/end_list.rs
Normal file
47
src/tags/end_list.rs
Normal file
|
@ -0,0 +1,47 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.3.4. EXT-X-ENDLIST]
|
||||||
|
///
|
||||||
|
/// [4.3.3.4. EXT-X-ENDLIST]: https://tools.ietf.org/html/rfc8216#section-4.3.3.4
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXEndList;
|
||||||
|
impl ExtXEndList {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-ENDLIST";
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXEndList {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
Self::PREFIX.fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXEndList {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXEndList)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_endlist() {
|
||||||
|
let tag = ExtXEndList;
|
||||||
|
let text = "#EXT-X-ENDLIST";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
179
src/tags/iframe_stream_inf.rs
Normal file
179
src/tags/iframe_stream_inf.rs
Normal file
|
@ -0,0 +1,179 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{DecimalResolution, HdcpLevel, ProtocolVersion};
|
||||||
|
use crate::utils::parse_u64;
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
|
||||||
|
/// [4.3.4.3. EXT-X-I-FRAME-STREAM-INF]
|
||||||
|
///
|
||||||
|
/// [4.3.4.3. EXT-X-I-FRAME-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.3
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXIFrameStreamInf {
|
||||||
|
uri: String,
|
||||||
|
bandwidth: u64,
|
||||||
|
average_bandwidth: Option<u64>,
|
||||||
|
codecs: Option<String>,
|
||||||
|
resolution: Option<DecimalResolution>,
|
||||||
|
hdcp_level: Option<HdcpLevel>,
|
||||||
|
video: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXIFrameStreamInf {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-I-FRAME-STREAM-INF:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXIFrameStreamInf` tag.
|
||||||
|
pub fn new<T: ToString>(uri: T, bandwidth: u64) -> Self {
|
||||||
|
ExtXIFrameStreamInf {
|
||||||
|
uri: uri.to_string(),
|
||||||
|
bandwidth,
|
||||||
|
average_bandwidth: None,
|
||||||
|
codecs: None,
|
||||||
|
resolution: None,
|
||||||
|
hdcp_level: None,
|
||||||
|
video: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the URI that identifies the associated media playlist.
|
||||||
|
pub fn uri(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.uri)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the peak segment bit rate of the variant stream.
|
||||||
|
pub fn bandwidth(&self) -> u64 {
|
||||||
|
self.bandwidth
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the average segment bit rate of the variant stream.
|
||||||
|
pub fn average_bandwidth(&self) -> Option<u64> {
|
||||||
|
self.average_bandwidth
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a string that represents the list of codec types contained the variant stream.
|
||||||
|
pub fn codecs(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.codecs {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the optimal pixel resolution at which to display all the video in the variant stream.
|
||||||
|
pub fn resolution(&self) -> Option<(usize, usize)> {
|
||||||
|
match self.resolution {
|
||||||
|
Some(value) => Some((value.width(), value.height())),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the HDCP level of the variant stream.
|
||||||
|
pub fn hdcp_level(&self) -> Option<HdcpLevel> {
|
||||||
|
self.hdcp_level
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the group identifier for the video in the variant stream.
|
||||||
|
pub fn video(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.video {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXIFrameStreamInf {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
write!(f, "URI={}", quote(&self.uri))?;
|
||||||
|
write!(f, ",BANDWIDTH={}", self.bandwidth)?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.average_bandwidth {
|
||||||
|
write!(f, ",AVERAGE-BANDWIDTH={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.codecs {
|
||||||
|
write!(f, ",CODECS={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.resolution {
|
||||||
|
write!(f, ",RESOLUTION={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.hdcp_level {
|
||||||
|
write!(f, ",HDCP-LEVEL={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.video {
|
||||||
|
write!(f, ",VIDEO={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXIFrameStreamInf {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut uri = None;
|
||||||
|
let mut bandwidth = None;
|
||||||
|
let mut average_bandwidth = None;
|
||||||
|
let mut codecs = None;
|
||||||
|
let mut resolution = None;
|
||||||
|
let mut hdcp_level = None;
|
||||||
|
let mut video = None;
|
||||||
|
|
||||||
|
let attrs = (s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>()?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"URI" => uri = Some(unquote(value)),
|
||||||
|
"BANDWIDTH" => bandwidth = Some(track!(parse_u64(value))?),
|
||||||
|
"AVERAGE-BANDWIDTH" => average_bandwidth = Some(track!(parse_u64(value))?),
|
||||||
|
"CODECS" => codecs = Some(unquote(value)),
|
||||||
|
"RESOLUTION" => resolution = Some(track!(value.parse())?),
|
||||||
|
"HDCP-LEVEL" => hdcp_level = Some(track!(value.parse())?),
|
||||||
|
"VIDEO" => video = Some(unquote(value)),
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
||||||
|
let bandwidth = track_assert_some!(bandwidth, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXIFrameStreamInf {
|
||||||
|
uri,
|
||||||
|
bandwidth,
|
||||||
|
average_bandwidth,
|
||||||
|
codecs,
|
||||||
|
resolution,
|
||||||
|
hdcp_level,
|
||||||
|
video,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_i_frame_stream_inf() {
|
||||||
|
let tag = ExtXIFrameStreamInf::new("foo".to_string(), 1000);
|
||||||
|
let text = r#"#EXT-X-I-FRAME-STREAM-INF:URI="foo",BANDWIDTH=1000"#;
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
49
src/tags/iframes_only.rs
Normal file
49
src/tags/iframes_only.rs
Normal file
|
@ -0,0 +1,49 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.3.6. EXT-X-I-FRAMES-ONLY]
|
||||||
|
///
|
||||||
|
/// [4.3.3.6. EXT-X-I-FRAMES-ONLY]: https://tools.ietf.org/html/rfc8216#section-4.3.3.6
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXIFramesOnly;
|
||||||
|
|
||||||
|
impl ExtXIFramesOnly {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-I-FRAMES-ONLY";
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V4
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXIFramesOnly {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
Self::PREFIX.fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXIFramesOnly {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXIFramesOnly)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_i_frames_only() {
|
||||||
|
let tag = ExtXIFramesOnly;
|
||||||
|
let text = "#EXT-X-I-FRAMES-ONLY";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V4);
|
||||||
|
}
|
||||||
|
}
|
48
src/tags/independent_segments.rs
Normal file
48
src/tags/independent_segments.rs
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.5.1. EXT-X-INDEPENDENT-SEGMENTS]
|
||||||
|
///
|
||||||
|
/// [4.3.5.1. EXT-X-INDEPENDENT-SEGMENTS]: https://tools.ietf.org/html/rfc8216#section-4.3.5.1
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXIndependentSegments;
|
||||||
|
|
||||||
|
impl ExtXIndependentSegments {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-INDEPENDENT-SEGMENTS";
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXIndependentSegments {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
impl FromStr for ExtXIndependentSegments {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXIndependentSegments)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_independent_segments() {
|
||||||
|
let tag = ExtXIndependentSegments;
|
||||||
|
let text = "#EXT-X-INDEPENDENT-SEGMENTS";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
121
src/tags/inf.rs
Normal file
121
src/tags/inf.rs
Normal file
|
@ -0,0 +1,121 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::types::{DecimalFloatingPoint, ProtocolVersion};
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.2.1. EXTINF]
|
||||||
|
///
|
||||||
|
/// [4.3.2.1. EXTINF]: https://tools.ietf.org/html/rfc8216#section-4.3.2.1
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtInf {
|
||||||
|
duration: Duration,
|
||||||
|
title: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtInf {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXTINF:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtInf` tag.
|
||||||
|
pub fn new(duration: Duration) -> Self {
|
||||||
|
ExtInf {
|
||||||
|
duration,
|
||||||
|
title: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Makes a new `ExtInf` tag with the given title.
|
||||||
|
pub fn with_title<T: ToString>(duration: Duration, title: T) -> Self {
|
||||||
|
ExtInf {
|
||||||
|
duration,
|
||||||
|
title: Some(title.to_string()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the duration of the associated media segment.
|
||||||
|
pub fn duration(&self) -> Duration {
|
||||||
|
self.duration
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the title of the associated media segment.
|
||||||
|
pub fn title(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.title {
|
||||||
|
Some(value) => Some(Cow::Borrowed(value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
if self.duration.subsec_nanos() == 0 {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
} else {
|
||||||
|
ProtocolVersion::V3
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtInf {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
|
||||||
|
let duration = (self.duration.as_secs() as f64)
|
||||||
|
+ (f64::from(self.duration.subsec_nanos()) / 1_000_000_000.0);
|
||||||
|
write!(f, "{}", duration)?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.title {
|
||||||
|
write!(f, ",{}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtInf {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let mut tokens = s.split_at(Self::PREFIX.len()).1.splitn(2, ',');
|
||||||
|
|
||||||
|
let seconds: DecimalFloatingPoint =
|
||||||
|
may_invalid!(tokens.next().expect("Never fails").parse())?;
|
||||||
|
let duration = seconds.to_duration();
|
||||||
|
|
||||||
|
let title = if let Some(title) = tokens.next() {
|
||||||
|
Some(title.to_string())
|
||||||
|
} else {
|
||||||
|
None
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(ExtInf { duration, title })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn extinf() {
|
||||||
|
let tag = ExtInf::new(Duration::from_secs(5));
|
||||||
|
assert_eq!("#EXTINF:5".parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), "#EXTINF:5");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtInf::with_title(Duration::from_secs(5), "foo");
|
||||||
|
assert_eq!("#EXTINF:5,foo".parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), "#EXTINF:5,foo");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtInf::new(Duration::from_millis(1234));
|
||||||
|
assert_eq!("#EXTINF:1.234".parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), "#EXTINF:1.234");
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V3);
|
||||||
|
}
|
||||||
|
}
|
136
src/tags/key.rs
Normal file
136
src/tags/key.rs
Normal file
|
@ -0,0 +1,136 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{DecryptionKey, ProtocolVersion};
|
||||||
|
|
||||||
|
/// [4.3.2.4. EXT-X-KEY]
|
||||||
|
///
|
||||||
|
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXKey {
|
||||||
|
key: Option<DecryptionKey>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXKey {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-KEY:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXKey` tag.
|
||||||
|
pub fn new(key: DecryptionKey) -> Self {
|
||||||
|
ExtXKey { key: Some(key) }
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Makes a new `ExtXKey` tag without a decryption key.
|
||||||
|
///
|
||||||
|
/// This tag has the `METHDO=NONE` attribute.
|
||||||
|
pub fn new_without_key() -> Self {
|
||||||
|
ExtXKey { key: None }
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the decryption key for the following media segments and media initialization sections.
|
||||||
|
pub fn key(&self) -> Option<&DecryptionKey> {
|
||||||
|
self.key.as_ref()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
self.key
|
||||||
|
.as_ref()
|
||||||
|
.map_or(ProtocolVersion::V1, |k| k.required_version())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXKey {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
if let Some(ref key) = self.key {
|
||||||
|
write!(f, "{}", key)?;
|
||||||
|
} else {
|
||||||
|
write!(f, "METHOD=NONE")?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXKey {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let suffix = s.split_at(Self::PREFIX.len()).1;
|
||||||
|
let attrs = suffix.parse::<AttributePairs>()?;
|
||||||
|
|
||||||
|
if attrs.iter().any(|(k, v)| k == "METHOD" && v == "NONE") {
|
||||||
|
for (key, _) in attrs {
|
||||||
|
track_assert_ne!(key, "URI", ErrorKind::InvalidInput);
|
||||||
|
track_assert_ne!(key, "IV", ErrorKind::InvalidInput);
|
||||||
|
track_assert_ne!(key, "KEYFORMAT", ErrorKind::InvalidInput);
|
||||||
|
track_assert_ne!(key, "KEYFORMATVERSIONS", ErrorKind::InvalidInput);
|
||||||
|
}
|
||||||
|
Ok(ExtXKey { key: None })
|
||||||
|
} else {
|
||||||
|
let key = track!(suffix.parse())?;
|
||||||
|
Ok(ExtXKey { key: Some(key) })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
use crate::types::{EncryptionMethod, InitializationVector};
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_key() {
|
||||||
|
let tag = ExtXKey::new_without_key();
|
||||||
|
let text = "#EXT-X-KEY:METHOD=NONE";
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtXKey::new(DecryptionKey {
|
||||||
|
method: EncryptionMethod::Aes128,
|
||||||
|
uri: "foo".to_string(),
|
||||||
|
iv: None,
|
||||||
|
key_format: None,
|
||||||
|
key_format_versions: None,
|
||||||
|
});
|
||||||
|
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtXKey::new(DecryptionKey {
|
||||||
|
method: EncryptionMethod::Aes128,
|
||||||
|
uri: "foo".to_string(),
|
||||||
|
iv: Some(InitializationVector([
|
||||||
|
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
||||||
|
])),
|
||||||
|
key_format: None,
|
||||||
|
key_format_versions: None,
|
||||||
|
});
|
||||||
|
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f"#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V2);
|
||||||
|
|
||||||
|
let tag = ExtXKey::new(DecryptionKey {
|
||||||
|
method: EncryptionMethod::Aes128,
|
||||||
|
uri: "foo".to_string(),
|
||||||
|
iv: Some(InitializationVector([
|
||||||
|
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
||||||
|
])),
|
||||||
|
key_format: Some("baz".to_string()),
|
||||||
|
key_format_versions: None,
|
||||||
|
});
|
||||||
|
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f,KEYFORMAT="baz""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V5);
|
||||||
|
}
|
||||||
|
}
|
60
src/tags/m3u.rs
Normal file
60
src/tags/m3u.rs
Normal file
|
@ -0,0 +1,60 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.1.1. EXTM3U]
|
||||||
|
///
|
||||||
|
/// [4.3.1.1. EXTM3U]: https://tools.ietf.org/html/rfc8216#section-4.3.1.1
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtM3u;
|
||||||
|
|
||||||
|
impl ExtM3u {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXTM3U";
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtM3u {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtM3u {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtM3u)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser() {
|
||||||
|
assert_eq!("#EXTM3U".parse::<ExtM3u>().ok(), Some(ExtM3u));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser_err() {
|
||||||
|
assert!("#EEXTM3U".parse::<ExtM3u>().is_err());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_display() {
|
||||||
|
assert_eq!(ExtM3u.to_string(), "#EXTM3U");
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_required_vesion() {
|
||||||
|
assert_eq!(ExtM3u.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
115
src/tags/map.rs
Normal file
115
src/tags/map.rs
Normal file
|
@ -0,0 +1,115 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::types::{ByteRange, ProtocolVersion};
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.2.5. EXT-X-MAP]
|
||||||
|
///
|
||||||
|
/// [4.3.2.5. EXT-X-MAP]: https://tools.ietf.org/html/rfc8216#section-4.3.2.5
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXMap {
|
||||||
|
uri: String,
|
||||||
|
range: Option<ByteRange>,
|
||||||
|
}
|
||||||
|
impl ExtXMap {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-MAP:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXMap` tag.
|
||||||
|
pub fn new<T: ToString>(uri: T) -> Self {
|
||||||
|
ExtXMap {
|
||||||
|
uri: unquote(uri),
|
||||||
|
range: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Makes a new `ExtXMap` tag with the given range.
|
||||||
|
pub fn with_range<T: ToString>(uri: T, range: ByteRange) -> Self {
|
||||||
|
ExtXMap {
|
||||||
|
uri: unquote(uri.to_string()),
|
||||||
|
range: Some(range),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the URI that identifies a resource that contains the media initialization section.
|
||||||
|
pub fn uri(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.uri)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the range of the media initialization section.
|
||||||
|
pub fn range(&self) -> Option<ByteRange> {
|
||||||
|
self.range
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V6
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXMap {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
write!(f, "URI={}", quote(&self.uri))?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.range {
|
||||||
|
write!(f, ",BYTERANGE=\"{}\"", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXMap {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut uri = None;
|
||||||
|
let mut range = None;
|
||||||
|
let attrs = track!((s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>())?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"URI" => uri = Some(unquote(value)),
|
||||||
|
"BYTERANGE" => {
|
||||||
|
range = Some(track!(unquote(value).parse())?);
|
||||||
|
}
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXMap { uri, range })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_map() {
|
||||||
|
let tag = ExtXMap::new("foo".to_string());
|
||||||
|
let text = r#"#EXT-X-MAP:URI="foo""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V6);
|
||||||
|
|
||||||
|
let tag = ExtXMap::with_range("foo".to_string(), ByteRange::new(9, Some(2)));
|
||||||
|
|
||||||
|
let text = r#"#EXT-X-MAP:URI="foo",BYTERANGE="9@2""#;
|
||||||
|
track_try_unwrap!(ExtXMap::from_str(text));
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V6);
|
||||||
|
}
|
||||||
|
}
|
|
@ -1,918 +0,0 @@
|
||||||
use super::{parse_u64, parse_yes_or_no};
|
|
||||||
use crate::attribute::AttributePairs;
|
|
||||||
use crate::types::{
|
|
||||||
ClosedCaptions, DecimalFloatingPoint, DecimalResolution, DecryptionKey, HdcpLevel, InStreamId,
|
|
||||||
MediaType, ProtocolVersion, QuotedString, SessionData, SingleLineString,
|
|
||||||
};
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
|
||||||
use std::str::FromStr;
|
|
||||||
|
|
||||||
/// `ExtXMedia` builder.
|
|
||||||
#[derive(Debug, Clone)]
|
|
||||||
pub struct ExtXMediaBuilder {
|
|
||||||
media_type: Option<MediaType>,
|
|
||||||
uri: Option<QuotedString>,
|
|
||||||
group_id: Option<QuotedString>,
|
|
||||||
language: Option<QuotedString>,
|
|
||||||
assoc_language: Option<QuotedString>,
|
|
||||||
name: Option<QuotedString>,
|
|
||||||
default: bool,
|
|
||||||
autoselect: Option<bool>,
|
|
||||||
forced: Option<bool>,
|
|
||||||
instream_id: Option<InStreamId>,
|
|
||||||
characteristics: Option<QuotedString>,
|
|
||||||
channels: Option<QuotedString>,
|
|
||||||
}
|
|
||||||
impl ExtXMediaBuilder {
|
|
||||||
/// Makes a `ExtXMediaBuilder` instance.
|
|
||||||
pub fn new() -> Self {
|
|
||||||
ExtXMediaBuilder {
|
|
||||||
media_type: None,
|
|
||||||
uri: None,
|
|
||||||
group_id: None,
|
|
||||||
language: None,
|
|
||||||
assoc_language: None,
|
|
||||||
name: None,
|
|
||||||
default: false,
|
|
||||||
autoselect: None,
|
|
||||||
forced: None,
|
|
||||||
instream_id: None,
|
|
||||||
characteristics: None,
|
|
||||||
channels: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the media type of the rendition.
|
|
||||||
pub fn media_type(&mut self, media_type: MediaType) -> &mut Self {
|
|
||||||
self.media_type = Some(media_type);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the identifier that specifies the group to which the rendition belongs.
|
|
||||||
pub fn group_id(&mut self, group_id: QuotedString) -> &mut Self {
|
|
||||||
self.group_id = Some(group_id);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets a human-readable description of the rendition.
|
|
||||||
pub fn name(&mut self, name: QuotedString) -> &mut Self {
|
|
||||||
self.name = Some(name);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the URI that identifies the media playlist.
|
|
||||||
pub fn uri(&mut self, uri: QuotedString) -> &mut Self {
|
|
||||||
self.uri = Some(uri);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the name of the primary language used in the rendition.
|
|
||||||
pub fn language(&mut self, language: QuotedString) -> &mut Self {
|
|
||||||
self.language = Some(language);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the name of a language associated with the rendition.
|
|
||||||
pub fn assoc_language(&mut self, language: QuotedString) -> &mut Self {
|
|
||||||
self.assoc_language = Some(language);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the value of the `default` flag.
|
|
||||||
pub fn default(&mut self, b: bool) -> &mut Self {
|
|
||||||
self.default = b;
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the value of the `autoselect` flag.
|
|
||||||
pub fn autoselect(&mut self, b: bool) -> &mut Self {
|
|
||||||
self.autoselect = Some(b);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the value of the `forced` flag.
|
|
||||||
pub fn forced(&mut self, b: bool) -> &mut Self {
|
|
||||||
self.forced = Some(b);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the identifier that specifies a rendition within the segments in the media playlist.
|
|
||||||
pub fn instream_id(&mut self, id: InStreamId) -> &mut Self {
|
|
||||||
self.instream_id = Some(id);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the string that represents uniform type identifiers (UTI).
|
|
||||||
pub fn characteristics(&mut self, characteristics: QuotedString) -> &mut Self {
|
|
||||||
self.characteristics = Some(characteristics);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Sets the string that represents the parameters of the rendition.
|
|
||||||
pub fn channels(&mut self, channels: QuotedString) -> &mut Self {
|
|
||||||
self.channels = Some(channels);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Builds a `ExtXMedia` instance.
|
|
||||||
pub fn finish(self) -> Result<ExtXMedia> {
|
|
||||||
let media_type = track_assert_some!(self.media_type, ErrorKind::InvalidInput);
|
|
||||||
let group_id = track_assert_some!(self.group_id, ErrorKind::InvalidInput);
|
|
||||||
let name = track_assert_some!(self.name, ErrorKind::InvalidInput);
|
|
||||||
if MediaType::ClosedCaptions == media_type {
|
|
||||||
track_assert_ne!(self.uri, None, ErrorKind::InvalidInput);
|
|
||||||
track_assert!(self.instream_id.is_some(), ErrorKind::InvalidInput);
|
|
||||||
} else {
|
|
||||||
track_assert!(self.instream_id.is_none(), ErrorKind::InvalidInput);
|
|
||||||
}
|
|
||||||
if self.default && self.autoselect.is_some() {
|
|
||||||
track_assert_eq!(self.autoselect, Some(true), ErrorKind::InvalidInput);
|
|
||||||
}
|
|
||||||
if MediaType::Subtitles != media_type {
|
|
||||||
track_assert_eq!(self.forced, None, ErrorKind::InvalidInput);
|
|
||||||
}
|
|
||||||
Ok(ExtXMedia {
|
|
||||||
media_type,
|
|
||||||
uri: self.uri,
|
|
||||||
group_id,
|
|
||||||
language: self.language,
|
|
||||||
assoc_language: self.assoc_language,
|
|
||||||
name,
|
|
||||||
default: self.default,
|
|
||||||
autoselect: self.autoselect.unwrap_or(false),
|
|
||||||
forced: self.forced.unwrap_or(false),
|
|
||||||
instream_id: self.instream_id,
|
|
||||||
characteristics: self.characteristics,
|
|
||||||
channels: self.channels,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Default for ExtXMediaBuilder {
|
|
||||||
fn default() -> Self {
|
|
||||||
Self::new()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.4.1. EXT-X-MEDIA]
|
|
||||||
///
|
|
||||||
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXMedia {
|
|
||||||
media_type: MediaType,
|
|
||||||
uri: Option<QuotedString>,
|
|
||||||
group_id: QuotedString,
|
|
||||||
language: Option<QuotedString>,
|
|
||||||
assoc_language: Option<QuotedString>,
|
|
||||||
name: QuotedString,
|
|
||||||
default: bool,
|
|
||||||
autoselect: bool,
|
|
||||||
forced: bool,
|
|
||||||
instream_id: Option<InStreamId>,
|
|
||||||
characteristics: Option<QuotedString>,
|
|
||||||
channels: Option<QuotedString>,
|
|
||||||
}
|
|
||||||
impl ExtXMedia {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-MEDIA:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXMedia` tag.
|
|
||||||
pub fn new(media_type: MediaType, group_id: QuotedString, name: QuotedString) -> Self {
|
|
||||||
ExtXMedia {
|
|
||||||
media_type,
|
|
||||||
uri: None,
|
|
||||||
group_id,
|
|
||||||
language: None,
|
|
||||||
assoc_language: None,
|
|
||||||
name,
|
|
||||||
default: false,
|
|
||||||
autoselect: false,
|
|
||||||
forced: false,
|
|
||||||
instream_id: None,
|
|
||||||
characteristics: None,
|
|
||||||
channels: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the type of the media associated with this tag.
|
|
||||||
pub fn media_type(&self) -> MediaType {
|
|
||||||
self.media_type
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the identifier that specifies the group to which the rendition belongs.
|
|
||||||
pub fn group_id(&self) -> &QuotedString {
|
|
||||||
&self.group_id
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a human-readable description of the rendition.
|
|
||||||
pub fn name(&self) -> &QuotedString {
|
|
||||||
&self.name
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the URI that identifies the media playlist.
|
|
||||||
pub fn uri(&self) -> Option<&QuotedString> {
|
|
||||||
self.uri.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the name of the primary language used in the rendition.
|
|
||||||
pub fn language(&self) -> Option<&QuotedString> {
|
|
||||||
self.language.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the name of a language associated with the rendition.
|
|
||||||
pub fn assoc_language(&self) -> Option<&QuotedString> {
|
|
||||||
self.assoc_language.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns whether this is the default rendition.
|
|
||||||
pub fn default(&self) -> bool {
|
|
||||||
self.default
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns whether the client may choose to
|
|
||||||
/// play this rendition in the absence of explicit user preference.
|
|
||||||
pub fn autoselect(&self) -> bool {
|
|
||||||
self.autoselect
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns whether the rendition contains content that is considered essential to play.
|
|
||||||
pub fn forced(&self) -> bool {
|
|
||||||
self.forced
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the identifier that specifies a rendition within the segments in the media playlist.
|
|
||||||
pub fn instream_id(&self) -> Option<InStreamId> {
|
|
||||||
self.instream_id
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a string that represents uniform type identifiers (UTI).
|
|
||||||
///
|
|
||||||
/// Each UTI indicates an individual characteristic of the rendition.
|
|
||||||
pub fn characteristics(&self) -> Option<&QuotedString> {
|
|
||||||
self.characteristics.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a string that represents the parameters of the rendition.
|
|
||||||
pub fn channels(&self) -> Option<&QuotedString> {
|
|
||||||
self.channels.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
match self.instream_id {
|
|
||||||
None
|
|
||||||
| Some(InStreamId::Cc1)
|
|
||||||
| Some(InStreamId::Cc2)
|
|
||||||
| Some(InStreamId::Cc3)
|
|
||||||
| Some(InStreamId::Cc4) => ProtocolVersion::V1,
|
|
||||||
_ => ProtocolVersion::V7,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXMedia {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "TYPE={}", self.media_type)?;
|
|
||||||
if let Some(ref x) = self.uri {
|
|
||||||
write!(f, ",URI={}", x)?;
|
|
||||||
}
|
|
||||||
write!(f, ",GROUP-ID={}", self.group_id)?;
|
|
||||||
if let Some(ref x) = self.language {
|
|
||||||
write!(f, ",LANGUAGE={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.assoc_language {
|
|
||||||
write!(f, ",ASSOC-LANGUAGE={}", x)?;
|
|
||||||
}
|
|
||||||
write!(f, ",NAME={}", self.name)?;
|
|
||||||
if self.default {
|
|
||||||
write!(f, ",DEFAULT=YES")?;
|
|
||||||
}
|
|
||||||
if self.autoselect {
|
|
||||||
write!(f, ",AUTOSELECT=YES")?;
|
|
||||||
}
|
|
||||||
if self.forced {
|
|
||||||
write!(f, ",FORCED=YES")?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.instream_id {
|
|
||||||
write!(f, ",INSTREAM-ID=\"{}\"", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.characteristics {
|
|
||||||
write!(f, ",CHARACTERISTICS={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.channels {
|
|
||||||
write!(f, ",CHANNELS={}", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXMedia {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut builder = ExtXMediaBuilder::new();
|
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"TYPE" => {
|
|
||||||
builder.media_type(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"URI" => {
|
|
||||||
builder.uri(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"GROUP-ID" => {
|
|
||||||
builder.group_id(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"LANGUAGE" => {
|
|
||||||
builder.language(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"ASSOC-LANGUAGE" => {
|
|
||||||
builder.assoc_language(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"NAME" => {
|
|
||||||
builder.name(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"DEFAULT" => {
|
|
||||||
builder.default(track!(parse_yes_or_no(value))?);
|
|
||||||
}
|
|
||||||
"AUTOSELECT" => {
|
|
||||||
builder.autoselect(track!(parse_yes_or_no(value))?);
|
|
||||||
}
|
|
||||||
"FORCED" => {
|
|
||||||
builder.forced(track!(parse_yes_or_no(value))?);
|
|
||||||
}
|
|
||||||
"INSTREAM-ID" => {
|
|
||||||
let s: QuotedString = track!(value.parse())?;
|
|
||||||
builder.instream_id(track!(s.parse())?);
|
|
||||||
}
|
|
||||||
"CHARACTERISTICS" => {
|
|
||||||
builder.characteristics(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
"CHANNELS" => {
|
|
||||||
builder.channels(track!(value.parse())?);
|
|
||||||
}
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
track!(builder.finish())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.4.2. EXT-X-STREAM-INF]
|
|
||||||
///
|
|
||||||
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
||||||
pub struct ExtXStreamInf {
|
|
||||||
uri: SingleLineString,
|
|
||||||
bandwidth: u64,
|
|
||||||
average_bandwidth: Option<u64>,
|
|
||||||
codecs: Option<QuotedString>,
|
|
||||||
resolution: Option<DecimalResolution>,
|
|
||||||
frame_rate: Option<DecimalFloatingPoint>,
|
|
||||||
hdcp_level: Option<HdcpLevel>,
|
|
||||||
audio: Option<QuotedString>,
|
|
||||||
video: Option<QuotedString>,
|
|
||||||
subtitles: Option<QuotedString>,
|
|
||||||
closed_captions: Option<ClosedCaptions>,
|
|
||||||
}
|
|
||||||
impl ExtXStreamInf {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-STREAM-INF:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXStreamInf` tag.
|
|
||||||
pub fn new(uri: SingleLineString, bandwidth: u64) -> Self {
|
|
||||||
ExtXStreamInf {
|
|
||||||
uri,
|
|
||||||
bandwidth,
|
|
||||||
average_bandwidth: None,
|
|
||||||
codecs: None,
|
|
||||||
resolution: None,
|
|
||||||
frame_rate: None,
|
|
||||||
hdcp_level: None,
|
|
||||||
audio: None,
|
|
||||||
video: None,
|
|
||||||
subtitles: None,
|
|
||||||
closed_captions: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the URI that identifies the associated media playlist.
|
|
||||||
pub fn uri(&self) -> &SingleLineString {
|
|
||||||
&self.uri
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the peak segment bit rate of the variant stream.
|
|
||||||
pub fn bandwidth(&self) -> u64 {
|
|
||||||
self.bandwidth
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the average segment bit rate of the variant stream.
|
|
||||||
pub fn average_bandwidth(&self) -> Option<u64> {
|
|
||||||
self.average_bandwidth
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a string that represents the list of codec types contained the variant stream.
|
|
||||||
pub fn codecs(&self) -> Option<&QuotedString> {
|
|
||||||
self.codecs.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the optimal pixel resolution at which to display all the video in the variant stream.
|
|
||||||
pub fn resolution(&self) -> Option<DecimalResolution> {
|
|
||||||
self.resolution
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the maximum frame rate for all the video in the variant stream.
|
|
||||||
pub fn frame_rate(&self) -> Option<DecimalFloatingPoint> {
|
|
||||||
self.frame_rate
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the HDCP level of the variant stream.
|
|
||||||
pub fn hdcp_level(&self) -> Option<HdcpLevel> {
|
|
||||||
self.hdcp_level
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the group identifier for the audio in the variant stream.
|
|
||||||
pub fn audio(&self) -> Option<&QuotedString> {
|
|
||||||
self.audio.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the group identifier for the video in the variant stream.
|
|
||||||
pub fn video(&self) -> Option<&QuotedString> {
|
|
||||||
self.video.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the group identifier for the subtitles in the variant stream.
|
|
||||||
pub fn subtitles(&self) -> Option<&QuotedString> {
|
|
||||||
self.subtitles.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the value of `CLOSED-CAPTIONS` attribute.
|
|
||||||
pub fn closed_captions(&self) -> Option<&ClosedCaptions> {
|
|
||||||
self.closed_captions.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXStreamInf {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "BANDWIDTH={}", self.bandwidth)?;
|
|
||||||
if let Some(ref x) = self.average_bandwidth {
|
|
||||||
write!(f, ",AVERAGE-BANDWIDTH={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.codecs {
|
|
||||||
write!(f, ",CODECS={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.resolution {
|
|
||||||
write!(f, ",RESOLUTION={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.frame_rate {
|
|
||||||
write!(f, ",FRAME-RATE={:.3}", x.as_f64())?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.hdcp_level {
|
|
||||||
write!(f, ",HDCP-LEVEL={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.audio {
|
|
||||||
write!(f, ",AUDIO={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.video {
|
|
||||||
write!(f, ",VIDEO={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.subtitles {
|
|
||||||
write!(f, ",SUBTITLES={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.closed_captions {
|
|
||||||
write!(f, ",CLOSED-CAPTIONS={}", x)?;
|
|
||||||
}
|
|
||||||
write!(f, "\n{}", self.uri)?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXStreamInf {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
let mut lines = s.splitn(2, '\n');
|
|
||||||
let first_line = lines.next().expect("Never fails").trim_end_matches('\r');
|
|
||||||
let second_line = track_assert_some!(lines.next(), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
track_assert!(
|
|
||||||
first_line.starts_with(Self::PREFIX),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
let uri = track!(SingleLineString::new(second_line))?;
|
|
||||||
let mut bandwidth = None;
|
|
||||||
let mut average_bandwidth = None;
|
|
||||||
let mut codecs = None;
|
|
||||||
let mut resolution = None;
|
|
||||||
let mut frame_rate = None;
|
|
||||||
let mut hdcp_level = None;
|
|
||||||
let mut audio = None;
|
|
||||||
let mut video = None;
|
|
||||||
let mut subtitles = None;
|
|
||||||
let mut closed_captions = None;
|
|
||||||
let attrs = AttributePairs::parse(first_line.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"BANDWIDTH" => bandwidth = Some(track!(parse_u64(value))?),
|
|
||||||
"AVERAGE-BANDWIDTH" => average_bandwidth = Some(track!(parse_u64(value))?),
|
|
||||||
"CODECS" => codecs = Some(track!(value.parse())?),
|
|
||||||
"RESOLUTION" => resolution = Some(track!(value.parse())?),
|
|
||||||
"FRAME-RATE" => frame_rate = Some(track!(value.parse())?),
|
|
||||||
"HDCP-LEVEL" => hdcp_level = Some(track!(value.parse())?),
|
|
||||||
"AUDIO" => audio = Some(track!(value.parse())?),
|
|
||||||
"VIDEO" => video = Some(track!(value.parse())?),
|
|
||||||
"SUBTITLES" => subtitles = Some(track!(value.parse())?),
|
|
||||||
"CLOSED-CAPTIONS" => closed_captions = Some(track!(value.parse())?),
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
let bandwidth = track_assert_some!(bandwidth, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXStreamInf {
|
|
||||||
uri,
|
|
||||||
bandwidth,
|
|
||||||
average_bandwidth,
|
|
||||||
codecs,
|
|
||||||
resolution,
|
|
||||||
frame_rate,
|
|
||||||
hdcp_level,
|
|
||||||
audio,
|
|
||||||
video,
|
|
||||||
subtitles,
|
|
||||||
closed_captions,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.4.3. EXT-X-I-FRAME-STREAM-INF]
|
|
||||||
///
|
|
||||||
/// [4.3.4.3. EXT-X-I-FRAME-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.3
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXIFrameStreamInf {
|
|
||||||
uri: QuotedString,
|
|
||||||
bandwidth: u64,
|
|
||||||
average_bandwidth: Option<u64>,
|
|
||||||
codecs: Option<QuotedString>,
|
|
||||||
resolution: Option<DecimalResolution>,
|
|
||||||
hdcp_level: Option<HdcpLevel>,
|
|
||||||
video: Option<QuotedString>,
|
|
||||||
}
|
|
||||||
impl ExtXIFrameStreamInf {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-I-FRAME-STREAM-INF:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXIFrameStreamInf` tag.
|
|
||||||
pub fn new(uri: QuotedString, bandwidth: u64) -> Self {
|
|
||||||
ExtXIFrameStreamInf {
|
|
||||||
uri,
|
|
||||||
bandwidth,
|
|
||||||
average_bandwidth: None,
|
|
||||||
codecs: None,
|
|
||||||
resolution: None,
|
|
||||||
hdcp_level: None,
|
|
||||||
video: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the URI that identifies the associated media playlist.
|
|
||||||
pub fn uri(&self) -> &QuotedString {
|
|
||||||
&self.uri
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the peak segment bit rate of the variant stream.
|
|
||||||
pub fn bandwidth(&self) -> u64 {
|
|
||||||
self.bandwidth
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the average segment bit rate of the variant stream.
|
|
||||||
pub fn average_bandwidth(&self) -> Option<u64> {
|
|
||||||
self.average_bandwidth
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a string that represents the list of codec types contained the variant stream.
|
|
||||||
pub fn codecs(&self) -> Option<&QuotedString> {
|
|
||||||
self.codecs.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the optimal pixel resolution at which to display all the video in the variant stream.
|
|
||||||
pub fn resolution(&self) -> Option<DecimalResolution> {
|
|
||||||
self.resolution
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the HDCP level of the variant stream.
|
|
||||||
pub fn hdcp_level(&self) -> Option<HdcpLevel> {
|
|
||||||
self.hdcp_level
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the group identifier for the video in the variant stream.
|
|
||||||
pub fn video(&self) -> Option<&QuotedString> {
|
|
||||||
self.video.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXIFrameStreamInf {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "URI={}", self.uri)?;
|
|
||||||
write!(f, ",BANDWIDTH={}", self.bandwidth)?;
|
|
||||||
if let Some(ref x) = self.average_bandwidth {
|
|
||||||
write!(f, ",AVERAGE-BANDWIDTH={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.codecs {
|
|
||||||
write!(f, ",CODECS={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.resolution {
|
|
||||||
write!(f, ",RESOLUTION={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.hdcp_level {
|
|
||||||
write!(f, ",HDCP-LEVEL={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.video {
|
|
||||||
write!(f, ",VIDEO={}", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXIFrameStreamInf {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut uri = None;
|
|
||||||
let mut bandwidth = None;
|
|
||||||
let mut average_bandwidth = None;
|
|
||||||
let mut codecs = None;
|
|
||||||
let mut resolution = None;
|
|
||||||
let mut hdcp_level = None;
|
|
||||||
let mut video = None;
|
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"URI" => uri = Some(track!(value.parse())?),
|
|
||||||
"BANDWIDTH" => bandwidth = Some(track!(parse_u64(value))?),
|
|
||||||
"AVERAGE-BANDWIDTH" => average_bandwidth = Some(track!(parse_u64(value))?),
|
|
||||||
"CODECS" => codecs = Some(track!(value.parse())?),
|
|
||||||
"RESOLUTION" => resolution = Some(track!(value.parse())?),
|
|
||||||
"HDCP-LEVEL" => hdcp_level = Some(track!(value.parse())?),
|
|
||||||
"VIDEO" => video = Some(track!(value.parse())?),
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
|
||||||
let bandwidth = track_assert_some!(bandwidth, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXIFrameStreamInf {
|
|
||||||
uri,
|
|
||||||
bandwidth,
|
|
||||||
average_bandwidth,
|
|
||||||
codecs,
|
|
||||||
resolution,
|
|
||||||
hdcp_level,
|
|
||||||
video,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.4.4. EXT-X-SESSION-DATA]
|
|
||||||
///
|
|
||||||
/// [4.3.4.4. EXT-X-SESSION-DATA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.4
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXSessionData {
|
|
||||||
data_id: QuotedString,
|
|
||||||
data: SessionData,
|
|
||||||
language: Option<QuotedString>,
|
|
||||||
}
|
|
||||||
impl ExtXSessionData {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-SESSION-DATA:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXSessionData` tag.
|
|
||||||
pub fn new(data_id: QuotedString, data: SessionData) -> Self {
|
|
||||||
ExtXSessionData {
|
|
||||||
data_id,
|
|
||||||
data,
|
|
||||||
language: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Makes a new `ExtXSessionData` with the given language.
|
|
||||||
pub fn with_language(data_id: QuotedString, data: SessionData, language: QuotedString) -> Self {
|
|
||||||
ExtXSessionData {
|
|
||||||
data_id,
|
|
||||||
data,
|
|
||||||
language: Some(language),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the identifier of the data.
|
|
||||||
pub fn data_id(&self) -> &QuotedString {
|
|
||||||
&self.data_id
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the session data.
|
|
||||||
pub fn data(&self) -> &SessionData {
|
|
||||||
&self.data
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the language of the data.
|
|
||||||
pub fn language(&self) -> Option<&QuotedString> {
|
|
||||||
self.language.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXSessionData {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "DATA-ID={}", self.data_id)?;
|
|
||||||
match self.data {
|
|
||||||
SessionData::Value(ref x) => write!(f, ",VALUE={}", x)?,
|
|
||||||
SessionData::Uri(ref x) => write!(f, ",URI={}", x)?,
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.language {
|
|
||||||
write!(f, ",LANGUAGE={}", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXSessionData {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut data_id = None;
|
|
||||||
let mut session_value = None;
|
|
||||||
let mut uri = None;
|
|
||||||
let mut language = None;
|
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"DATA-ID" => data_id = Some(track!(value.parse())?),
|
|
||||||
"VALUE" => session_value = Some(track!(value.parse())?),
|
|
||||||
"URI" => uri = Some(track!(value.parse())?),
|
|
||||||
"LANGUAGE" => language = Some(track!(value.parse())?),
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
let data_id = track_assert_some!(data_id, ErrorKind::InvalidInput);
|
|
||||||
let data = if let Some(value) = session_value {
|
|
||||||
track_assert_eq!(uri, None, ErrorKind::InvalidInput);
|
|
||||||
SessionData::Value(value)
|
|
||||||
} else if let Some(uri) = uri {
|
|
||||||
SessionData::Uri(uri)
|
|
||||||
} else {
|
|
||||||
track_panic!(ErrorKind::InvalidInput);
|
|
||||||
};
|
|
||||||
Ok(ExtXSessionData {
|
|
||||||
data_id,
|
|
||||||
data,
|
|
||||||
language,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.4.5. EXT-X-SESSION-KEY]
|
|
||||||
///
|
|
||||||
/// [4.3.4.5. EXT-X-SESSION-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.4.5
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXSessionKey {
|
|
||||||
key: DecryptionKey,
|
|
||||||
}
|
|
||||||
impl ExtXSessionKey {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-SESSION-KEY:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXSessionKey` tag.
|
|
||||||
pub fn new(key: DecryptionKey) -> Self {
|
|
||||||
ExtXSessionKey { key }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns a decryption key for the playlist.
|
|
||||||
pub fn key(&self) -> &DecryptionKey {
|
|
||||||
&self.key
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
self.key.requires_version()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXSessionKey {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.key)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXSessionKey {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let suffix = s.split_at(Self::PREFIX.len()).1;
|
|
||||||
let key = track!(suffix.parse())?;
|
|
||||||
Ok(ExtXSessionKey { key })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod test {
|
|
||||||
use super::*;
|
|
||||||
use crate::types::{EncryptionMethod, InitializationVector};
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_media() {
|
|
||||||
let tag = ExtXMedia::new(MediaType::Audio, quoted_string("foo"), quoted_string("bar"));
|
|
||||||
let text = r#"#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="foo",NAME="bar""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_stream_inf() {
|
|
||||||
let tag = ExtXStreamInf::new(SingleLineString::new("foo").unwrap(), 1000);
|
|
||||||
let text = "#EXT-X-STREAM-INF:BANDWIDTH=1000\nfoo";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_i_frame_stream_inf() {
|
|
||||||
let tag = ExtXIFrameStreamInf::new(quoted_string("foo"), 1000);
|
|
||||||
let text = r#"#EXT-X-I-FRAME-STREAM-INF:URI="foo",BANDWIDTH=1000"#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_session_data() {
|
|
||||||
let tag = ExtXSessionData::new(
|
|
||||||
quoted_string("foo"),
|
|
||||||
SessionData::Value(quoted_string("bar")),
|
|
||||||
);
|
|
||||||
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",VALUE="bar""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag =
|
|
||||||
ExtXSessionData::new(quoted_string("foo"), SessionData::Uri(quoted_string("bar")));
|
|
||||||
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",URI="bar""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag = ExtXSessionData::with_language(
|
|
||||||
quoted_string("foo"),
|
|
||||||
SessionData::Value(quoted_string("bar")),
|
|
||||||
quoted_string("baz"),
|
|
||||||
);
|
|
||||||
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",VALUE="bar",LANGUAGE="baz""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_session_key() {
|
|
||||||
let tag = ExtXSessionKey::new(DecryptionKey {
|
|
||||||
method: EncryptionMethod::Aes128,
|
|
||||||
uri: quoted_string("foo"),
|
|
||||||
iv: Some(InitializationVector([
|
|
||||||
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
|
||||||
])),
|
|
||||||
key_format: None,
|
|
||||||
key_format_versions: None,
|
|
||||||
});
|
|
||||||
let text =
|
|
||||||
r#"#EXT-X-SESSION-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f"#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V2);
|
|
||||||
}
|
|
||||||
|
|
||||||
fn quoted_string(s: &str) -> QuotedString {
|
|
||||||
QuotedString::new(s).unwrap()
|
|
||||||
}
|
|
||||||
}
|
|
290
src/tags/media.rs
Normal file
290
src/tags/media.rs
Normal file
|
@ -0,0 +1,290 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use derive_builder::Builder;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{InStreamId, MediaType, ProtocolVersion};
|
||||||
|
use crate::utils::parse_yes_or_no;
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
|
||||||
|
/// [4.3.4.1. EXT-X-MEDIA]
|
||||||
|
///
|
||||||
|
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
||||||
|
#[derive(Builder, Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
#[builder(setter(into, strip_option))]
|
||||||
|
pub struct ExtXMedia {
|
||||||
|
/// Sets the media type of the rendition.
|
||||||
|
media_type: MediaType,
|
||||||
|
/// The URI that identifies the media playlist.
|
||||||
|
uri: Option<String>,
|
||||||
|
/// Sets the identifier that specifies the group to which the rendition belongs.
|
||||||
|
group_id: String,
|
||||||
|
/// Sets the name of the primary language used in the rendition.
|
||||||
|
language: Option<String>,
|
||||||
|
/// Sets the name of a language associated with the rendition.
|
||||||
|
assoc_language: Option<String>,
|
||||||
|
/// Sets a human-readable description of the rendition.
|
||||||
|
name: String,
|
||||||
|
/// Sets the value of the `default` flag.
|
||||||
|
// has been changed, from `default` to `is_default`, because it caused a naming conflict
|
||||||
|
// with the trait implementation of `Default`.
|
||||||
|
is_default: bool,
|
||||||
|
/// Sets the value of the `autoselect` flag.
|
||||||
|
autoselect: bool,
|
||||||
|
/// Sets the value of the `forced` flag.
|
||||||
|
forced: bool,
|
||||||
|
/// Sets the identifier that specifies a rendition within the segments in the media playlist.
|
||||||
|
instream_id: Option<InStreamId>,
|
||||||
|
/// Sets the string that represents uniform type identifiers (UTI).
|
||||||
|
characteristics: Option<String>,
|
||||||
|
/// Sets the string that represents the parameters of the rendition.
|
||||||
|
channels: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXMedia {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-MEDIA:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXMedia` tag.
|
||||||
|
pub fn new<T: ToString>(media_type: MediaType, group_id: T, name: T) -> Self {
|
||||||
|
ExtXMedia {
|
||||||
|
media_type,
|
||||||
|
uri: None,
|
||||||
|
group_id: group_id.to_string(),
|
||||||
|
language: None,
|
||||||
|
assoc_language: None,
|
||||||
|
name: name.to_string(),
|
||||||
|
is_default: false,
|
||||||
|
autoselect: false,
|
||||||
|
forced: false,
|
||||||
|
instream_id: None,
|
||||||
|
characteristics: None,
|
||||||
|
channels: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Create a builder to configure a new `ExtXMedia`-struct.
|
||||||
|
pub fn builder() -> ExtXMediaBuilder {
|
||||||
|
ExtXMediaBuilder::default()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the type of the media associated with this tag.
|
||||||
|
pub fn media_type(&self) -> MediaType {
|
||||||
|
self.media_type
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the identifier that specifies the group to which the rendition belongs.
|
||||||
|
pub fn group_id(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.group_id)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a human-readable description of the rendition.
|
||||||
|
pub fn name(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.name)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the URI that identifies the media playlist.
|
||||||
|
pub fn uri(&self) -> Option<Cow<'_, str>> {
|
||||||
|
// TODO! Uri
|
||||||
|
match &self.uri {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the name of the primary language used in the rendition.
|
||||||
|
// TODO: look in spec if this can be an enum?
|
||||||
|
pub fn language(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.language {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the name of a language associated with the rendition.
|
||||||
|
pub fn assoc_language(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.assoc_language {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether this is the default rendition.
|
||||||
|
pub fn is_default(&self) -> bool {
|
||||||
|
self.is_default
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether the client may choose to
|
||||||
|
/// play this rendition in the absence of explicit user preference.
|
||||||
|
pub fn is_autoselect(&self) -> bool {
|
||||||
|
self.autoselect
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether the rendition contains content that is considered essential to play.
|
||||||
|
pub fn is_forced(&self) -> bool {
|
||||||
|
self.forced
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the identifier that specifies a rendition within the segments in the media playlist.
|
||||||
|
pub fn instream_id(&self) -> Option<InStreamId> {
|
||||||
|
self.instream_id
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a string that represents uniform type identifiers (UTI).
|
||||||
|
///
|
||||||
|
/// Each UTI indicates an individual characteristic of the rendition.
|
||||||
|
pub fn characteristics(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.characteristics {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a string that represents the parameters of the rendition.
|
||||||
|
pub fn channels(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.channels {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
match self.instream_id {
|
||||||
|
None
|
||||||
|
| Some(InStreamId::Cc1)
|
||||||
|
| Some(InStreamId::Cc2)
|
||||||
|
| Some(InStreamId::Cc3)
|
||||||
|
| Some(InStreamId::Cc4) => ProtocolVersion::V1,
|
||||||
|
_ => ProtocolVersion::V7,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXMedia {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
write!(f, "TYPE={}", self.media_type)?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.uri {
|
||||||
|
write!(f, ",URI={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
write!(f, ",GROUP-ID={}", self.group_id)?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.language {
|
||||||
|
write!(f, ",LANGUAGE={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.assoc_language {
|
||||||
|
write!(f, ",ASSOC-LANGUAGE={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
write!(f, ",NAME={}", self.name)?;
|
||||||
|
|
||||||
|
if self.is_default {
|
||||||
|
write!(f, ",DEFAULT=YES")?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if self.autoselect {
|
||||||
|
write!(f, ",AUTOSELECT=YES")?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if self.forced {
|
||||||
|
write!(f, ",FORCED=YES")?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.instream_id {
|
||||||
|
write!(f, ",INSTREAM-ID={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.characteristics {
|
||||||
|
write!(f, ",CHARACTERISTICS={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.channels {
|
||||||
|
write!(f, ",CHANNELS={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXMedia {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
// TODO: ErrorKind::InvalidPrefix(what_this_line_is_instead)
|
||||||
|
if !s.starts_with(Self::PREFIX) {
|
||||||
|
Err(ErrorKind::InvalidInput)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
let mut builder = ExtXMediaBuilder::default();
|
||||||
|
|
||||||
|
let attrs = track!((s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>())?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"TYPE" => {
|
||||||
|
builder.media_type(value.parse::<MediaType>()?);
|
||||||
|
}
|
||||||
|
"URI" => {
|
||||||
|
builder.uri(unquote(value));
|
||||||
|
}
|
||||||
|
"GROUP-ID" => {
|
||||||
|
builder.group_id(value);
|
||||||
|
}
|
||||||
|
"LANGUAGE" => {
|
||||||
|
builder.language(value);
|
||||||
|
}
|
||||||
|
"ASSOC-LANGUAGE" => {
|
||||||
|
builder.assoc_language(value);
|
||||||
|
}
|
||||||
|
"NAME" => {
|
||||||
|
builder.name(value);
|
||||||
|
}
|
||||||
|
"DEFAULT" => {
|
||||||
|
builder.is_default(track!(parse_yes_or_no(value))?);
|
||||||
|
}
|
||||||
|
"AUTOSELECT" => {
|
||||||
|
builder.autoselect(track!(parse_yes_or_no(value))?);
|
||||||
|
}
|
||||||
|
"FORCED" => {
|
||||||
|
builder.forced(track!(parse_yes_or_no(value))?);
|
||||||
|
}
|
||||||
|
"INSTREAM-ID" => {
|
||||||
|
builder.instream_id(unquote(value).parse::<InStreamId>()?);
|
||||||
|
}
|
||||||
|
"CHARACTERISTICS" => {
|
||||||
|
builder.characteristics(value);
|
||||||
|
}
|
||||||
|
"CHANNELS" => {
|
||||||
|
builder.channels(value);
|
||||||
|
}
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(builder.build().map_err(|x| ErrorKind::BuilderError(x))?)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
#[ignore]
|
||||||
|
fn ext_x_media() {
|
||||||
|
let tag = ExtXMedia::new(MediaType::Audio, "foo".to_string(), "bar".to_string());
|
||||||
|
let text = r#"#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="foo",NAME="bar""#;
|
||||||
|
assert_eq!(Some(text.parse().unwrap()), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
|
@ -1,279 +0,0 @@
|
||||||
use crate::types::{PlaylistType, ProtocolVersion};
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
|
||||||
use std::str::FromStr;
|
|
||||||
use std::time::Duration;
|
|
||||||
use trackable::error::ErrorKindExt;
|
|
||||||
|
|
||||||
/// [4.3.3.1. EXT-X-TARGETDURATION]
|
|
||||||
///
|
|
||||||
/// [4.3.3.1. EXT-X-TARGETDURATION]: https://tools.ietf.org/html/rfc8216#section-4.3.3.1
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXTargetDuration {
|
|
||||||
duration: Duration,
|
|
||||||
}
|
|
||||||
impl ExtXTargetDuration {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-TARGETDURATION:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXTargetduration` tag.
|
|
||||||
///
|
|
||||||
/// Note that the nanoseconds part of the `duration` will be discarded.
|
|
||||||
pub fn new(duration: Duration) -> Self {
|
|
||||||
let duration = Duration::from_secs(duration.as_secs());
|
|
||||||
ExtXTargetDuration { duration }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the maximum media segment duration in the associated playlist.
|
|
||||||
pub fn duration(&self) -> Duration {
|
|
||||||
self.duration
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXTargetDuration {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.duration.as_secs())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXTargetDuration {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let duration = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
|
||||||
Ok(ExtXTargetDuration {
|
|
||||||
duration: Duration::from_secs(duration),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.3.2. EXT-X-MEDIA-SEQUENCE]
|
|
||||||
///
|
|
||||||
/// [4.3.3.2. EXT-X-MEDIA-SEQUENCE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXMediaSequence {
|
|
||||||
seq_num: u64,
|
|
||||||
}
|
|
||||||
impl ExtXMediaSequence {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-MEDIA-SEQUENCE:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXMediaSequence` tag.
|
|
||||||
pub fn new(seq_num: u64) -> Self {
|
|
||||||
ExtXMediaSequence { seq_num }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the sequence number of the first media segment that appears in the associated playlist.
|
|
||||||
pub fn seq_num(self) -> u64 {
|
|
||||||
self.seq_num
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXMediaSequence {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.seq_num)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXMediaSequence {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let seq_num = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
|
||||||
Ok(ExtXMediaSequence { seq_num })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.3.3. EXT-X-DISCONTINUITY-SEQUENCE]
|
|
||||||
///
|
|
||||||
/// [4.3.3.3. EXT-X-DISCONTINUITY-SEQUENCE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.3
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXDiscontinuitySequence {
|
|
||||||
seq_num: u64,
|
|
||||||
}
|
|
||||||
impl ExtXDiscontinuitySequence {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-DISCONTINUITY-SEQUENCE:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXDiscontinuitySequence` tag.
|
|
||||||
pub fn new(seq_num: u64) -> Self {
|
|
||||||
ExtXDiscontinuitySequence { seq_num }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the discontinuity sequence number of
|
|
||||||
/// the first media segment that appears in the associated playlist.
|
|
||||||
pub fn seq_num(self) -> u64 {
|
|
||||||
self.seq_num
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXDiscontinuitySequence {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.seq_num)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXDiscontinuitySequence {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let seq_num = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
|
||||||
Ok(ExtXDiscontinuitySequence { seq_num })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.3.4. EXT-X-ENDLIST]
|
|
||||||
///
|
|
||||||
/// [4.3.3.4. EXT-X-ENDLIST]: https://tools.ietf.org/html/rfc8216#section-4.3.3.4
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXEndList;
|
|
||||||
impl ExtXEndList {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-ENDLIST";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXEndList {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
Self::PREFIX.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXEndList {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXEndList)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]
|
|
||||||
///
|
|
||||||
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.5
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXPlaylistType {
|
|
||||||
playlist_type: PlaylistType,
|
|
||||||
}
|
|
||||||
impl ExtXPlaylistType {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-PLAYLIST-TYPE:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXPlaylistType` tag.
|
|
||||||
pub fn new(playlist_type: PlaylistType) -> Self {
|
|
||||||
ExtXPlaylistType { playlist_type }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the type of the associated media playlist.
|
|
||||||
pub fn playlist_type(self) -> PlaylistType {
|
|
||||||
self.playlist_type
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXPlaylistType {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.playlist_type)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXPlaylistType {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let playlist_type = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
|
||||||
Ok(ExtXPlaylistType { playlist_type })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.3.6. EXT-X-I-FRAMES-ONLY]
|
|
||||||
///
|
|
||||||
/// [4.3.3.6. EXT-X-I-FRAMES-ONLY]: https://tools.ietf.org/html/rfc8216#section-4.3.3.6
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXIFramesOnly;
|
|
||||||
impl ExtXIFramesOnly {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-I-FRAMES-ONLY";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V4
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXIFramesOnly {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
Self::PREFIX.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXIFramesOnly {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXIFramesOnly)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod test {
|
|
||||||
use super::*;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_targetduration() {
|
|
||||||
let tag = ExtXTargetDuration::new(Duration::from_secs(5));
|
|
||||||
let text = "#EXT-X-TARGETDURATION:5";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_media_sequence() {
|
|
||||||
let tag = ExtXMediaSequence::new(123);
|
|
||||||
let text = "#EXT-X-MEDIA-SEQUENCE:123";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_discontinuity_sequence() {
|
|
||||||
let tag = ExtXDiscontinuitySequence::new(123);
|
|
||||||
let text = "#EXT-X-DISCONTINUITY-SEQUENCE:123";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_endlist() {
|
|
||||||
let tag = ExtXEndList;
|
|
||||||
let text = "#EXT-X-ENDLIST";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_playlist_type() {
|
|
||||||
let tag = ExtXPlaylistType::new(PlaylistType::Vod);
|
|
||||||
let text = "#EXT-X-PLAYLIST-TYPE:VOD";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_i_frames_only() {
|
|
||||||
let tag = ExtXIFramesOnly;
|
|
||||||
let text = "#EXT-X-I-FRAMES-ONLY";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V4);
|
|
||||||
}
|
|
||||||
}
|
|
|
@ -1,613 +0,0 @@
|
||||||
use crate::attribute::AttributePairs;
|
|
||||||
use crate::types::{
|
|
||||||
ByteRange, DecimalFloatingPoint, DecryptionKey, ProtocolVersion, QuotedString, SingleLineString,
|
|
||||||
};
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::collections::BTreeMap;
|
|
||||||
use std::fmt;
|
|
||||||
use std::str::FromStr;
|
|
||||||
use std::time::Duration;
|
|
||||||
use trackable::error::ErrorKindExt;
|
|
||||||
|
|
||||||
/// [4.3.2.1. EXTINF]
|
|
||||||
///
|
|
||||||
/// [4.3.2.1. EXTINF]: https://tools.ietf.org/html/rfc8216#section-4.3.2.1
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtInf {
|
|
||||||
duration: Duration,
|
|
||||||
title: Option<SingleLineString>,
|
|
||||||
}
|
|
||||||
impl ExtInf {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXTINF:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtInf` tag.
|
|
||||||
pub fn new(duration: Duration) -> Self {
|
|
||||||
ExtInf {
|
|
||||||
duration,
|
|
||||||
title: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Makes a new `ExtInf` tag with the given title.
|
|
||||||
pub fn with_title(duration: Duration, title: SingleLineString) -> Self {
|
|
||||||
ExtInf {
|
|
||||||
duration,
|
|
||||||
title: Some(title),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the duration of the associated media segment.
|
|
||||||
pub fn duration(&self) -> Duration {
|
|
||||||
self.duration
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the title of the associated media segment.
|
|
||||||
pub fn title(&self) -> Option<&SingleLineString> {
|
|
||||||
self.title.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
if self.duration.subsec_nanos() == 0 {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
} else {
|
|
||||||
ProtocolVersion::V3
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtInf {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
|
|
||||||
let duration = (self.duration.as_secs() as f64)
|
|
||||||
+ (f64::from(self.duration.subsec_nanos()) / 1_000_000_000.0);
|
|
||||||
write!(f, "{}", duration)?;
|
|
||||||
|
|
||||||
if let Some(ref title) = self.title {
|
|
||||||
write!(f, ",{}", title)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtInf {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let mut tokens = s.split_at(Self::PREFIX.len()).1.splitn(2, ',');
|
|
||||||
|
|
||||||
let seconds: DecimalFloatingPoint =
|
|
||||||
may_invalid!(tokens.next().expect("Never fails").parse())?;
|
|
||||||
let duration = seconds.to_duration();
|
|
||||||
|
|
||||||
let title = if let Some(title) = tokens.next() {
|
|
||||||
Some(track!(SingleLineString::new(title))?)
|
|
||||||
} else {
|
|
||||||
None
|
|
||||||
};
|
|
||||||
Ok(ExtInf { duration, title })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.2. EXT-X-BYTERANGE]
|
|
||||||
///
|
|
||||||
/// [4.3.2.2. EXT-X-BYTERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXByteRange {
|
|
||||||
range: ByteRange,
|
|
||||||
}
|
|
||||||
impl ExtXByteRange {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-BYTERANGE:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXByteRange` tag.
|
|
||||||
pub fn new(range: ByteRange) -> Self {
|
|
||||||
ExtXByteRange { range }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the range of the associated media segment.
|
|
||||||
pub fn range(&self) -> ByteRange {
|
|
||||||
self.range
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V4
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXByteRange {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.range)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXByteRange {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let range = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
|
||||||
Ok(ExtXByteRange { range })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.3. EXT-X-DISCONTINUITY]
|
|
||||||
///
|
|
||||||
/// [4.3.2.3. EXT-X-DISCONTINUITY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.3
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXDiscontinuity;
|
|
||||||
impl ExtXDiscontinuity {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-DISCONTINUITY";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXDiscontinuity {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
Self::PREFIX.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXDiscontinuity {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXDiscontinuity)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.4. EXT-X-KEY]
|
|
||||||
///
|
|
||||||
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXKey {
|
|
||||||
key: Option<DecryptionKey>,
|
|
||||||
}
|
|
||||||
impl ExtXKey {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-KEY:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXKey` tag.
|
|
||||||
pub fn new(key: DecryptionKey) -> Self {
|
|
||||||
ExtXKey { key: Some(key) }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Makes a new `ExtXKey` tag without a decryption key.
|
|
||||||
///
|
|
||||||
/// This tag has the `METHDO=NONE` attribute.
|
|
||||||
pub fn new_without_key() -> Self {
|
|
||||||
ExtXKey { key: None }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the decryption key for the following media segments and media initialization sections.
|
|
||||||
pub fn key(&self) -> Option<&DecryptionKey> {
|
|
||||||
self.key.as_ref()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
self.key
|
|
||||||
.as_ref()
|
|
||||||
.map_or(ProtocolVersion::V1, |k| k.requires_version())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXKey {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
if let Some(ref key) = self.key {
|
|
||||||
write!(f, "{}", key)?;
|
|
||||||
} else {
|
|
||||||
write!(f, "METHOD=NONE")?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXKey {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let suffix = s.split_at(Self::PREFIX.len()).1;
|
|
||||||
|
|
||||||
if AttributePairs::parse(suffix).any(|a| a.as_ref().ok() == Some(&("METHOD", "NONE"))) {
|
|
||||||
for attr in AttributePairs::parse(suffix) {
|
|
||||||
let (key, _) = track!(attr)?;
|
|
||||||
track_assert_ne!(key, "URI", ErrorKind::InvalidInput);
|
|
||||||
track_assert_ne!(key, "IV", ErrorKind::InvalidInput);
|
|
||||||
track_assert_ne!(key, "KEYFORMAT", ErrorKind::InvalidInput);
|
|
||||||
track_assert_ne!(key, "KEYFORMATVERSIONS", ErrorKind::InvalidInput);
|
|
||||||
}
|
|
||||||
Ok(ExtXKey { key: None })
|
|
||||||
} else {
|
|
||||||
let key = track!(suffix.parse())?;
|
|
||||||
Ok(ExtXKey { key: Some(key) })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.5. EXT-X-MAP]
|
|
||||||
///
|
|
||||||
/// [4.3.2.5. EXT-X-MAP]: https://tools.ietf.org/html/rfc8216#section-4.3.2.5
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXMap {
|
|
||||||
uri: QuotedString,
|
|
||||||
range: Option<ByteRange>,
|
|
||||||
}
|
|
||||||
impl ExtXMap {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-MAP:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXMap` tag.
|
|
||||||
pub fn new(uri: QuotedString) -> Self {
|
|
||||||
ExtXMap { uri, range: None }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Makes a new `ExtXMap` tag with the given range.
|
|
||||||
pub fn with_range(uri: QuotedString, range: ByteRange) -> Self {
|
|
||||||
ExtXMap {
|
|
||||||
uri,
|
|
||||||
range: Some(range),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the URI that identifies a resource that contains the media initialization section.
|
|
||||||
pub fn uri(&self) -> &QuotedString {
|
|
||||||
&self.uri
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the range of the media initialization section.
|
|
||||||
pub fn range(&self) -> Option<ByteRange> {
|
|
||||||
self.range
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V6
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXMap {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "URI={}", self.uri)?;
|
|
||||||
if let Some(ref x) = self.range {
|
|
||||||
write!(f, ",BYTERANGE=\"{}\"", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXMap {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut uri = None;
|
|
||||||
let mut range = None;
|
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"URI" => uri = Some(track!(value.parse())?),
|
|
||||||
"BYTERANGE" => {
|
|
||||||
let s: QuotedString = track!(value.parse())?;
|
|
||||||
range = Some(track!(s.parse())?);
|
|
||||||
}
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXMap { uri, range })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]
|
|
||||||
///
|
|
||||||
/// [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]: https://tools.ietf.org/html/rfc8216#section-4.3.2.6
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXProgramDateTime {
|
|
||||||
date_time: SingleLineString,
|
|
||||||
}
|
|
||||||
impl ExtXProgramDateTime {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-PROGRAM-DATE-TIME:";
|
|
||||||
|
|
||||||
/// Makes a new `ExtXProgramDateTime` tag.
|
|
||||||
pub fn new(date_time: SingleLineString) -> Self {
|
|
||||||
ExtXProgramDateTime { date_time }
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the date-time of the first sample of the associated media segment.
|
|
||||||
pub fn date_time(&self) -> &SingleLineString {
|
|
||||||
&self.date_time
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXProgramDateTime {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}{}", Self::PREFIX, self.date_time)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXProgramDateTime {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
let suffix = s.split_at(Self::PREFIX.len()).1;
|
|
||||||
Ok(ExtXProgramDateTime {
|
|
||||||
date_time: track!(SingleLineString::new(suffix))?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.2.7. EXT-X-DATERANGE]
|
|
||||||
///
|
|
||||||
/// [4.3.2.7. EXT-X-DATERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.7
|
|
||||||
///
|
|
||||||
/// TODO: Implement properly
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ExtXDateRange {
|
|
||||||
pub id: QuotedString,
|
|
||||||
pub class: Option<QuotedString>,
|
|
||||||
pub start_date: QuotedString,
|
|
||||||
pub end_date: Option<QuotedString>,
|
|
||||||
pub duration: Option<Duration>,
|
|
||||||
pub planned_duration: Option<Duration>,
|
|
||||||
pub scte35_cmd: Option<QuotedString>,
|
|
||||||
pub scte35_out: Option<QuotedString>,
|
|
||||||
pub scte35_in: Option<QuotedString>,
|
|
||||||
pub end_on_next: bool,
|
|
||||||
pub client_attributes: BTreeMap<String, String>,
|
|
||||||
}
|
|
||||||
impl ExtXDateRange {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-DATERANGE:";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXDateRange {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
|
||||||
write!(f, "ID={}", self.id)?;
|
|
||||||
if let Some(ref x) = self.class {
|
|
||||||
write!(f, ",CLASS={}", x)?;
|
|
||||||
}
|
|
||||||
write!(f, ",START-DATE={}", self.start_date)?;
|
|
||||||
if let Some(ref x) = self.end_date {
|
|
||||||
write!(f, ",END-DATE={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(x) = self.duration {
|
|
||||||
write!(f, ",DURATION={}", DecimalFloatingPoint::from_duration(x))?;
|
|
||||||
}
|
|
||||||
if let Some(x) = self.planned_duration {
|
|
||||||
write!(
|
|
||||||
f,
|
|
||||||
",PLANNED-DURATION={}",
|
|
||||||
DecimalFloatingPoint::from_duration(x)
|
|
||||||
)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.scte35_cmd {
|
|
||||||
write!(f, ",SCTE35-CMD={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.scte35_out {
|
|
||||||
write!(f, ",SCTE35-OUT={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.scte35_in {
|
|
||||||
write!(f, ",SCTE35-IN={}", x)?;
|
|
||||||
}
|
|
||||||
if self.end_on_next {
|
|
||||||
write!(f, ",END-ON-NEXT=YES",)?;
|
|
||||||
}
|
|
||||||
for (k, v) in &self.client_attributes {
|
|
||||||
write!(f, ",{}={}", k, v)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXDateRange {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut id = None;
|
|
||||||
let mut class = None;
|
|
||||||
let mut start_date = None;
|
|
||||||
let mut end_date = None;
|
|
||||||
let mut duration = None;
|
|
||||||
let mut planned_duration = None;
|
|
||||||
let mut scte35_cmd = None;
|
|
||||||
let mut scte35_out = None;
|
|
||||||
let mut scte35_in = None;
|
|
||||||
let mut end_on_next = false;
|
|
||||||
let mut client_attributes = BTreeMap::new();
|
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"ID" => id = Some(track!(value.parse())?),
|
|
||||||
"CLASS" => class = Some(track!(value.parse())?),
|
|
||||||
"START-DATE" => start_date = Some(track!(value.parse())?),
|
|
||||||
"END-DATE" => end_date = Some(track!(value.parse())?),
|
|
||||||
"DURATION" => {
|
|
||||||
let seconds: DecimalFloatingPoint = track!(value.parse())?;
|
|
||||||
duration = Some(seconds.to_duration());
|
|
||||||
}
|
|
||||||
"PLANNED-DURATION" => {
|
|
||||||
let seconds: DecimalFloatingPoint = track!(value.parse())?;
|
|
||||||
planned_duration = Some(seconds.to_duration());
|
|
||||||
}
|
|
||||||
"SCTE35-CMD" => scte35_cmd = Some(track!(value.parse())?),
|
|
||||||
"SCTE35-OUT" => scte35_out = Some(track!(value.parse())?),
|
|
||||||
"SCTE35-IN" => scte35_in = Some(track!(value.parse())?),
|
|
||||||
"END-ON-NEXT" => {
|
|
||||||
track_assert_eq!(value, "YES", ErrorKind::InvalidInput);
|
|
||||||
end_on_next = true;
|
|
||||||
}
|
|
||||||
_ => {
|
|
||||||
if key.starts_with("X-") {
|
|
||||||
client_attributes.insert(key.split_at(2).1.to_owned(), value.to_owned());
|
|
||||||
} else {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
let id = track_assert_some!(id, ErrorKind::InvalidInput);
|
|
||||||
let start_date = track_assert_some!(start_date, ErrorKind::InvalidInput);
|
|
||||||
if end_on_next {
|
|
||||||
track_assert!(class.is_some(), ErrorKind::InvalidInput);
|
|
||||||
}
|
|
||||||
Ok(ExtXDateRange {
|
|
||||||
id,
|
|
||||||
class,
|
|
||||||
start_date,
|
|
||||||
end_date,
|
|
||||||
duration,
|
|
||||||
planned_duration,
|
|
||||||
scte35_cmd,
|
|
||||||
scte35_out,
|
|
||||||
scte35_in,
|
|
||||||
end_on_next,
|
|
||||||
client_attributes,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod test {
|
|
||||||
use super::*;
|
|
||||||
use crate::types::{EncryptionMethod, InitializationVector};
|
|
||||||
use std::time::Duration;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn extinf() {
|
|
||||||
let tag = ExtInf::new(Duration::from_secs(5));
|
|
||||||
assert_eq!("#EXTINF:5".parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), "#EXTINF:5");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag = ExtInf::with_title(
|
|
||||||
Duration::from_secs(5),
|
|
||||||
SingleLineString::new("foo").unwrap(),
|
|
||||||
);
|
|
||||||
assert_eq!("#EXTINF:5,foo".parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), "#EXTINF:5,foo");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag = ExtInf::new(Duration::from_millis(1234));
|
|
||||||
assert_eq!("#EXTINF:1.234".parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), "#EXTINF:1.234");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V3);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_byterange() {
|
|
||||||
let tag = ExtXByteRange::new(ByteRange {
|
|
||||||
length: 3,
|
|
||||||
start: None,
|
|
||||||
});
|
|
||||||
assert_eq!("#EXT-X-BYTERANGE:3".parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), "#EXT-X-BYTERANGE:3");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V4);
|
|
||||||
|
|
||||||
let tag = ExtXByteRange::new(ByteRange {
|
|
||||||
length: 3,
|
|
||||||
start: Some(5),
|
|
||||||
});
|
|
||||||
assert_eq!("#EXT-X-BYTERANGE:3@5".parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), "#EXT-X-BYTERANGE:3@5");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V4);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_discontinuity() {
|
|
||||||
let tag = ExtXDiscontinuity;
|
|
||||||
assert_eq!("#EXT-X-DISCONTINUITY".parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), "#EXT-X-DISCONTINUITY");
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_key() {
|
|
||||||
let tag = ExtXKey::new_without_key();
|
|
||||||
let text = "#EXT-X-KEY:METHOD=NONE";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag = ExtXKey::new(DecryptionKey {
|
|
||||||
method: EncryptionMethod::Aes128,
|
|
||||||
uri: QuotedString::new("foo").unwrap(),
|
|
||||||
iv: None,
|
|
||||||
key_format: None,
|
|
||||||
key_format_versions: None,
|
|
||||||
});
|
|
||||||
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
|
|
||||||
let tag = ExtXKey::new(DecryptionKey {
|
|
||||||
method: EncryptionMethod::Aes128,
|
|
||||||
uri: QuotedString::new("foo").unwrap(),
|
|
||||||
iv: Some(InitializationVector([
|
|
||||||
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
|
||||||
])),
|
|
||||||
key_format: None,
|
|
||||||
key_format_versions: None,
|
|
||||||
});
|
|
||||||
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f"#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V2);
|
|
||||||
|
|
||||||
let tag = ExtXKey::new(DecryptionKey {
|
|
||||||
method: EncryptionMethod::Aes128,
|
|
||||||
uri: QuotedString::new("foo").unwrap(),
|
|
||||||
iv: Some(InitializationVector([
|
|
||||||
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
|
||||||
])),
|
|
||||||
key_format: Some(QuotedString::new("baz").unwrap()),
|
|
||||||
key_format_versions: None,
|
|
||||||
});
|
|
||||||
let text = r#"#EXT-X-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f,KEYFORMAT="baz""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V5);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_map() {
|
|
||||||
let tag = ExtXMap::new(QuotedString::new("foo").unwrap());
|
|
||||||
let text = r#"#EXT-X-MAP:URI="foo""#;
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V6);
|
|
||||||
|
|
||||||
let tag = ExtXMap::with_range(
|
|
||||||
QuotedString::new("foo").unwrap(),
|
|
||||||
ByteRange {
|
|
||||||
length: 9,
|
|
||||||
start: Some(2),
|
|
||||||
},
|
|
||||||
);
|
|
||||||
let text = r#"#EXT-X-MAP:URI="foo",BYTERANGE="9@2""#;
|
|
||||||
track_try_unwrap!(ExtXMap::from_str(text));
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V6);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_program_date_time() {
|
|
||||||
let text = "#EXT-X-PROGRAM-DATE-TIME:2010-02-19T14:54:23.031+08:00";
|
|
||||||
assert!(text.parse::<ExtXProgramDateTime>().is_ok());
|
|
||||||
|
|
||||||
let tag = text.parse::<ExtXProgramDateTime>().unwrap();
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
}
|
|
62
src/tags/media_sequence.rs
Normal file
62
src/tags/media_sequence.rs
Normal file
|
@ -0,0 +1,62 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.3.2. EXT-X-MEDIA-SEQUENCE]
|
||||||
|
///
|
||||||
|
/// [4.3.3.2. EXT-X-MEDIA-SEQUENCE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXMediaSequence(u64);
|
||||||
|
|
||||||
|
impl ExtXMediaSequence {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-MEDIA-SEQUENCE:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXMediaSequence` tag.
|
||||||
|
pub const fn new(seq_num: u64) -> Self {
|
||||||
|
Self(seq_num)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the sequence number of the first media segment that appears in the associated playlist.
|
||||||
|
pub const fn seq_num(&self) -> u64 {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version, that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXMediaSequence {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXMediaSequence {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let seq_num = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
||||||
|
Ok(Self(seq_num))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_media_sequence() {
|
||||||
|
let tag = ExtXMediaSequence::new(123);
|
||||||
|
let text = "#EXT-X-MEDIA-SEQUENCE:123";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
|
@ -1,8 +1,6 @@
|
||||||
//! [4.3. Playlist Tags]
|
//! [4.3. Playlist Tags]
|
||||||
//!
|
//!
|
||||||
//! [4.3. Playlist Tags]: https://tools.ietf.org/html/rfc8216#section-4.3
|
//! [4.3. Playlist Tags]: https://tools.ietf.org/html/rfc8216#section-4.3
|
||||||
use crate::{ErrorKind, Result};
|
|
||||||
use trackable::error::ErrorKindExt;
|
|
||||||
|
|
||||||
macro_rules! may_invalid {
|
macro_rules! may_invalid {
|
||||||
($expr:expr) => {
|
($expr:expr) => {
|
||||||
|
@ -20,24 +18,52 @@ macro_rules! impl_from {
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
pub use self::basic::{ExtM3u, ExtXVersion};
|
// new mods:
|
||||||
pub use self::master_playlist::{
|
mod byte_range;
|
||||||
ExtXIFrameStreamInf, ExtXMedia, ExtXSessionData, ExtXSessionKey, ExtXStreamInf,
|
mod date_range;
|
||||||
};
|
mod discontinuity;
|
||||||
pub use self::media_or_master_playlist::{ExtXIndependentSegments, ExtXStart};
|
mod discontinuity_sequence;
|
||||||
pub use self::media_playlist::{
|
mod end_list;
|
||||||
ExtXDiscontinuitySequence, ExtXEndList, ExtXIFramesOnly, ExtXMediaSequence, ExtXPlaylistType,
|
mod iframe_stream_inf;
|
||||||
ExtXTargetDuration,
|
mod iframes_only;
|
||||||
};
|
mod independent_segments;
|
||||||
pub use self::media_segment::{
|
mod inf;
|
||||||
ExtInf, ExtXByteRange, ExtXDateRange, ExtXDiscontinuity, ExtXKey, ExtXMap, ExtXProgramDateTime,
|
mod key;
|
||||||
};
|
mod m3u;
|
||||||
|
mod map;
|
||||||
|
mod media;
|
||||||
|
mod media_sequence;
|
||||||
|
mod playlist_type;
|
||||||
|
mod program_date_time;
|
||||||
|
mod session_data;
|
||||||
|
mod session_key;
|
||||||
|
mod start;
|
||||||
|
mod stream_inf;
|
||||||
|
mod target_duration;
|
||||||
|
mod version;
|
||||||
|
|
||||||
mod basic;
|
pub use byte_range::*;
|
||||||
mod master_playlist;
|
pub use date_range::*;
|
||||||
mod media_or_master_playlist;
|
pub use discontinuity::*;
|
||||||
mod media_playlist;
|
pub use discontinuity_sequence::*;
|
||||||
mod media_segment;
|
pub use end_list::*;
|
||||||
|
pub use iframe_stream_inf::*;
|
||||||
|
pub use iframes_only::*;
|
||||||
|
pub use independent_segments::*;
|
||||||
|
pub use inf::*;
|
||||||
|
pub use key::*;
|
||||||
|
pub use m3u::*;
|
||||||
|
pub use map::*;
|
||||||
|
pub use media::*;
|
||||||
|
pub use media_sequence::*;
|
||||||
|
pub use playlist_type::*;
|
||||||
|
pub use program_date_time::*;
|
||||||
|
pub use session_data::*;
|
||||||
|
pub use session_key::*;
|
||||||
|
pub use start::*;
|
||||||
|
pub use stream_inf::*;
|
||||||
|
pub use target_duration::*;
|
||||||
|
pub use version::*;
|
||||||
|
|
||||||
/// [4.3.4. Master Playlist Tags]
|
/// [4.3.4. Master Playlist Tags]
|
||||||
///
|
///
|
||||||
|
@ -57,6 +83,7 @@ pub enum MasterPlaylistTag {
|
||||||
ExtXIndependentSegments(ExtXIndependentSegments),
|
ExtXIndependentSegments(ExtXIndependentSegments),
|
||||||
ExtXStart(ExtXStart),
|
ExtXStart(ExtXStart),
|
||||||
}
|
}
|
||||||
|
|
||||||
impl_from!(MasterPlaylistTag, ExtXMedia);
|
impl_from!(MasterPlaylistTag, ExtXMedia);
|
||||||
impl_from!(MasterPlaylistTag, ExtXStreamInf);
|
impl_from!(MasterPlaylistTag, ExtXStreamInf);
|
||||||
impl_from!(MasterPlaylistTag, ExtXIFrameStreamInf);
|
impl_from!(MasterPlaylistTag, ExtXIFrameStreamInf);
|
||||||
|
@ -83,6 +110,7 @@ pub enum MediaPlaylistTag {
|
||||||
ExtXIndependentSegments(ExtXIndependentSegments),
|
ExtXIndependentSegments(ExtXIndependentSegments),
|
||||||
ExtXStart(ExtXStart),
|
ExtXStart(ExtXStart),
|
||||||
}
|
}
|
||||||
|
|
||||||
impl_from!(MediaPlaylistTag, ExtXTargetDuration);
|
impl_from!(MediaPlaylistTag, ExtXTargetDuration);
|
||||||
impl_from!(MediaPlaylistTag, ExtXMediaSequence);
|
impl_from!(MediaPlaylistTag, ExtXMediaSequence);
|
||||||
impl_from!(MediaPlaylistTag, ExtXDiscontinuitySequence);
|
impl_from!(MediaPlaylistTag, ExtXDiscontinuitySequence);
|
||||||
|
@ -107,6 +135,7 @@ pub enum MediaSegmentTag {
|
||||||
ExtXMap(ExtXMap),
|
ExtXMap(ExtXMap),
|
||||||
ExtXProgramDateTime(ExtXProgramDateTime),
|
ExtXProgramDateTime(ExtXProgramDateTime),
|
||||||
}
|
}
|
||||||
|
|
||||||
impl_from!(MediaSegmentTag, ExtInf);
|
impl_from!(MediaSegmentTag, ExtInf);
|
||||||
impl_from!(MediaSegmentTag, ExtXByteRange);
|
impl_from!(MediaSegmentTag, ExtXByteRange);
|
||||||
impl_from!(MediaSegmentTag, ExtXDateRange);
|
impl_from!(MediaSegmentTag, ExtXDateRange);
|
||||||
|
@ -114,16 +143,3 @@ impl_from!(MediaSegmentTag, ExtXDiscontinuity);
|
||||||
impl_from!(MediaSegmentTag, ExtXKey);
|
impl_from!(MediaSegmentTag, ExtXKey);
|
||||||
impl_from!(MediaSegmentTag, ExtXMap);
|
impl_from!(MediaSegmentTag, ExtXMap);
|
||||||
impl_from!(MediaSegmentTag, ExtXProgramDateTime);
|
impl_from!(MediaSegmentTag, ExtXProgramDateTime);
|
||||||
|
|
||||||
fn parse_yes_or_no(s: &str) -> Result<bool> {
|
|
||||||
match s {
|
|
||||||
"YES" => Ok(true),
|
|
||||||
"NO" => Ok(false),
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unexpected value: {:?}", s),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn parse_u64(s: &str) -> Result<u64> {
|
|
||||||
let n = track!(s.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
Ok(n)
|
|
||||||
}
|
|
||||||
|
|
61
src/tags/playlist_type.rs
Normal file
61
src/tags/playlist_type.rs
Normal file
|
@ -0,0 +1,61 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{PlaylistType, ProtocolVersion};
|
||||||
|
|
||||||
|
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]
|
||||||
|
///
|
||||||
|
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.5
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXPlaylistType(PlaylistType);
|
||||||
|
|
||||||
|
impl ExtXPlaylistType {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-PLAYLIST-TYPE:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXPlaylistType` tag.
|
||||||
|
pub fn new(playlist_type: PlaylistType) -> Self {
|
||||||
|
Self(playlist_type)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the type of the associated media playlist.
|
||||||
|
pub fn playlist_type(self) -> PlaylistType {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXPlaylistType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXPlaylistType {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let playlist_type = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
||||||
|
Ok(Self(playlist_type))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_playlist_type() {
|
||||||
|
let tag = ExtXPlaylistType::new(PlaylistType::Vod);
|
||||||
|
let text = "#EXT-X-PLAYLIST-TYPE:VOD";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
62
src/tags/program_date_time.rs
Normal file
62
src/tags/program_date_time.rs
Normal file
|
@ -0,0 +1,62 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]
|
||||||
|
///
|
||||||
|
/// [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]: https://tools.ietf.org/html/rfc8216#section-4.3.2.6
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXProgramDateTime(String);
|
||||||
|
|
||||||
|
impl ExtXProgramDateTime {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-PROGRAM-DATE-TIME:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXProgramDateTime` tag.
|
||||||
|
pub fn new<T: ToString>(date_time: T) -> Self {
|
||||||
|
Self(date_time.to_string())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the date-time of the first sample of the associated media segment.
|
||||||
|
pub fn date_time(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.0.as_str())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXProgramDateTime {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXProgramDateTime {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
let suffix = s.split_at(Self::PREFIX.len()).1;
|
||||||
|
Ok(Self::new(suffix))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_program_date_time() {
|
||||||
|
let text = "#EXT-X-PROGRAM-DATE-TIME:2010-02-19T14:54:23.031+08:00";
|
||||||
|
assert!(text.parse::<ExtXProgramDateTime>().is_ok());
|
||||||
|
|
||||||
|
let tag = text.parse::<ExtXProgramDateTime>().unwrap();
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
163
src/tags/session_data.rs
Normal file
163
src/tags/session_data.rs
Normal file
|
@ -0,0 +1,163 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{ProtocolVersion, SessionData};
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
|
||||||
|
/// [4.3.4.4. EXT-X-SESSION-DATA]
|
||||||
|
///
|
||||||
|
/// [4.3.4.4. EXT-X-SESSION-DATA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.4
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXSessionData {
|
||||||
|
data_id: String,
|
||||||
|
data: SessionData,
|
||||||
|
language: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXSessionData {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-SESSION-DATA:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXSessionData` tag.
|
||||||
|
pub fn new<T: ToString>(data_id: T, data: SessionData) -> Self {
|
||||||
|
ExtXSessionData {
|
||||||
|
data_id: data_id.to_string(),
|
||||||
|
data,
|
||||||
|
language: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Makes a new `ExtXSessionData` with the given language.
|
||||||
|
pub fn with_language<T, L>(data_id: T, data: SessionData, language: L) -> Self
|
||||||
|
where
|
||||||
|
T: ToString,
|
||||||
|
L: ToString,
|
||||||
|
{
|
||||||
|
ExtXSessionData {
|
||||||
|
data_id: data_id.to_string(),
|
||||||
|
data,
|
||||||
|
language: Some(language.to_string()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the identifier of the data.
|
||||||
|
pub fn data_id(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.data_id)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the session data.
|
||||||
|
pub fn data(&self) -> &SessionData {
|
||||||
|
&self.data
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the language of the data.
|
||||||
|
pub fn language(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.language {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXSessionData {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
write!(f, "DATA-ID={}", quote(&self.data_id))?;
|
||||||
|
|
||||||
|
match &self.data {
|
||||||
|
SessionData::Value(value) => write!(f, ",VALUE={}", quote(&value))?,
|
||||||
|
SessionData::Uri(value) => write!(f, ",URI={}", quote(&value))?,
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.language {
|
||||||
|
write!(f, ",LANGUAGE={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXSessionData {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> crate::Result<Self> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut data_id = None;
|
||||||
|
let mut session_value = None;
|
||||||
|
let mut uri = None;
|
||||||
|
let mut language = None;
|
||||||
|
let attrs = (s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>()?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"DATA-ID" => data_id = Some(unquote(value)),
|
||||||
|
"VALUE" => session_value = Some(unquote(value)),
|
||||||
|
"URI" => uri = Some(unquote(value)),
|
||||||
|
"LANGUAGE" => language = Some(unquote(value)),
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let data_id = track_assert_some!(data_id, ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let data = if let Some(value) = session_value {
|
||||||
|
track_assert_eq!(uri, None, ErrorKind::InvalidInput);
|
||||||
|
SessionData::Value(value)
|
||||||
|
} else if let Some(uri) = uri {
|
||||||
|
SessionData::Uri(uri)
|
||||||
|
} else {
|
||||||
|
track_panic!(ErrorKind::InvalidInput);
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(ExtXSessionData {
|
||||||
|
data_id,
|
||||||
|
data,
|
||||||
|
language,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_session_data() {
|
||||||
|
let tag = ExtXSessionData::new("foo".to_string(), SessionData::Value("bar".to_string()));
|
||||||
|
|
||||||
|
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",VALUE="bar""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtXSessionData::new("foo".to_string(), SessionData::Uri("bar".to_string()));
|
||||||
|
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",URI="bar""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
|
let tag = ExtXSessionData::with_language(
|
||||||
|
"foo".to_string(),
|
||||||
|
SessionData::Value("bar".to_string()),
|
||||||
|
"baz".to_string(),
|
||||||
|
);
|
||||||
|
let text = r#"#EXT-X-SESSION-DATA:DATA-ID="foo",VALUE="bar",LANGUAGE="baz""#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
76
src/tags/session_key.rs
Normal file
76
src/tags/session_key.rs
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{DecryptionKey, ProtocolVersion};
|
||||||
|
|
||||||
|
/// [4.3.4.5. EXT-X-SESSION-KEY]
|
||||||
|
///
|
||||||
|
/// [4.3.4.5. EXT-X-SESSION-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.4.5
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXSessionKey(DecryptionKey);
|
||||||
|
|
||||||
|
impl ExtXSessionKey {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-SESSION-KEY:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXSessionKey` tag.
|
||||||
|
pub const fn new(key: DecryptionKey) -> Self {
|
||||||
|
Self(key)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a decryption key for the playlist.
|
||||||
|
pub const fn key(&self) -> Cow<'_, DecryptionKey> {
|
||||||
|
Cow::Borrowed(&self.0)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
|
self.0.required_version()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXSessionKey {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, &self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXSessionKey {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let suffix = s.split_at(Self::PREFIX.len()).1;
|
||||||
|
let key = track!(suffix.parse())?;
|
||||||
|
|
||||||
|
Ok(Self(key))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
use crate::types::{EncryptionMethod, InitializationVector};
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_session_key() {
|
||||||
|
let tag = ExtXSessionKey::new(DecryptionKey {
|
||||||
|
method: EncryptionMethod::Aes128,
|
||||||
|
uri: "foo".to_string(),
|
||||||
|
iv: Some(InitializationVector([
|
||||||
|
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
|
||||||
|
])),
|
||||||
|
key_format: None,
|
||||||
|
key_format_versions: None,
|
||||||
|
});
|
||||||
|
|
||||||
|
let text =
|
||||||
|
r#"#EXT-X-SESSION-KEY:METHOD=AES-128,URI="foo",IV=0x000102030405060708090a0b0c0d0e0f"#;
|
||||||
|
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V2);
|
||||||
|
}
|
||||||
|
}
|
|
@ -1,35 +1,10 @@
|
||||||
use super::parse_yes_or_no;
|
|
||||||
use crate::attribute::AttributePairs;
|
|
||||||
use crate::types::{ProtocolVersion, SignedDecimalFloatingPoint};
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
use std::fmt;
|
||||||
use std::str::FromStr;
|
use std::str::FromStr;
|
||||||
|
|
||||||
/// [4.3.5.1. EXT-X-INDEPENDENT-SEGMENTS]
|
use crate::attribute::AttributePairs;
|
||||||
///
|
use crate::types::{ProtocolVersion, SignedDecimalFloatingPoint};
|
||||||
/// [4.3.5.1. EXT-X-INDEPENDENT-SEGMENTS]: https://tools.ietf.org/html/rfc8216#section-4.3.5.1
|
use crate::utils::parse_yes_or_no;
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
use crate::{Error, ErrorKind};
|
||||||
pub struct ExtXIndependentSegments;
|
|
||||||
impl ExtXIndependentSegments {
|
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-INDEPENDENT-SEGMENTS";
|
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
|
||||||
pub fn requires_version(self) -> ProtocolVersion {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for ExtXIndependentSegments {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
Self::PREFIX.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ExtXIndependentSegments {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert_eq!(s, Self::PREFIX, ErrorKind::InvalidInput);
|
|
||||||
Ok(ExtXIndependentSegments)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [4.3.5.2. EXT-X-START]
|
/// [4.3.5.2. EXT-X-START]
|
||||||
///
|
///
|
||||||
|
@ -39,28 +14,29 @@ pub struct ExtXStart {
|
||||||
time_offset: SignedDecimalFloatingPoint,
|
time_offset: SignedDecimalFloatingPoint,
|
||||||
precise: bool,
|
precise: bool,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl ExtXStart {
|
impl ExtXStart {
|
||||||
pub(crate) const PREFIX: &'static str = "#EXT-X-START:";
|
pub(crate) const PREFIX: &'static str = "#EXT-X-START:";
|
||||||
|
|
||||||
/// Makes a new `ExtXStart` tag.
|
/// Makes a new `ExtXStart` tag.
|
||||||
pub fn new(time_offset: SignedDecimalFloatingPoint) -> Self {
|
pub fn new(time_offset: f64) -> crate::Result<Self> {
|
||||||
ExtXStart {
|
Ok(Self {
|
||||||
time_offset,
|
time_offset: SignedDecimalFloatingPoint::new(time_offset)?,
|
||||||
precise: false,
|
precise: false,
|
||||||
}
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Makes a new `ExtXStart` tag with the given `precise` flag.
|
/// Makes a new `ExtXStart` tag with the given `precise` flag.
|
||||||
pub fn with_precise(time_offset: SignedDecimalFloatingPoint, precise: bool) -> Self {
|
pub fn with_precise(time_offset: f64, precise: bool) -> crate::Result<Self> {
|
||||||
ExtXStart {
|
Ok(Self {
|
||||||
time_offset,
|
time_offset: SignedDecimalFloatingPoint::new(time_offset)?,
|
||||||
precise,
|
precise,
|
||||||
}
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Returns the time offset of the media segments in the playlist.
|
/// Returns the time offset of the media segments in the playlist.
|
||||||
pub fn time_offset(&self) -> SignedDecimalFloatingPoint {
|
pub fn time_offset(&self) -> f64 {
|
||||||
self.time_offset
|
self.time_offset.as_f64()
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Returns whether clients should not render media stream whose presentation times are
|
/// Returns whether clients should not render media stream whose presentation times are
|
||||||
|
@ -70,10 +46,11 @@ impl ExtXStart {
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Returns the protocol compatibility version that this tag requires.
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
pub fn requires_version(&self) -> ProtocolVersion {
|
pub fn required_version(&self) -> ProtocolVersion {
|
||||||
ProtocolVersion::V1
|
ProtocolVersion::V1
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl fmt::Display for ExtXStart {
|
impl fmt::Display for ExtXStart {
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
write!(f, "{}", Self::PREFIX)?;
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
@ -84,17 +61,18 @@ impl fmt::Display for ExtXStart {
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl FromStr for ExtXStart {
|
impl FromStr for ExtXStart {
|
||||||
type Err = Error;
|
type Err = Error;
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
let mut time_offset = None;
|
let mut time_offset = None;
|
||||||
let mut precise = false;
|
let mut precise = false;
|
||||||
let attrs = AttributePairs::parse(s.split_at(Self::PREFIX.len()).1);
|
let attrs = (s.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>()?;
|
||||||
for attr in attrs {
|
for (key, value) in attrs {
|
||||||
let (key, value) = track!(attr)?;
|
match key.as_str() {
|
||||||
match key {
|
|
||||||
"TIME-OFFSET" => time_offset = Some(track!(value.parse())?),
|
"TIME-OFFSET" => time_offset = Some(track!(value.parse())?),
|
||||||
"PRECISE" => precise = track!(parse_yes_or_no(value))?,
|
"PRECISE" => precise = track!(parse_yes_or_no(value))?,
|
||||||
_ => {
|
_ => {
|
||||||
|
@ -116,27 +94,18 @@ impl FromStr for ExtXStart {
|
||||||
mod test {
|
mod test {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn ext_x_independent_segments() {
|
|
||||||
let tag = ExtXIndependentSegments;
|
|
||||||
let text = "#EXT-X-INDEPENDENT-SEGMENTS";
|
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
|
||||||
assert_eq!(tag.to_string(), text);
|
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn ext_x_start() {
|
fn ext_x_start() {
|
||||||
let tag = ExtXStart::new(SignedDecimalFloatingPoint::new(-1.23).unwrap());
|
let tag = ExtXStart::new(-1.23).unwrap();
|
||||||
let text = "#EXT-X-START:TIME-OFFSET=-1.23";
|
let text = "#EXT-X-START:TIME-OFFSET=-1.23";
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
assert_eq!(tag.to_string(), text);
|
assert_eq!(tag.to_string(), text);
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
|
||||||
let tag = ExtXStart::with_precise(SignedDecimalFloatingPoint::new(1.23).unwrap(), true);
|
let tag = ExtXStart::with_precise(1.23, true).unwrap();
|
||||||
let text = "#EXT-X-START:TIME-OFFSET=1.23,PRECISE=YES";
|
let text = "#EXT-X-START:TIME-OFFSET=1.23,PRECISE=YES";
|
||||||
assert_eq!(text.parse().ok(), Some(tag));
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
assert_eq!(tag.to_string(), text);
|
assert_eq!(tag.to_string(), text);
|
||||||
assert_eq!(tag.requires_version(), ProtocolVersion::V1);
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
}
|
}
|
||||||
}
|
}
|
255
src/tags/stream_inf.rs
Normal file
255
src/tags/stream_inf.rs
Normal file
|
@ -0,0 +1,255 @@
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{
|
||||||
|
ClosedCaptions, DecimalFloatingPoint, DecimalResolution, HdcpLevel, ProtocolVersion,
|
||||||
|
};
|
||||||
|
use crate::utils::parse_u64;
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
|
||||||
|
/// [4.3.4.2. EXT-X-STREAM-INF]
|
||||||
|
///
|
||||||
|
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||||
|
pub struct ExtXStreamInf {
|
||||||
|
uri: String,
|
||||||
|
bandwidth: u64,
|
||||||
|
average_bandwidth: Option<u64>,
|
||||||
|
codecs: Option<String>,
|
||||||
|
resolution: Option<DecimalResolution>,
|
||||||
|
frame_rate: Option<DecimalFloatingPoint>,
|
||||||
|
hdcp_level: Option<HdcpLevel>,
|
||||||
|
audio: Option<String>,
|
||||||
|
video: Option<String>,
|
||||||
|
subtitles: Option<String>,
|
||||||
|
closed_captions: Option<ClosedCaptions>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExtXStreamInf {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-STREAM-INF:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXStreamInf` tag.
|
||||||
|
pub fn new(uri: String, bandwidth: u64) -> Self {
|
||||||
|
ExtXStreamInf {
|
||||||
|
uri,
|
||||||
|
bandwidth,
|
||||||
|
average_bandwidth: None,
|
||||||
|
codecs: None,
|
||||||
|
resolution: None,
|
||||||
|
frame_rate: None,
|
||||||
|
hdcp_level: None,
|
||||||
|
audio: None,
|
||||||
|
video: None,
|
||||||
|
subtitles: None,
|
||||||
|
closed_captions: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the URI that identifies the associated media playlist.
|
||||||
|
pub fn uri(&self) -> Cow<'_, str> {
|
||||||
|
Cow::Borrowed(&self.uri)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the peak segment bit rate of the variant stream.
|
||||||
|
pub fn bandwidth(&self) -> u64 {
|
||||||
|
self.bandwidth
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the average segment bit rate of the variant stream.
|
||||||
|
pub fn average_bandwidth(&self) -> Option<u64> {
|
||||||
|
self.average_bandwidth
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a string that represents the list of codec types contained by the stream variant.
|
||||||
|
pub fn codecs(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.codecs {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the optimal pixel resolution at which to display all the video in the variant
|
||||||
|
/// stream.
|
||||||
|
pub fn resolution(&self) -> Option<(usize, usize)> {
|
||||||
|
match self.resolution {
|
||||||
|
Some(value) => Some((value.width(), value.height())),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the maximum frame rate for all the video in the variant stream.
|
||||||
|
pub fn frame_rate(&self) -> Option<f64> {
|
||||||
|
match &self.frame_rate {
|
||||||
|
Some(value) => Some(value.as_f64()),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the HDCP level of the variant stream.
|
||||||
|
pub fn hdcp_level(&self) -> Option<HdcpLevel> {
|
||||||
|
self.hdcp_level
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the group identifier for the audio in the variant stream.
|
||||||
|
pub fn audio(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.audio {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the group identifier for the video in the variant stream.
|
||||||
|
pub fn video(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.video {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the group identifier for the subtitles in the variant stream.
|
||||||
|
pub fn subtitles(&self) -> Option<Cow<'_, str>> {
|
||||||
|
match &self.subtitles {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the value of `CLOSED-CAPTIONS` attribute.
|
||||||
|
pub fn closed_captions(&self) -> Option<Cow<'_, ClosedCaptions>> {
|
||||||
|
match &self.closed_captions {
|
||||||
|
Some(value) => Some(Cow::Borrowed(&value)),
|
||||||
|
None => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXStreamInf {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", Self::PREFIX)?;
|
||||||
|
write!(f, "BANDWIDTH={}", self.bandwidth)?;
|
||||||
|
|
||||||
|
if let Some(value) = &self.average_bandwidth {
|
||||||
|
write!(f, ",AVERAGE-BANDWIDTH={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.codecs {
|
||||||
|
write!(f, ",CODECS={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.resolution {
|
||||||
|
write!(f, ",RESOLUTION={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.frame_rate {
|
||||||
|
write!(f, ",FRAME-RATE={:.3}", value.as_f64())?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.hdcp_level {
|
||||||
|
write!(f, ",HDCP-LEVEL={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.audio {
|
||||||
|
write!(f, ",AUDIO={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.video {
|
||||||
|
write!(f, ",VIDEO={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.subtitles {
|
||||||
|
write!(f, ",SUBTITLES={}", quote(value))?;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(value) = &self.closed_captions {
|
||||||
|
write!(f, ",CLOSED-CAPTIONS={}", value)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
write!(f, "\n{}", self.uri)?;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXStreamInf {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
let mut lines = s.splitn(2, '\n');
|
||||||
|
let first_line = lines.next().expect("Never fails").trim_end_matches('\r');
|
||||||
|
let second_line = track_assert_some!(lines.next(), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
track_assert!(
|
||||||
|
first_line.starts_with(Self::PREFIX),
|
||||||
|
ErrorKind::InvalidInput
|
||||||
|
);
|
||||||
|
|
||||||
|
let uri = second_line.to_string();
|
||||||
|
let mut bandwidth = None;
|
||||||
|
let mut average_bandwidth = None;
|
||||||
|
let mut codecs = None;
|
||||||
|
let mut resolution = None;
|
||||||
|
let mut frame_rate = None;
|
||||||
|
let mut hdcp_level = None;
|
||||||
|
let mut audio = None;
|
||||||
|
let mut video = None;
|
||||||
|
let mut subtitles = None;
|
||||||
|
let mut closed_captions = None;
|
||||||
|
|
||||||
|
let attrs = track!((first_line.split_at(Self::PREFIX.len()).1).parse::<AttributePairs>())?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"BANDWIDTH" => bandwidth = Some(track!(parse_u64(value))?),
|
||||||
|
"AVERAGE-BANDWIDTH" => average_bandwidth = Some(track!(parse_u64(value))?),
|
||||||
|
"CODECS" => codecs = Some(unquote(value)),
|
||||||
|
"RESOLUTION" => resolution = Some(track!(value.parse())?),
|
||||||
|
"FRAME-RATE" => frame_rate = Some(track!(value.parse())?),
|
||||||
|
"HDCP-LEVEL" => hdcp_level = Some(track!(value.parse())?),
|
||||||
|
"AUDIO" => audio = Some(unquote(value)),
|
||||||
|
"VIDEO" => video = Some(unquote(value)),
|
||||||
|
"SUBTITLES" => subtitles = Some(unquote(value)),
|
||||||
|
"CLOSED-CAPTIONS" => closed_captions = Some(track!(value.parse())?),
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let bandwidth = track_assert_some!(bandwidth, ErrorKind::InvalidInput);
|
||||||
|
Ok(ExtXStreamInf {
|
||||||
|
uri,
|
||||||
|
bandwidth,
|
||||||
|
average_bandwidth,
|
||||||
|
codecs,
|
||||||
|
resolution,
|
||||||
|
frame_rate,
|
||||||
|
hdcp_level,
|
||||||
|
audio,
|
||||||
|
video,
|
||||||
|
subtitles,
|
||||||
|
closed_captions,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_stream_inf() {
|
||||||
|
let tag = ExtXStreamInf::new(String::from("foo"), 1000);
|
||||||
|
let text = "#EXT-X-STREAM-INF:BANDWIDTH=1000\nfoo";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag.clone()));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
67
src/tags/target_duration.rs
Normal file
67
src/tags/target_duration.rs
Normal file
|
@ -0,0 +1,67 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
|
||||||
|
/// [4.3.3.1. EXT-X-TARGETDURATION]
|
||||||
|
///
|
||||||
|
/// [4.3.3.1. EXT-X-TARGETDURATION]: https://tools.ietf.org/html/rfc8216#section-4.3.3.1
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXTargetDuration(Duration);
|
||||||
|
|
||||||
|
impl ExtXTargetDuration {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-TARGETDURATION:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXTargetduration` tag.
|
||||||
|
///
|
||||||
|
/// Note that the nanoseconds part of the `duration` will be discarded.
|
||||||
|
pub const fn new(duration: Duration) -> Self {
|
||||||
|
let duration = Duration::from_secs(duration.as_secs());
|
||||||
|
Self(duration)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the maximum media segment duration in the associated playlist.
|
||||||
|
pub const fn duration(&self) -> Duration {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXTargetDuration {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0.as_secs())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXTargetDuration {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let duration = may_invalid!(s.split_at(Self::PREFIX.len()).1.parse())?;
|
||||||
|
Ok(Self(Duration::from_secs(duration)))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn ext_x_targetduration() {
|
||||||
|
let tag = ExtXTargetDuration::new(Duration::from_secs(5));
|
||||||
|
let text = "#EXT-X-TARGETDURATION:5";
|
||||||
|
assert_eq!(text.parse().ok(), Some(tag));
|
||||||
|
assert_eq!(tag.to_string(), text);
|
||||||
|
assert_eq!(tag.required_version(), ProtocolVersion::V1);
|
||||||
|
}
|
||||||
|
}
|
88
src/tags/version.rs
Normal file
88
src/tags/version.rs
Normal file
|
@ -0,0 +1,88 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::types::ProtocolVersion;
|
||||||
|
use crate::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// [4.3.1.2. EXT-X-VERSION]
|
||||||
|
///
|
||||||
|
/// [4.3.1.2. EXT-X-VERSION]: https://tools.ietf.org/html/rfc8216#section-4.3.1.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ExtXVersion(ProtocolVersion);
|
||||||
|
|
||||||
|
impl ExtXVersion {
|
||||||
|
pub(crate) const PREFIX: &'static str = "#EXT-X-VERSION:";
|
||||||
|
|
||||||
|
/// Makes a new `ExtXVersion` tag.
|
||||||
|
pub const fn new(version: ProtocolVersion) -> Self {
|
||||||
|
Self(version)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version of the playlist containing this tag.
|
||||||
|
pub const fn version(&self) -> ProtocolVersion {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the protocol compatibility version that this tag requires.
|
||||||
|
pub const fn required_version(&self) -> ProtocolVersion {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ExtXVersion {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}{}", Self::PREFIX, self.0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ExtXVersion {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(s.starts_with(Self::PREFIX), ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let suffix = s.split_at(Self::PREFIX.len()).1;
|
||||||
|
let version = track!(suffix.parse())?;
|
||||||
|
Ok(Self(version))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser() {
|
||||||
|
assert_eq!(
|
||||||
|
"#EXT-X-VERSION:6".parse().ok(),
|
||||||
|
Some(ExtXVersion::new(ProtocolVersion::V6))
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser_err() {
|
||||||
|
assert!("#EXTX-X-VERSION:6".parse::<ExtXVersion>().is_err());
|
||||||
|
assert!("#EXT-X-VERSION:T".parse::<ExtXVersion>().is_err());
|
||||||
|
assert!("#EXT-X-VERSION:".parse::<ExtXVersion>().is_err());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_display() {
|
||||||
|
assert_eq!(
|
||||||
|
ExtXVersion::new(ProtocolVersion::V6).to_string(),
|
||||||
|
"#EXT-X-VERSION:6"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
ExtXVersion::new(ProtocolVersion::V4).to_string(),
|
||||||
|
"#EXT-X-VERSION:4"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_required_vesion() {
|
||||||
|
assert_eq!(
|
||||||
|
ExtXVersion::new(ProtocolVersion::V6).required_version(),
|
||||||
|
ProtocolVersion::V1
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
840
src/types.rs
840
src/types.rs
|
@ -1,840 +0,0 @@
|
||||||
//! Miscellaneous types.
|
|
||||||
use crate::attribute::AttributePairs;
|
|
||||||
use crate::{Error, ErrorKind, Result};
|
|
||||||
use std::fmt;
|
|
||||||
use std::ops::Deref;
|
|
||||||
use std::str::{self, FromStr};
|
|
||||||
use std::time::Duration;
|
|
||||||
use trackable::error::ErrorKindExt;
|
|
||||||
|
|
||||||
/// String that represents a single line in a playlist file.
|
|
||||||
///
|
|
||||||
/// See: [4.1. Definition of a Playlist]
|
|
||||||
///
|
|
||||||
/// [4.1. Definition of a Playlist]: https://tools.ietf.org/html/rfc8216#section-4.1
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
||||||
pub struct SingleLineString(String);
|
|
||||||
impl SingleLineString {
|
|
||||||
/// Makes a new `SingleLineString` instance.
|
|
||||||
///
|
|
||||||
/// # Errors
|
|
||||||
///
|
|
||||||
/// If the given string contains any control characters,
|
|
||||||
/// this function will return an error which has the kind `ErrorKind::InvalidInput`.
|
|
||||||
pub fn new<T: Into<String>>(s: T) -> Result<Self> {
|
|
||||||
let s = s.into();
|
|
||||||
track_assert!(!s.chars().any(|c| c.is_control()), ErrorKind::InvalidInput);
|
|
||||||
Ok(SingleLineString(s))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Deref for SingleLineString {
|
|
||||||
type Target = str;
|
|
||||||
fn deref(&self) -> &Self::Target {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl AsRef<str> for SingleLineString {
|
|
||||||
fn as_ref(&self) -> &str {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for SingleLineString {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
self.0.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Quoted string.
|
|
||||||
///
|
|
||||||
/// See: [4.2. Attribute Lists]
|
|
||||||
///
|
|
||||||
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
||||||
pub struct QuotedString(String);
|
|
||||||
impl QuotedString {
|
|
||||||
/// Makes a new `QuotedString` instance.
|
|
||||||
///
|
|
||||||
/// # Errors
|
|
||||||
///
|
|
||||||
/// If the given string contains any control characters or double-quote character,
|
|
||||||
/// this function will return an error which has the kind `ErrorKind::InvalidInput`.
|
|
||||||
pub fn new<T: Into<String>>(s: T) -> Result<Self> {
|
|
||||||
let s = s.into();
|
|
||||||
track_assert!(
|
|
||||||
!s.chars().any(|c| c.is_control() || c == '"'),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
Ok(QuotedString(s))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Deref for QuotedString {
|
|
||||||
type Target = str;
|
|
||||||
fn deref(&self) -> &Self::Target {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl AsRef<str> for QuotedString {
|
|
||||||
fn as_ref(&self) -> &str {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for QuotedString {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{:?}", self.0)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for QuotedString {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
let len = s.len();
|
|
||||||
let bytes = s.as_bytes();
|
|
||||||
track_assert!(len >= 2, ErrorKind::InvalidInput);
|
|
||||||
track_assert_eq!(bytes[0], b'"', ErrorKind::InvalidInput);
|
|
||||||
track_assert_eq!(bytes[len - 1], b'"', ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let s = unsafe { str::from_utf8_unchecked(&bytes[1..len - 1]) };
|
|
||||||
track!(QuotedString::new(s))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Decimal resolution.
|
|
||||||
///
|
|
||||||
/// See: [4.2. Attribute Lists]
|
|
||||||
///
|
|
||||||
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct DecimalResolution {
|
|
||||||
/// Horizontal pixel dimension.
|
|
||||||
pub width: usize,
|
|
||||||
|
|
||||||
/// Vertical pixel dimension.
|
|
||||||
pub height: usize,
|
|
||||||
}
|
|
||||||
impl fmt::Display for DecimalResolution {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}x{}", self.width, self.height)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for DecimalResolution {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
let mut tokens = s.splitn(2, 'x');
|
|
||||||
let width = tokens.next().expect("Never fails");
|
|
||||||
let height = track_assert_some!(tokens.next(), ErrorKind::InvalidInput);
|
|
||||||
Ok(DecimalResolution {
|
|
||||||
width: track!(width.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
|
||||||
height: track!(height.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Non-negative decimal floating-point number.
|
|
||||||
///
|
|
||||||
/// See: [4.2. Attribute Lists]
|
|
||||||
///
|
|
||||||
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd)]
|
|
||||||
pub struct DecimalFloatingPoint(f64);
|
|
||||||
impl DecimalFloatingPoint {
|
|
||||||
/// Makes a new `DecimalFloatingPoint` instance.
|
|
||||||
///
|
|
||||||
/// # Errors
|
|
||||||
///
|
|
||||||
/// The given value must have a positive sign and be finite,
|
|
||||||
/// otherwise this function will return an error that has the kind `ErrorKind::InvalidInput`.
|
|
||||||
pub fn new(n: f64) -> Result<Self> {
|
|
||||||
track_assert!(n.is_sign_positive(), ErrorKind::InvalidInput);
|
|
||||||
track_assert!(n.is_finite(), ErrorKind::InvalidInput);
|
|
||||||
Ok(DecimalFloatingPoint(n))
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Converts `DecimalFloatingPoint` to `f64`.
|
|
||||||
pub fn as_f64(self) -> f64 {
|
|
||||||
self.0
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn to_duration(self) -> Duration {
|
|
||||||
let secs = self.0 as u64;
|
|
||||||
let nanos = (self.0.fract() * 1_000_000_000.0) as u32;
|
|
||||||
Duration::new(secs, nanos)
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn from_duration(duration: Duration) -> Self {
|
|
||||||
let n =
|
|
||||||
(duration.as_secs() as f64) + (f64::from(duration.subsec_nanos()) / 1_000_000_000.0);
|
|
||||||
DecimalFloatingPoint(n)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl From<u32> for DecimalFloatingPoint {
|
|
||||||
fn from(f: u32) -> Self {
|
|
||||||
DecimalFloatingPoint(f64::from(f))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Eq for DecimalFloatingPoint {}
|
|
||||||
impl fmt::Display for DecimalFloatingPoint {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
self.0.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for DecimalFloatingPoint {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(
|
|
||||||
s.chars().all(|c| c.is_digit(10) || c == '.'),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
let n = track!(s.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
Ok(DecimalFloatingPoint(n))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Signed decimal floating-point number.
|
|
||||||
///
|
|
||||||
/// See: [4.2. Attribute Lists]
|
|
||||||
///
|
|
||||||
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd)]
|
|
||||||
pub struct SignedDecimalFloatingPoint(f64);
|
|
||||||
impl SignedDecimalFloatingPoint {
|
|
||||||
/// Makes a new `SignedDecimalFloatingPoint` instance.
|
|
||||||
///
|
|
||||||
/// # Errors
|
|
||||||
///
|
|
||||||
/// The given value must be finite,
|
|
||||||
/// otherwise this function will return an error that has the kind `ErrorKind::InvalidInput`.
|
|
||||||
pub fn new(n: f64) -> Result<Self> {
|
|
||||||
track_assert!(n.is_finite(), ErrorKind::InvalidInput);
|
|
||||||
Ok(SignedDecimalFloatingPoint(n))
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Converts `DecimalFloatingPoint` to `f64`.
|
|
||||||
pub fn as_f64(self) -> f64 {
|
|
||||||
self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl From<i32> for SignedDecimalFloatingPoint {
|
|
||||||
fn from(f: i32) -> Self {
|
|
||||||
SignedDecimalFloatingPoint(f64::from(f))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Eq for SignedDecimalFloatingPoint {}
|
|
||||||
impl fmt::Display for SignedDecimalFloatingPoint {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
self.0.fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for SignedDecimalFloatingPoint {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(
|
|
||||||
s.chars().all(|c| c.is_digit(10) || c == '.' || c == '-'),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
let n = track!(s.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
Ok(SignedDecimalFloatingPoint(n))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Hexadecimal sequence.
|
|
||||||
///
|
|
||||||
/// See: [4.2. Attribute Lists]
|
|
||||||
///
|
|
||||||
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
||||||
pub struct HexadecimalSequence(Vec<u8>);
|
|
||||||
impl HexadecimalSequence {
|
|
||||||
/// Makes a new `HexadecimalSequence` instance.
|
|
||||||
pub fn new<T: Into<Vec<u8>>>(v: T) -> Self {
|
|
||||||
HexadecimalSequence(v.into())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Converts into the underlying byte sequence.
|
|
||||||
pub fn into_bytes(self) -> Vec<u8> {
|
|
||||||
self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl Deref for HexadecimalSequence {
|
|
||||||
type Target = [u8];
|
|
||||||
fn deref(&self) -> &Self::Target {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl AsRef<[u8]> for HexadecimalSequence {
|
|
||||||
fn as_ref(&self) -> &[u8] {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for HexadecimalSequence {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "0x")?;
|
|
||||||
for b in &self.0 {
|
|
||||||
write!(f, "{:02x}", b)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for HexadecimalSequence {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(
|
|
||||||
s.starts_with("0x") || s.starts_with("0X"),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
track_assert!(s.len() % 2 == 0, ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut v = Vec::with_capacity(s.len() / 2 - 1);
|
|
||||||
for c in s.as_bytes().chunks(2).skip(1) {
|
|
||||||
let d = track!(str::from_utf8(c).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
let b =
|
|
||||||
track!(u8::from_str_radix(d, 16).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
v.push(b);
|
|
||||||
}
|
|
||||||
Ok(HexadecimalSequence(v))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Initialization vector.
|
|
||||||
///
|
|
||||||
/// See: [4.3.2.4. EXT-X-KEY]
|
|
||||||
///
|
|
||||||
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
||||||
pub struct InitializationVector(pub [u8; 16]);
|
|
||||||
impl Deref for InitializationVector {
|
|
||||||
type Target = [u8];
|
|
||||||
fn deref(&self) -> &Self::Target {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl AsRef<[u8]> for InitializationVector {
|
|
||||||
fn as_ref(&self) -> &[u8] {
|
|
||||||
&self.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for InitializationVector {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "0x")?;
|
|
||||||
for b in &self.0 {
|
|
||||||
write!(f, "{:02x}", b)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for InitializationVector {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
track_assert!(
|
|
||||||
s.starts_with("0x") || s.starts_with("0X"),
|
|
||||||
ErrorKind::InvalidInput
|
|
||||||
);
|
|
||||||
track_assert_eq!(s.len() - 2, 32, ErrorKind::InvalidInput);
|
|
||||||
|
|
||||||
let mut v = [0; 16];
|
|
||||||
for (i, c) in s.as_bytes().chunks(2).skip(1).enumerate() {
|
|
||||||
let d = track!(str::from_utf8(c).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
let b =
|
|
||||||
track!(u8::from_str_radix(d, 16).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
|
||||||
v[i] = b;
|
|
||||||
}
|
|
||||||
Ok(InitializationVector(v))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// [7. Protocol Version Compatibility]
|
|
||||||
///
|
|
||||||
/// [7. Protocol Version Compatibility]: https://tools.ietf.org/html/rfc8216#section-7
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
||||||
pub enum ProtocolVersion {
|
|
||||||
V1,
|
|
||||||
V2,
|
|
||||||
V3,
|
|
||||||
V4,
|
|
||||||
V5,
|
|
||||||
V6,
|
|
||||||
V7,
|
|
||||||
}
|
|
||||||
impl fmt::Display for ProtocolVersion {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
let n = match *self {
|
|
||||||
ProtocolVersion::V1 => 1,
|
|
||||||
ProtocolVersion::V2 => 2,
|
|
||||||
ProtocolVersion::V3 => 3,
|
|
||||||
ProtocolVersion::V4 => 4,
|
|
||||||
ProtocolVersion::V5 => 5,
|
|
||||||
ProtocolVersion::V6 => 6,
|
|
||||||
ProtocolVersion::V7 => 7,
|
|
||||||
};
|
|
||||||
write!(f, "{}", n)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ProtocolVersion {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
Ok(match s {
|
|
||||||
"1" => ProtocolVersion::V1,
|
|
||||||
"2" => ProtocolVersion::V2,
|
|
||||||
"3" => ProtocolVersion::V3,
|
|
||||||
"4" => ProtocolVersion::V4,
|
|
||||||
"5" => ProtocolVersion::V5,
|
|
||||||
"6" => ProtocolVersion::V6,
|
|
||||||
"7" => ProtocolVersion::V7,
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unknown protocol version: {:?}", s),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Byte range.
|
|
||||||
///
|
|
||||||
/// See: [4.3.2.2. EXT-X-BYTERANGE]
|
|
||||||
///
|
|
||||||
/// [4.3.2.2. EXT-X-BYTERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.2
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub struct ByteRange {
|
|
||||||
pub length: usize,
|
|
||||||
pub start: Option<usize>,
|
|
||||||
}
|
|
||||||
impl fmt::Display for ByteRange {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "{}", self.length)?;
|
|
||||||
if let Some(x) = self.start {
|
|
||||||
write!(f, "@{}", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ByteRange {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
let mut tokens = s.splitn(2, '@');
|
|
||||||
let length = tokens.next().expect("Never fails");
|
|
||||||
let start = if let Some(start) = tokens.next() {
|
|
||||||
Some(track!(start
|
|
||||||
.parse()
|
|
||||||
.map_err(|e| ErrorKind::InvalidInput.cause(e)))?)
|
|
||||||
} else {
|
|
||||||
None
|
|
||||||
};
|
|
||||||
Ok(ByteRange {
|
|
||||||
length: track!(length.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
|
||||||
start,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Decryption key.
|
|
||||||
///
|
|
||||||
/// See: [4.3.2.4. EXT-X-KEY]
|
|
||||||
///
|
|
||||||
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub struct DecryptionKey {
|
|
||||||
pub method: EncryptionMethod,
|
|
||||||
pub uri: QuotedString,
|
|
||||||
pub iv: Option<InitializationVector>,
|
|
||||||
pub key_format: Option<QuotedString>,
|
|
||||||
pub key_format_versions: Option<QuotedString>,
|
|
||||||
}
|
|
||||||
impl DecryptionKey {
|
|
||||||
pub(crate) fn requires_version(&self) -> ProtocolVersion {
|
|
||||||
if self.key_format.is_some() | self.key_format_versions.is_some() {
|
|
||||||
ProtocolVersion::V5
|
|
||||||
} else if self.iv.is_some() {
|
|
||||||
ProtocolVersion::V2
|
|
||||||
} else {
|
|
||||||
ProtocolVersion::V1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl fmt::Display for DecryptionKey {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
write!(f, "METHOD={}", self.method)?;
|
|
||||||
write!(f, ",URI={}", self.uri)?;
|
|
||||||
if let Some(ref x) = self.iv {
|
|
||||||
write!(f, ",IV={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.key_format {
|
|
||||||
write!(f, ",KEYFORMAT={}", x)?;
|
|
||||||
}
|
|
||||||
if let Some(ref x) = self.key_format_versions {
|
|
||||||
write!(f, ",KEYFORMATVERSIONS={}", x)?;
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for DecryptionKey {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
let mut method = None;
|
|
||||||
let mut uri = None;
|
|
||||||
let mut iv = None;
|
|
||||||
let mut key_format = None;
|
|
||||||
let mut key_format_versions = None;
|
|
||||||
let attrs = AttributePairs::parse(s);
|
|
||||||
for attr in attrs {
|
|
||||||
let (key, value) = track!(attr)?;
|
|
||||||
match key {
|
|
||||||
"METHOD" => method = Some(track!(value.parse())?),
|
|
||||||
"URI" => uri = Some(track!(value.parse())?),
|
|
||||||
"IV" => iv = Some(track!(value.parse())?),
|
|
||||||
"KEYFORMAT" => key_format = Some(track!(value.parse())?),
|
|
||||||
"KEYFORMATVERSIONS" => key_format_versions = Some(track!(value.parse())?),
|
|
||||||
_ => {
|
|
||||||
// [6.3.1. General Client Responsibilities]
|
|
||||||
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
let method = track_assert_some!(method, ErrorKind::InvalidInput);
|
|
||||||
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
|
||||||
Ok(DecryptionKey {
|
|
||||||
method,
|
|
||||||
uri,
|
|
||||||
iv,
|
|
||||||
key_format,
|
|
||||||
key_format_versions,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Encryption method.
|
|
||||||
///
|
|
||||||
/// See: [4.3.2.4. EXT-X-KEY]
|
|
||||||
///
|
|
||||||
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub enum EncryptionMethod {
|
|
||||||
Aes128,
|
|
||||||
SampleAes,
|
|
||||||
}
|
|
||||||
impl fmt::Display for EncryptionMethod {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
match *self {
|
|
||||||
EncryptionMethod::Aes128 => "AES-128".fmt(f),
|
|
||||||
EncryptionMethod::SampleAes => "SAMPLE-AES".fmt(f),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for EncryptionMethod {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
match s {
|
|
||||||
"AES-128" => Ok(EncryptionMethod::Aes128),
|
|
||||||
"SAMPLE-AES" => Ok(EncryptionMethod::SampleAes),
|
|
||||||
_ => track_panic!(
|
|
||||||
ErrorKind::InvalidInput,
|
|
||||||
"Unknown encryption method: {:?}",
|
|
||||||
s
|
|
||||||
),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Playlist type.
|
|
||||||
///
|
|
||||||
/// See: [4.3.3.5. EXT-X-PLAYLIST-TYPE]
|
|
||||||
///
|
|
||||||
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.5
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub enum PlaylistType {
|
|
||||||
Event,
|
|
||||||
Vod,
|
|
||||||
}
|
|
||||||
impl fmt::Display for PlaylistType {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
match *self {
|
|
||||||
PlaylistType::Event => write!(f, "EVENT"),
|
|
||||||
PlaylistType::Vod => write!(f, "VOD"),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for PlaylistType {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
match s {
|
|
||||||
"EVENT" => Ok(PlaylistType::Event),
|
|
||||||
"VOD" => Ok(PlaylistType::Vod),
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unknown playlist type: {:?}", s),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Media type.
|
|
||||||
///
|
|
||||||
/// See: [4.3.4.1. EXT-X-MEDIA]
|
|
||||||
///
|
|
||||||
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub enum MediaType {
|
|
||||||
Audio,
|
|
||||||
Video,
|
|
||||||
Subtitles,
|
|
||||||
ClosedCaptions,
|
|
||||||
}
|
|
||||||
impl fmt::Display for MediaType {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
match *self {
|
|
||||||
MediaType::Audio => "AUDIO".fmt(f),
|
|
||||||
MediaType::Video => "VIDEO".fmt(f),
|
|
||||||
MediaType::Subtitles => "SUBTITLES".fmt(f),
|
|
||||||
MediaType::ClosedCaptions => "CLOSED-CAPTIONS".fmt(f),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for MediaType {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
Ok(match s {
|
|
||||||
"AUDIO" => MediaType::Audio,
|
|
||||||
"VIDEO" => MediaType::Video,
|
|
||||||
"SUBTITLES" => MediaType::Subtitles,
|
|
||||||
"CLOSED-CAPTIONS" => MediaType::ClosedCaptions,
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unknown media type: {:?}", s),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Identifier of a rendition within the segments in a media playlist.
|
|
||||||
///
|
|
||||||
/// See: [4.3.4.1. EXT-X-MEDIA]
|
|
||||||
///
|
|
||||||
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub enum InStreamId {
|
|
||||||
Cc1,
|
|
||||||
Cc2,
|
|
||||||
Cc3,
|
|
||||||
Cc4,
|
|
||||||
Service1,
|
|
||||||
Service2,
|
|
||||||
Service3,
|
|
||||||
Service4,
|
|
||||||
Service5,
|
|
||||||
Service6,
|
|
||||||
Service7,
|
|
||||||
Service8,
|
|
||||||
Service9,
|
|
||||||
Service10,
|
|
||||||
Service11,
|
|
||||||
Service12,
|
|
||||||
Service13,
|
|
||||||
Service14,
|
|
||||||
Service15,
|
|
||||||
Service16,
|
|
||||||
Service17,
|
|
||||||
Service18,
|
|
||||||
Service19,
|
|
||||||
Service20,
|
|
||||||
Service21,
|
|
||||||
Service22,
|
|
||||||
Service23,
|
|
||||||
Service24,
|
|
||||||
Service25,
|
|
||||||
Service26,
|
|
||||||
Service27,
|
|
||||||
Service28,
|
|
||||||
Service29,
|
|
||||||
Service30,
|
|
||||||
Service31,
|
|
||||||
Service32,
|
|
||||||
Service33,
|
|
||||||
Service34,
|
|
||||||
Service35,
|
|
||||||
Service36,
|
|
||||||
Service37,
|
|
||||||
Service38,
|
|
||||||
Service39,
|
|
||||||
Service40,
|
|
||||||
Service41,
|
|
||||||
Service42,
|
|
||||||
Service43,
|
|
||||||
Service44,
|
|
||||||
Service45,
|
|
||||||
Service46,
|
|
||||||
Service47,
|
|
||||||
Service48,
|
|
||||||
Service49,
|
|
||||||
Service50,
|
|
||||||
Service51,
|
|
||||||
Service52,
|
|
||||||
Service53,
|
|
||||||
Service54,
|
|
||||||
Service55,
|
|
||||||
Service56,
|
|
||||||
Service57,
|
|
||||||
Service58,
|
|
||||||
Service59,
|
|
||||||
Service60,
|
|
||||||
Service61,
|
|
||||||
Service62,
|
|
||||||
Service63,
|
|
||||||
}
|
|
||||||
impl fmt::Display for InStreamId {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
format!("{:?}", self).to_uppercase().fmt(f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for InStreamId {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
Ok(match s {
|
|
||||||
"CC1" => InStreamId::Cc1,
|
|
||||||
"CC2" => InStreamId::Cc2,
|
|
||||||
"CC3" => InStreamId::Cc3,
|
|
||||||
"CC4" => InStreamId::Cc4,
|
|
||||||
"SERVICE1" => InStreamId::Service1,
|
|
||||||
"SERVICE2" => InStreamId::Service2,
|
|
||||||
"SERVICE3" => InStreamId::Service3,
|
|
||||||
"SERVICE4" => InStreamId::Service4,
|
|
||||||
"SERVICE5" => InStreamId::Service5,
|
|
||||||
"SERVICE6" => InStreamId::Service6,
|
|
||||||
"SERVICE7" => InStreamId::Service7,
|
|
||||||
"SERVICE8" => InStreamId::Service8,
|
|
||||||
"SERVICE9" => InStreamId::Service9,
|
|
||||||
"SERVICE10" => InStreamId::Service10,
|
|
||||||
"SERVICE11" => InStreamId::Service11,
|
|
||||||
"SERVICE12" => InStreamId::Service12,
|
|
||||||
"SERVICE13" => InStreamId::Service13,
|
|
||||||
"SERVICE14" => InStreamId::Service14,
|
|
||||||
"SERVICE15" => InStreamId::Service15,
|
|
||||||
"SERVICE16" => InStreamId::Service16,
|
|
||||||
"SERVICE17" => InStreamId::Service17,
|
|
||||||
"SERVICE18" => InStreamId::Service18,
|
|
||||||
"SERVICE19" => InStreamId::Service19,
|
|
||||||
"SERVICE20" => InStreamId::Service20,
|
|
||||||
"SERVICE21" => InStreamId::Service21,
|
|
||||||
"SERVICE22" => InStreamId::Service22,
|
|
||||||
"SERVICE23" => InStreamId::Service23,
|
|
||||||
"SERVICE24" => InStreamId::Service24,
|
|
||||||
"SERVICE25" => InStreamId::Service25,
|
|
||||||
"SERVICE26" => InStreamId::Service26,
|
|
||||||
"SERVICE27" => InStreamId::Service27,
|
|
||||||
"SERVICE28" => InStreamId::Service28,
|
|
||||||
"SERVICE29" => InStreamId::Service29,
|
|
||||||
"SERVICE30" => InStreamId::Service30,
|
|
||||||
"SERVICE31" => InStreamId::Service31,
|
|
||||||
"SERVICE32" => InStreamId::Service32,
|
|
||||||
"SERVICE33" => InStreamId::Service33,
|
|
||||||
"SERVICE34" => InStreamId::Service34,
|
|
||||||
"SERVICE35" => InStreamId::Service35,
|
|
||||||
"SERVICE36" => InStreamId::Service36,
|
|
||||||
"SERVICE37" => InStreamId::Service37,
|
|
||||||
"SERVICE38" => InStreamId::Service38,
|
|
||||||
"SERVICE39" => InStreamId::Service39,
|
|
||||||
"SERVICE40" => InStreamId::Service40,
|
|
||||||
"SERVICE41" => InStreamId::Service41,
|
|
||||||
"SERVICE42" => InStreamId::Service42,
|
|
||||||
"SERVICE43" => InStreamId::Service43,
|
|
||||||
"SERVICE44" => InStreamId::Service44,
|
|
||||||
"SERVICE45" => InStreamId::Service45,
|
|
||||||
"SERVICE46" => InStreamId::Service46,
|
|
||||||
"SERVICE47" => InStreamId::Service47,
|
|
||||||
"SERVICE48" => InStreamId::Service48,
|
|
||||||
"SERVICE49" => InStreamId::Service49,
|
|
||||||
"SERVICE50" => InStreamId::Service50,
|
|
||||||
"SERVICE51" => InStreamId::Service51,
|
|
||||||
"SERVICE52" => InStreamId::Service52,
|
|
||||||
"SERVICE53" => InStreamId::Service53,
|
|
||||||
"SERVICE54" => InStreamId::Service54,
|
|
||||||
"SERVICE55" => InStreamId::Service55,
|
|
||||||
"SERVICE56" => InStreamId::Service56,
|
|
||||||
"SERVICE57" => InStreamId::Service57,
|
|
||||||
"SERVICE58" => InStreamId::Service58,
|
|
||||||
"SERVICE59" => InStreamId::Service59,
|
|
||||||
"SERVICE60" => InStreamId::Service60,
|
|
||||||
"SERVICE61" => InStreamId::Service61,
|
|
||||||
"SERVICE62" => InStreamId::Service62,
|
|
||||||
"SERVICE63" => InStreamId::Service63,
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unknown instream id: {:?}", s),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// HDCP level.
|
|
||||||
///
|
|
||||||
/// See: [4.3.4.2. EXT-X-STREAM-INF]
|
|
||||||
///
|
|
||||||
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
||||||
pub enum HdcpLevel {
|
|
||||||
Type0,
|
|
||||||
None,
|
|
||||||
}
|
|
||||||
impl fmt::Display for HdcpLevel {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
match *self {
|
|
||||||
HdcpLevel::Type0 => "TYPE-0".fmt(f),
|
|
||||||
HdcpLevel::None => "NONE".fmt(f),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for HdcpLevel {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
match s {
|
|
||||||
"TYPE-0" => Ok(HdcpLevel::Type0),
|
|
||||||
"NONE" => Ok(HdcpLevel::None),
|
|
||||||
_ => track_panic!(ErrorKind::InvalidInput, "Unknown HDCP level: {:?}", s),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// The identifier of a closed captions group or its absence.
|
|
||||||
///
|
|
||||||
/// See: [4.3.4.2. EXT-X-STREAM-INF]
|
|
||||||
///
|
|
||||||
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub enum ClosedCaptions {
|
|
||||||
GroupId(QuotedString),
|
|
||||||
None,
|
|
||||||
}
|
|
||||||
impl fmt::Display for ClosedCaptions {
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
||||||
match *self {
|
|
||||||
ClosedCaptions::GroupId(ref x) => x.fmt(f),
|
|
||||||
ClosedCaptions::None => "NONE".fmt(f),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
impl FromStr for ClosedCaptions {
|
|
||||||
type Err = Error;
|
|
||||||
fn from_str(s: &str) -> Result<Self> {
|
|
||||||
if s == "NONE" {
|
|
||||||
Ok(ClosedCaptions::None)
|
|
||||||
} else {
|
|
||||||
Ok(ClosedCaptions::GroupId(track!(s.parse())?))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Session data.
|
|
||||||
///
|
|
||||||
/// See: [4.3.4.4. EXT-X-SESSION-DATA]
|
|
||||||
///
|
|
||||||
/// [4.3.4.4. EXT-X-SESSION-DATA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.4
|
|
||||||
#[allow(missing_docs)]
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
||||||
pub enum SessionData {
|
|
||||||
Value(QuotedString),
|
|
||||||
Uri(QuotedString),
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod test {
|
|
||||||
use super::*;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn single_line_string() {
|
|
||||||
assert!(SingleLineString::new("foo").is_ok());
|
|
||||||
assert!(SingleLineString::new("b\rar").is_err());
|
|
||||||
}
|
|
||||||
}
|
|
94
src/types/byte_range.rs
Normal file
94
src/types/byte_range.rs
Normal file
|
@ -0,0 +1,94 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// Byte range.
|
||||||
|
///
|
||||||
|
/// See: [4.3.2.2. EXT-X-BYTERANGE]
|
||||||
|
///
|
||||||
|
/// [4.3.2.2. EXT-X-BYTERANGE]: https://tools.ietf.org/html/rfc8216#section-4.3.2.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub struct ByteRange {
|
||||||
|
length: usize,
|
||||||
|
start: Option<usize>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ByteRange {
|
||||||
|
/// Create a new [ByteRange].
|
||||||
|
pub const fn new(length: usize, start: Option<usize>) -> Self {
|
||||||
|
Self { length, start }
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the length of the [ByteRange].
|
||||||
|
pub const fn length(&self) -> usize {
|
||||||
|
self.length
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the start of the [ByteRange], if there is any.
|
||||||
|
pub const fn start(&self) -> Option<usize> {
|
||||||
|
self.start
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ByteRange {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}", self.length)?;
|
||||||
|
if let Some(x) = self.start {
|
||||||
|
write!(f, "@{}", x)?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ByteRange {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
let mut tokens = s.splitn(2, '@');
|
||||||
|
let length = tokens.next().ok_or(ErrorKind::InvalidInput)?;
|
||||||
|
|
||||||
|
let start = if let Some(start) = tokens.next() {
|
||||||
|
Some(track!(start
|
||||||
|
.parse()
|
||||||
|
.map_err(|e| ErrorKind::InvalidInput.cause(e)))?)
|
||||||
|
} else {
|
||||||
|
None
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(ByteRange {
|
||||||
|
length: track!(length.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
||||||
|
start,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_display() {
|
||||||
|
assert_eq!(ByteRange::new(5, Some(20)).to_string(), "5@20");
|
||||||
|
assert_eq!(ByteRange::new(5, None).to_string(), "5");
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser() {
|
||||||
|
assert_eq!("45".parse::<ByteRange>().unwrap(), ByteRange::new(45, None));
|
||||||
|
assert_eq!(
|
||||||
|
"108@16".parse::<ByteRange>().unwrap(),
|
||||||
|
ByteRange::new(108, Some(16))
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parser_err() {
|
||||||
|
assert!("45E".parse::<ByteRange>().is_err());
|
||||||
|
assert!("45E@1".parse::<ByteRange>().is_err());
|
||||||
|
assert!("45E@23E".parse::<ByteRange>().is_err());
|
||||||
|
assert!("45@23E".parse::<ByteRange>().is_err());
|
||||||
|
}
|
||||||
|
}
|
38
src/types/closed_captions.rs
Normal file
38
src/types/closed_captions.rs
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::Error;
|
||||||
|
use crate::utils::unquote;
|
||||||
|
|
||||||
|
/// The identifier of a closed captions group or its absence.
|
||||||
|
///
|
||||||
|
/// See: [4.3.4.2. EXT-X-STREAM-INF]
|
||||||
|
///
|
||||||
|
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub enum ClosedCaptions {
|
||||||
|
GroupId(String),
|
||||||
|
None,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ClosedCaptions {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
match *self {
|
||||||
|
ClosedCaptions::GroupId(ref x) => x.fmt(f),
|
||||||
|
ClosedCaptions::None => "NONE".fmt(f),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ClosedCaptions {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
if s == "NONE" {
|
||||||
|
Ok(ClosedCaptions::None)
|
||||||
|
} else {
|
||||||
|
Ok(ClosedCaptions::GroupId(unquote(s)))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
73
src/types/decimal_floating_point.rs
Normal file
73
src/types/decimal_floating_point.rs
Normal file
|
@ -0,0 +1,73 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::trackable::error::ErrorKindExt as _;
|
||||||
|
|
||||||
|
/// Non-negative decimal floating-point number.
|
||||||
|
///
|
||||||
|
/// See: [4.2. Attribute Lists]
|
||||||
|
///
|
||||||
|
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd)]
|
||||||
|
pub(crate) struct DecimalFloatingPoint(f64);
|
||||||
|
|
||||||
|
#[allow(dead_code)]
|
||||||
|
impl DecimalFloatingPoint {
|
||||||
|
/// Makes a new `DecimalFloatingPoint` instance.
|
||||||
|
///
|
||||||
|
/// # Errors
|
||||||
|
///
|
||||||
|
/// The given value must have a positive sign and be finite,
|
||||||
|
/// otherwise this function will return an error that has the kind `ErrorKind::InvalidInput`.
|
||||||
|
pub fn new(n: f64) -> crate::Result<Self> {
|
||||||
|
track_assert!(n.is_sign_positive(), ErrorKind::InvalidInput);
|
||||||
|
track_assert!(n.is_finite(), ErrorKind::InvalidInput);
|
||||||
|
Ok(DecimalFloatingPoint(n))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts `DecimalFloatingPoint` to `f64`.
|
||||||
|
pub fn as_f64(self) -> f64 {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO: this should be default? Duration > DecimalFloatingPoint
|
||||||
|
pub(crate) fn to_duration(self) -> Duration {
|
||||||
|
let secs = self.0 as u64;
|
||||||
|
let nanos = (self.0.fract() * 1_000_000_000.0) as u32;
|
||||||
|
Duration::new(secs, nanos)
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn from_duration(duration: Duration) -> Self {
|
||||||
|
let n =
|
||||||
|
(duration.as_secs() as f64) + (f64::from(duration.subsec_nanos()) / 1_000_000_000.0);
|
||||||
|
DecimalFloatingPoint(n)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<u32> for DecimalFloatingPoint {
|
||||||
|
fn from(f: u32) -> Self {
|
||||||
|
DecimalFloatingPoint(f64::from(f))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Eq for DecimalFloatingPoint {}
|
||||||
|
|
||||||
|
impl fmt::Display for DecimalFloatingPoint {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
self.0.fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for DecimalFloatingPoint {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(
|
||||||
|
s.chars().all(|c| c.is_digit(10) || c == '.'),
|
||||||
|
ErrorKind::InvalidInput
|
||||||
|
);
|
||||||
|
let n = track!(s.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
Ok(DecimalFloatingPoint(n))
|
||||||
|
}
|
||||||
|
}
|
48
src/types/decimal_resolution.rs
Normal file
48
src/types/decimal_resolution.rs
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::trackable::error::ErrorKindExt as _;
|
||||||
|
|
||||||
|
/// Decimal resolution.
|
||||||
|
///
|
||||||
|
/// See: [4.2. Attribute Lists]
|
||||||
|
///
|
||||||
|
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub(crate) struct DecimalResolution {
|
||||||
|
width: usize,
|
||||||
|
height: usize,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl DecimalResolution {
|
||||||
|
/// Horizontal pixel dimension.
|
||||||
|
pub fn width(&self) -> usize {
|
||||||
|
self.width
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Vertical pixel dimension.
|
||||||
|
pub fn height(&self) -> usize {
|
||||||
|
self.height
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for DecimalResolution {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "{}x{}", self.width, self.height)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for DecimalResolution {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
let mut tokens = s.splitn(2, 'x');
|
||||||
|
let width = tokens.next().expect("Never fails");
|
||||||
|
let height = track_assert_some!(tokens.next(), ErrorKind::InvalidInput);
|
||||||
|
Ok(DecimalResolution {
|
||||||
|
width: track!(width.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
||||||
|
height: track!(height.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
90
src/types/decryption_key.rs
Normal file
90
src/types/decryption_key.rs
Normal file
|
@ -0,0 +1,90 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::attribute::AttributePairs;
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::types::{EncryptionMethod, InitializationVector, ProtocolVersion};
|
||||||
|
use crate::utils::{quote, unquote};
|
||||||
|
|
||||||
|
/// Decryption key.
|
||||||
|
///
|
||||||
|
/// See: [4.3.2.4. EXT-X-KEY]
|
||||||
|
///
|
||||||
|
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub struct DecryptionKey {
|
||||||
|
pub method: EncryptionMethod,
|
||||||
|
pub uri: String,
|
||||||
|
pub iv: Option<InitializationVector>,
|
||||||
|
pub key_format: Option<String>,
|
||||||
|
pub key_format_versions: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl DecryptionKey {
|
||||||
|
pub(crate) fn required_version(&self) -> ProtocolVersion {
|
||||||
|
if self.key_format.is_some() | self.key_format_versions.is_some() {
|
||||||
|
ProtocolVersion::V5
|
||||||
|
} else if self.iv.is_some() {
|
||||||
|
ProtocolVersion::V2
|
||||||
|
} else {
|
||||||
|
ProtocolVersion::V1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for DecryptionKey {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "METHOD={}", self.method)?;
|
||||||
|
write!(f, ",URI={}", quote(&self.uri))?;
|
||||||
|
if let Some(value) = &self.iv {
|
||||||
|
write!(f, ",IV={}", value)?;
|
||||||
|
}
|
||||||
|
if let Some(value) = &self.key_format {
|
||||||
|
write!(f, ",KEYFORMAT={}", quote(value))?;
|
||||||
|
}
|
||||||
|
if let Some(value) = &self.key_format_versions {
|
||||||
|
write!(f, ",KEYFORMATVERSIONS={}", value)?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for DecryptionKey {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
let mut method = None;
|
||||||
|
let mut uri = None;
|
||||||
|
let mut iv = None;
|
||||||
|
let mut key_format = None;
|
||||||
|
let mut key_format_versions = None;
|
||||||
|
|
||||||
|
let attrs = track!(s.parse::<AttributePairs>())?;
|
||||||
|
|
||||||
|
for (key, value) in attrs {
|
||||||
|
match key.as_str() {
|
||||||
|
"METHOD" => method = Some(track!(value.parse())?),
|
||||||
|
"URI" => uri = Some(unquote(value)),
|
||||||
|
"IV" => iv = Some(track!(value.parse())?),
|
||||||
|
"KEYFORMAT" => key_format = Some(unquote(value)),
|
||||||
|
"KEYFORMATVERSIONS" => key_format_versions = Some(unquote(value)),
|
||||||
|
_ => {
|
||||||
|
// [6.3.1. General Client Responsibilities]
|
||||||
|
// > ignore any attribute/value pair with an unrecognized AttributeName.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let method = track_assert_some!(method, ErrorKind::InvalidInput);
|
||||||
|
let uri = track_assert_some!(uri, ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
Ok(DecryptionKey {
|
||||||
|
method,
|
||||||
|
uri,
|
||||||
|
iv,
|
||||||
|
key_format,
|
||||||
|
key_format_versions,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
38
src/types/encryption_method.rs
Normal file
38
src/types/encryption_method.rs
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
/// Encryption method.
|
||||||
|
///
|
||||||
|
/// See: [4.3.2.4. EXT-X-KEY]
|
||||||
|
///
|
||||||
|
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub enum EncryptionMethod {
|
||||||
|
Aes128,
|
||||||
|
SampleAes,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for EncryptionMethod {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
match *self {
|
||||||
|
EncryptionMethod::Aes128 => "AES-128".fmt(f),
|
||||||
|
EncryptionMethod::SampleAes => "SAMPLE-AES".fmt(f),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for EncryptionMethod {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
match s {
|
||||||
|
"AES-128" => Ok(EncryptionMethod::Aes128),
|
||||||
|
"SAMPLE-AES" => Ok(EncryptionMethod::SampleAes),
|
||||||
|
_ => track_panic!(
|
||||||
|
ErrorKind::InvalidInput,
|
||||||
|
"Unknown encryption method: {:?}",
|
||||||
|
s
|
||||||
|
),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
35
src/types/hdcp_level.rs
Normal file
35
src/types/hdcp_level.rs
Normal file
|
@ -0,0 +1,35 @@
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
/// HDCP level.
|
||||||
|
///
|
||||||
|
/// See: [4.3.4.2. EXT-X-STREAM-INF]
|
||||||
|
///
|
||||||
|
/// [4.3.4.2. EXT-X-STREAM-INF]: https://tools.ietf.org/html/rfc8216#section-4.3.4.2
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub enum HdcpLevel {
|
||||||
|
Type0,
|
||||||
|
None,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for HdcpLevel {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
match *self {
|
||||||
|
HdcpLevel::Type0 => "TYPE-0".fmt(f),
|
||||||
|
HdcpLevel::None => "NONE".fmt(f),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for HdcpLevel {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
match s {
|
||||||
|
"TYPE-0" => Ok(HdcpLevel::Type0),
|
||||||
|
"NONE" => Ok(HdcpLevel::None),
|
||||||
|
_ => track_panic!(ErrorKind::InvalidInput, "Unknown HDCP level: {:?}", s),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
70
src/types/hex_sequence.rs
Normal file
70
src/types/hex_sequence.rs
Normal file
|
@ -0,0 +1,70 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::ops::Deref;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::trackable::error::ErrorKindExt as _;
|
||||||
|
|
||||||
|
/// Hexadecimal sequence.
|
||||||
|
///
|
||||||
|
/// See: [4.2. Attribute Lists]
|
||||||
|
///
|
||||||
|
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
||||||
|
pub(crate) struct HexadecimalSequence(Vec<u8>); // TODO?
|
||||||
|
|
||||||
|
impl HexadecimalSequence {
|
||||||
|
/// Makes a new `HexadecimalSequence` instance.
|
||||||
|
pub fn new<T: Into<Vec<u8>>>(v: T) -> Self {
|
||||||
|
HexadecimalSequence(v.into())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts into the underlying byte sequence.
|
||||||
|
pub fn into_bytes(self) -> Vec<u8> {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Deref for HexadecimalSequence {
|
||||||
|
type Target = [u8];
|
||||||
|
fn deref(&self) -> &Self::Target {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AsRef<[u8]> for HexadecimalSequence {
|
||||||
|
fn as_ref(&self) -> &[u8] {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for HexadecimalSequence {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "0x")?;
|
||||||
|
for b in &self.0 {
|
||||||
|
write!(f, "{:02x}", b)?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for HexadecimalSequence {
|
||||||
|
type Err = Error;
|
||||||
|
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(
|
||||||
|
s.starts_with("0x") || s.starts_with("0X"),
|
||||||
|
ErrorKind::InvalidInput
|
||||||
|
);
|
||||||
|
track_assert!(s.len() % 2 == 0, ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut v = Vec::with_capacity(s.len() / 2 - 1);
|
||||||
|
for c in s.as_bytes().chunks(2).skip(1) {
|
||||||
|
let d = track!(std::str::from_utf8(c).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
let b =
|
||||||
|
track!(u8::from_str_radix(d, 16).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
v.push(b);
|
||||||
|
}
|
||||||
|
Ok(HexadecimalSequence(v))
|
||||||
|
}
|
||||||
|
}
|
163
src/types/instream_id.rs
Normal file
163
src/types/instream_id.rs
Normal file
|
@ -0,0 +1,163 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// Identifier of a rendition within the segments in a media playlist.
|
||||||
|
///
|
||||||
|
/// See: [4.3.4.1. EXT-X-MEDIA]
|
||||||
|
///
|
||||||
|
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub enum InStreamId {
|
||||||
|
Cc1,
|
||||||
|
Cc2,
|
||||||
|
Cc3,
|
||||||
|
Cc4,
|
||||||
|
Service1,
|
||||||
|
Service2,
|
||||||
|
Service3,
|
||||||
|
Service4,
|
||||||
|
Service5,
|
||||||
|
Service6,
|
||||||
|
Service7,
|
||||||
|
Service8,
|
||||||
|
Service9,
|
||||||
|
Service10,
|
||||||
|
Service11,
|
||||||
|
Service12,
|
||||||
|
Service13,
|
||||||
|
Service14,
|
||||||
|
Service15,
|
||||||
|
Service16,
|
||||||
|
Service17,
|
||||||
|
Service18,
|
||||||
|
Service19,
|
||||||
|
Service20,
|
||||||
|
Service21,
|
||||||
|
Service22,
|
||||||
|
Service23,
|
||||||
|
Service24,
|
||||||
|
Service25,
|
||||||
|
Service26,
|
||||||
|
Service27,
|
||||||
|
Service28,
|
||||||
|
Service29,
|
||||||
|
Service30,
|
||||||
|
Service31,
|
||||||
|
Service32,
|
||||||
|
Service33,
|
||||||
|
Service34,
|
||||||
|
Service35,
|
||||||
|
Service36,
|
||||||
|
Service37,
|
||||||
|
Service38,
|
||||||
|
Service39,
|
||||||
|
Service40,
|
||||||
|
Service41,
|
||||||
|
Service42,
|
||||||
|
Service43,
|
||||||
|
Service44,
|
||||||
|
Service45,
|
||||||
|
Service46,
|
||||||
|
Service47,
|
||||||
|
Service48,
|
||||||
|
Service49,
|
||||||
|
Service50,
|
||||||
|
Service51,
|
||||||
|
Service52,
|
||||||
|
Service53,
|
||||||
|
Service54,
|
||||||
|
Service55,
|
||||||
|
Service56,
|
||||||
|
Service57,
|
||||||
|
Service58,
|
||||||
|
Service59,
|
||||||
|
Service60,
|
||||||
|
Service61,
|
||||||
|
Service62,
|
||||||
|
Service63,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for InStreamId {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
format!("{:?}", self).to_uppercase().fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for InStreamId {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
Ok(match s {
|
||||||
|
"CC1" => InStreamId::Cc1,
|
||||||
|
"CC2" => InStreamId::Cc2,
|
||||||
|
"CC3" => InStreamId::Cc3,
|
||||||
|
"CC4" => InStreamId::Cc4,
|
||||||
|
"SERVICE1" => InStreamId::Service1,
|
||||||
|
"SERVICE2" => InStreamId::Service2,
|
||||||
|
"SERVICE3" => InStreamId::Service3,
|
||||||
|
"SERVICE4" => InStreamId::Service4,
|
||||||
|
"SERVICE5" => InStreamId::Service5,
|
||||||
|
"SERVICE6" => InStreamId::Service6,
|
||||||
|
"SERVICE7" => InStreamId::Service7,
|
||||||
|
"SERVICE8" => InStreamId::Service8,
|
||||||
|
"SERVICE9" => InStreamId::Service9,
|
||||||
|
"SERVICE10" => InStreamId::Service10,
|
||||||
|
"SERVICE11" => InStreamId::Service11,
|
||||||
|
"SERVICE12" => InStreamId::Service12,
|
||||||
|
"SERVICE13" => InStreamId::Service13,
|
||||||
|
"SERVICE14" => InStreamId::Service14,
|
||||||
|
"SERVICE15" => InStreamId::Service15,
|
||||||
|
"SERVICE16" => InStreamId::Service16,
|
||||||
|
"SERVICE17" => InStreamId::Service17,
|
||||||
|
"SERVICE18" => InStreamId::Service18,
|
||||||
|
"SERVICE19" => InStreamId::Service19,
|
||||||
|
"SERVICE20" => InStreamId::Service20,
|
||||||
|
"SERVICE21" => InStreamId::Service21,
|
||||||
|
"SERVICE22" => InStreamId::Service22,
|
||||||
|
"SERVICE23" => InStreamId::Service23,
|
||||||
|
"SERVICE24" => InStreamId::Service24,
|
||||||
|
"SERVICE25" => InStreamId::Service25,
|
||||||
|
"SERVICE26" => InStreamId::Service26,
|
||||||
|
"SERVICE27" => InStreamId::Service27,
|
||||||
|
"SERVICE28" => InStreamId::Service28,
|
||||||
|
"SERVICE29" => InStreamId::Service29,
|
||||||
|
"SERVICE30" => InStreamId::Service30,
|
||||||
|
"SERVICE31" => InStreamId::Service31,
|
||||||
|
"SERVICE32" => InStreamId::Service32,
|
||||||
|
"SERVICE33" => InStreamId::Service33,
|
||||||
|
"SERVICE34" => InStreamId::Service34,
|
||||||
|
"SERVICE35" => InStreamId::Service35,
|
||||||
|
"SERVICE36" => InStreamId::Service36,
|
||||||
|
"SERVICE37" => InStreamId::Service37,
|
||||||
|
"SERVICE38" => InStreamId::Service38,
|
||||||
|
"SERVICE39" => InStreamId::Service39,
|
||||||
|
"SERVICE40" => InStreamId::Service40,
|
||||||
|
"SERVICE41" => InStreamId::Service41,
|
||||||
|
"SERVICE42" => InStreamId::Service42,
|
||||||
|
"SERVICE43" => InStreamId::Service43,
|
||||||
|
"SERVICE44" => InStreamId::Service44,
|
||||||
|
"SERVICE45" => InStreamId::Service45,
|
||||||
|
"SERVICE46" => InStreamId::Service46,
|
||||||
|
"SERVICE47" => InStreamId::Service47,
|
||||||
|
"SERVICE48" => InStreamId::Service48,
|
||||||
|
"SERVICE49" => InStreamId::Service49,
|
||||||
|
"SERVICE50" => InStreamId::Service50,
|
||||||
|
"SERVICE51" => InStreamId::Service51,
|
||||||
|
"SERVICE52" => InStreamId::Service52,
|
||||||
|
"SERVICE53" => InStreamId::Service53,
|
||||||
|
"SERVICE54" => InStreamId::Service54,
|
||||||
|
"SERVICE55" => InStreamId::Service55,
|
||||||
|
"SERVICE56" => InStreamId::Service56,
|
||||||
|
"SERVICE57" => InStreamId::Service57,
|
||||||
|
"SERVICE58" => InStreamId::Service58,
|
||||||
|
"SERVICE59" => InStreamId::Service59,
|
||||||
|
"SERVICE60" => InStreamId::Service60,
|
||||||
|
"SERVICE61" => InStreamId::Service61,
|
||||||
|
"SERVICE62" => InStreamId::Service62,
|
||||||
|
"SERVICE63" => InStreamId::Service63,
|
||||||
|
_ => track_panic!(ErrorKind::InvalidInput, "Unknown instream id: {:?}", s),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
57
src/types/iv.rs
Normal file
57
src/types/iv.rs
Normal file
|
@ -0,0 +1,57 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::ops::Deref;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::trackable::error::ErrorKindExt as _;
|
||||||
|
|
||||||
|
/// Initialization vector.
|
||||||
|
///
|
||||||
|
/// See: [4.3.2.4. EXT-X-KEY]
|
||||||
|
///
|
||||||
|
/// [4.3.2.4. EXT-X-KEY]: https://tools.ietf.org/html/rfc8216#section-4.3.2.4
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
||||||
|
pub struct InitializationVector(pub [u8; 16]); // TODO!
|
||||||
|
|
||||||
|
impl Deref for InitializationVector {
|
||||||
|
type Target = [u8];
|
||||||
|
fn deref(&self) -> &Self::Target {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AsRef<[u8]> for InitializationVector {
|
||||||
|
fn as_ref(&self) -> &[u8] {
|
||||||
|
&self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for InitializationVector {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
write!(f, "0x")?;
|
||||||
|
for b in &self.0 {
|
||||||
|
write!(f, "{:02x}", b)?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for InitializationVector {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(
|
||||||
|
s.starts_with("0x") || s.starts_with("0X"),
|
||||||
|
ErrorKind::InvalidInput
|
||||||
|
);
|
||||||
|
track_assert_eq!(s.len() - 2, 32, ErrorKind::InvalidInput);
|
||||||
|
|
||||||
|
let mut v = [0; 16];
|
||||||
|
for (i, c) in s.as_bytes().chunks(2).skip(1).enumerate() {
|
||||||
|
let d = track!(std::str::from_utf8(c).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
let b =
|
||||||
|
track!(u8::from_str_radix(d, 16).map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
v[i] = b;
|
||||||
|
}
|
||||||
|
Ok(InitializationVector(v))
|
||||||
|
}
|
||||||
|
}
|
42
src/types/media_type.rs
Normal file
42
src/types/media_type.rs
Normal file
|
@ -0,0 +1,42 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// Media type.
|
||||||
|
///
|
||||||
|
/// See: [4.3.4.1. EXT-X-MEDIA]
|
||||||
|
///
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
/// [4.3.4.1. EXT-X-MEDIA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.1
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub enum MediaType {
|
||||||
|
Audio,
|
||||||
|
Video,
|
||||||
|
Subtitles,
|
||||||
|
ClosedCaptions,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for MediaType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
match *self {
|
||||||
|
MediaType::Audio => "AUDIO".fmt(f),
|
||||||
|
MediaType::Video => "VIDEO".fmt(f),
|
||||||
|
MediaType::Subtitles => "SUBTITLES".fmt(f),
|
||||||
|
MediaType::ClosedCaptions => "CLOSED-CAPTIONS".fmt(f),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for MediaType {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
Ok(match s {
|
||||||
|
"AUDIO" => MediaType::Audio,
|
||||||
|
"VIDEO" => MediaType::Video,
|
||||||
|
"SUBTITLES" => MediaType::Subtitles,
|
||||||
|
"CLOSED-CAPTIONS" => MediaType::ClosedCaptions,
|
||||||
|
_ => track_panic!(ErrorKind::InvalidInput, "Unknown media type: {:?}", s),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
31
src/types/mod.rs
Normal file
31
src/types/mod.rs
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
mod byte_range;
|
||||||
|
mod closed_captions;
|
||||||
|
mod decimal_floating_point;
|
||||||
|
mod decimal_resolution;
|
||||||
|
mod decryption_key;
|
||||||
|
mod encryption_method;
|
||||||
|
mod hdcp_level;
|
||||||
|
mod hex_sequence;
|
||||||
|
mod instream_id;
|
||||||
|
mod iv;
|
||||||
|
mod media_type;
|
||||||
|
mod playlist_type;
|
||||||
|
mod protocol_version;
|
||||||
|
mod session_data;
|
||||||
|
mod signed_decimal_floating_point;
|
||||||
|
|
||||||
|
pub use byte_range::*;
|
||||||
|
pub use closed_captions::*;
|
||||||
|
pub(crate) use decimal_floating_point::*;
|
||||||
|
pub(crate) use decimal_resolution::*;
|
||||||
|
pub use decryption_key::*;
|
||||||
|
pub use encryption_method::*;
|
||||||
|
pub use hdcp_level::*;
|
||||||
|
pub(crate) use hex_sequence::*;
|
||||||
|
pub use instream_id::*;
|
||||||
|
pub use iv::*;
|
||||||
|
pub use media_type::*;
|
||||||
|
pub use playlist_type::*;
|
||||||
|
pub use protocol_version::*;
|
||||||
|
pub use session_data::*;
|
||||||
|
pub(crate) use signed_decimal_floating_point::*;
|
37
src/types/playlist_type.rs
Normal file
37
src/types/playlist_type.rs
Normal file
|
@ -0,0 +1,37 @@
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
|
||||||
|
/// Playlist type.
|
||||||
|
///
|
||||||
|
/// See: [4.3.3.5. EXT-X-PLAYLIST-TYPE]
|
||||||
|
///
|
||||||
|
/// [4.3.3.5. EXT-X-PLAYLIST-TYPE]: https://tools.ietf.org/html/rfc8216#section-4.3.3.5
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||||
|
pub enum PlaylistType {
|
||||||
|
// TODO: derive FromStr and Display for enums, like in Crunchyroll crate
|
||||||
|
Event,
|
||||||
|
Vod,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for PlaylistType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
match *self {
|
||||||
|
PlaylistType::Event => write!(f, "EVENT"),
|
||||||
|
PlaylistType::Vod => write!(f, "VOD"),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for PlaylistType {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
match s {
|
||||||
|
"EVENT" => Ok(PlaylistType::Event),
|
||||||
|
"VOD" => Ok(PlaylistType::Vod),
|
||||||
|
_ => track_panic!(ErrorKind::InvalidInput, "Unknown playlist type: {:?}", s),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
49
src/types/protocol_version.rs
Normal file
49
src/types/protocol_version.rs
Normal file
|
@ -0,0 +1,49 @@
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
/// [7. Protocol Version Compatibility]
|
||||||
|
///
|
||||||
|
/// [7. Protocol Version Compatibility]: https://tools.ietf.org/html/rfc8216#section-7
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
||||||
|
pub enum ProtocolVersion {
|
||||||
|
V1,
|
||||||
|
V2,
|
||||||
|
V3,
|
||||||
|
V4,
|
||||||
|
V5,
|
||||||
|
V6,
|
||||||
|
V7,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ProtocolVersion {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
let n = match *self {
|
||||||
|
ProtocolVersion::V1 => 1,
|
||||||
|
ProtocolVersion::V2 => 2,
|
||||||
|
ProtocolVersion::V3 => 3,
|
||||||
|
ProtocolVersion::V4 => 4,
|
||||||
|
ProtocolVersion::V5 => 5,
|
||||||
|
ProtocolVersion::V6 => 6,
|
||||||
|
ProtocolVersion::V7 => 7,
|
||||||
|
};
|
||||||
|
write!(f, "{}", n)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for ProtocolVersion {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
Ok(match s {
|
||||||
|
"1" => ProtocolVersion::V1,
|
||||||
|
"2" => ProtocolVersion::V2,
|
||||||
|
"3" => ProtocolVersion::V3,
|
||||||
|
"4" => ProtocolVersion::V4,
|
||||||
|
"5" => ProtocolVersion::V5,
|
||||||
|
"6" => ProtocolVersion::V6,
|
||||||
|
"7" => ProtocolVersion::V7,
|
||||||
|
_ => track_panic!(ErrorKind::InvalidInput, "Unknown protocol version: {:?}", s),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
11
src/types/session_data.rs
Normal file
11
src/types/session_data.rs
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
/// Session data.
|
||||||
|
///
|
||||||
|
/// See: [4.3.4.4. EXT-X-SESSION-DATA]
|
||||||
|
///
|
||||||
|
/// [4.3.4.4. EXT-X-SESSION-DATA]: https://tools.ietf.org/html/rfc8216#section-4.3.4.4
|
||||||
|
#[allow(missing_docs)]
|
||||||
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
||||||
|
pub enum SessionData {
|
||||||
|
Value(String),
|
||||||
|
Uri(String),
|
||||||
|
}
|
56
src/types/signed_decimal_floating_point.rs
Normal file
56
src/types/signed_decimal_floating_point.rs
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
use crate::error::{Error, ErrorKind};
|
||||||
|
use crate::trackable::error::ErrorKindExt as _;
|
||||||
|
use std::fmt;
|
||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
/// Signed decimal floating-point number.
|
||||||
|
///
|
||||||
|
/// See: [4.2. Attribute Lists]
|
||||||
|
///
|
||||||
|
/// [4.2. Attribute Lists]: https://tools.ietf.org/html/rfc8216#section-4.2
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd)]
|
||||||
|
pub(crate) struct SignedDecimalFloatingPoint(f64);
|
||||||
|
|
||||||
|
impl SignedDecimalFloatingPoint {
|
||||||
|
/// Makes a new `SignedDecimalFloatingPoint` instance.
|
||||||
|
///
|
||||||
|
/// # Errors
|
||||||
|
///
|
||||||
|
/// The given value must be finite,
|
||||||
|
/// otherwise this function will return an error that has the kind `ErrorKind::InvalidInput`.
|
||||||
|
pub fn new(n: f64) -> crate::Result<Self> {
|
||||||
|
track_assert!(n.is_finite(), ErrorKind::InvalidInput);
|
||||||
|
Ok(SignedDecimalFloatingPoint(n))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts `DecimalFloatingPoint` to `f64`.
|
||||||
|
pub fn as_f64(self) -> f64 {
|
||||||
|
self.0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<i32> for SignedDecimalFloatingPoint {
|
||||||
|
fn from(f: i32) -> Self {
|
||||||
|
SignedDecimalFloatingPoint(f64::from(f))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Eq for SignedDecimalFloatingPoint {}
|
||||||
|
|
||||||
|
impl fmt::Display for SignedDecimalFloatingPoint {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||||
|
self.0.fmt(f)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FromStr for SignedDecimalFloatingPoint {
|
||||||
|
type Err = Error;
|
||||||
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
||||||
|
track_assert!(
|
||||||
|
s.chars().all(|c| c.is_digit(10) || c == '.' || c == '-'),
|
||||||
|
ErrorKind::InvalidInput
|
||||||
|
);
|
||||||
|
let n = track!(s.parse().map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
Ok(SignedDecimalFloatingPoint(n))
|
||||||
|
}
|
||||||
|
}
|
36
src/utils.rs
Normal file
36
src/utils.rs
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
use trackable::error::ErrorKindExt;
|
||||||
|
|
||||||
|
use crate::error::ErrorKind;
|
||||||
|
|
||||||
|
pub(crate) fn unquote<T: ToString>(value: T) -> String {
|
||||||
|
value
|
||||||
|
.to_string()
|
||||||
|
// silently remove forbidden characters + quotes
|
||||||
|
.replace("\n", "")
|
||||||
|
.replace("\r", "")
|
||||||
|
.replace("\"", "")
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn quote<T: ToString>(value: T) -> String {
|
||||||
|
format!("\"{}\"", value.to_string())
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn parse_yes_or_no<T: ToString>(s: T) -> crate::Result<bool> {
|
||||||
|
match s.to_string().as_str() {
|
||||||
|
"YES" => Ok(true),
|
||||||
|
"NO" => Ok(false),
|
||||||
|
_ => track_panic!(
|
||||||
|
ErrorKind::InvalidInput,
|
||||||
|
"Unexpected value: {:?}",
|
||||||
|
s.to_string()
|
||||||
|
),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn parse_u64<T: ToString>(s: T) -> crate::Result<u64> {
|
||||||
|
let n = track!(s
|
||||||
|
.to_string()
|
||||||
|
.parse()
|
||||||
|
.map_err(|e| ErrorKind::InvalidInput.cause(e)))?;
|
||||||
|
Ok(n)
|
||||||
|
}
|
17
tests/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8
Normal file
17
tests/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
#EXTM3U
|
||||||
|
#EXT-X-VERSION:5
|
||||||
|
|
||||||
|
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio",NAME="English stereo",LANGUAGE="en",AUTOSELECT=YES,URI="f08e80da-bf1d-4e3d-8899-f0f6155f6efa_audio_1_stereo_128000.m3u8"
|
||||||
|
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=628000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=320x180,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_180_250000.m3u8
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=928000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=480x270,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_270_400000.m3u8
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=1728000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=640x360,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_360_800000.m3u8
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=2528000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=960x540,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_540_1200000.m3u8
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=4928000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=1280x720,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_720_2400000.m3u8
|
||||||
|
#EXT-X-STREAM-INF:BANDWIDTH=9728000,CODECS="avc1.42c00d,mp4a.40.2",RESOLUTION=1920x1080,AUDIO="audio"
|
||||||
|
f08e80da-bf1d-4e3d-8899-f0f6155f6efa_video_1080_4800000.m3u8
|
76
tests/m3u8.rs
Normal file
76
tests/m3u8.rs
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
use hls_m3u8::MediaPlaylist;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn playlist_1() {
|
||||||
|
let playlist_1 = r#"
|
||||||
|
#EXTM3U
|
||||||
|
#EXT-X-PLAYLIST-TYPE:VOD
|
||||||
|
#EXT-X-TARGETDURATION:10
|
||||||
|
#EXT-X-VERSION:4
|
||||||
|
#EXT-X-MEDIA-SEQUENCE:0
|
||||||
|
#EXTINF:10.0,
|
||||||
|
http://example.com/movie1/fileSequenceA.ts
|
||||||
|
#EXTINF:10.0,
|
||||||
|
http://example.com/movie1/fileSequenceB.ts
|
||||||
|
#EXTINF:10.0,
|
||||||
|
http://example.com/movie1/fileSequenceC.ts
|
||||||
|
#EXTINF:9.0,
|
||||||
|
http://example.com/movie1/fileSequenceD.ts
|
||||||
|
#EXT-X-ENDLIST
|
||||||
|
"#;
|
||||||
|
|
||||||
|
//dbg!(playlist_1.parse::<MediaPlaylist>());
|
||||||
|
assert!(playlist_1.parse::<MediaPlaylist>().is_ok());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn playlist_2() {
|
||||||
|
let playlist_2 = r#"
|
||||||
|
#EXTM3U
|
||||||
|
#EXT-X-PLAYLIST-TYPE:VOD
|
||||||
|
#EXT-X-TARGETDURATION:10
|
||||||
|
#EXT-X-VERSION:4
|
||||||
|
#EXT-X-MEDIA-SEQUENCE:0
|
||||||
|
#EXTINF:10.0,
|
||||||
|
fileSequenceA.ts
|
||||||
|
#EXTINF:10.0,
|
||||||
|
fileSequenceB.ts
|
||||||
|
#EXTINF:10.0,
|
||||||
|
fileSequenceC.ts
|
||||||
|
#EXTINF:9.0,
|
||||||
|
fileSequenceD.ts
|
||||||
|
#EXT-X-ENDLIST
|
||||||
|
"#;
|
||||||
|
|
||||||
|
assert!(playlist_2.parse::<MediaPlaylist>().is_ok());
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
Error(
|
||||||
|
TrackableError {
|
||||||
|
kind: InvalidInput,
|
||||||
|
cause: Some(Cause("assertion failed: `self.inf_tag.is_some()`")),
|
||||||
|
history: History(
|
||||||
|
[
|
||||||
|
Location {
|
||||||
|
module_path: "hls_m3u8::media_segment",
|
||||||
|
file: "src/media_segment.rs", line: 62,
|
||||||
|
message: ""
|
||||||
|
},
|
||||||
|
Location {
|
||||||
|
module_path: "hls_m3u8::media_playlist",
|
||||||
|
file: "src/media_playlist.rs",
|
||||||
|
line: 444, message: ""
|
||||||
|
},
|
||||||
|
Location {
|
||||||
|
module_path: "hls_m3u8::media_playlist",
|
||||||
|
file: "src/media_playlist.rs",
|
||||||
|
line: 292,
|
||||||
|
message: ""
|
||||||
|
}
|
||||||
|
]
|
||||||
|
)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
*/
|
Loading…
Reference in a new issue