mirror of
https://github.com/sile/hls_m3u8.git
synced 2024-06-02 07:00:41 +00:00
c53e9e33f1
This will allow for better troubleshooting of failing test, because you don't have to search for the difference (between left and right). This is especially helpful for larger assertions.
102 lines
2.8 KiB
Rust
102 lines
2.8 KiB
Rust
use std::fmt;
|
|
use std::str::FromStr;
|
|
use std::time::Duration;
|
|
|
|
use crate::types::ProtocolVersion;
|
|
use crate::utils::tag;
|
|
use crate::{Error, RequiredVersion};
|
|
|
|
/// # [4.4.3.1. EXT-X-TARGETDURATION]
|
|
/// The [`ExtXTargetDuration`] tag specifies the maximum [`Media Segment`]
|
|
/// duration.
|
|
///
|
|
/// [`Media Segment`]: crate::MediaSegment
|
|
/// [4.4.3.1. EXT-X-TARGETDURATION]:
|
|
/// https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-05#section-4.4.3.1
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
|
|
pub struct ExtXTargetDuration(Duration);
|
|
|
|
impl ExtXTargetDuration {
|
|
pub(crate) const PREFIX: &'static str = "#EXT-X-TARGETDURATION:";
|
|
|
|
/// Makes a new [`ExtXTargetDuration`] tag.
|
|
///
|
|
/// # Example
|
|
/// ```
|
|
/// # use hls_m3u8::tags::ExtXTargetDuration;
|
|
/// use std::time::Duration;
|
|
///
|
|
/// let target_duration = ExtXTargetDuration::new(Duration::from_secs(20));
|
|
/// ```
|
|
///
|
|
/// # Note
|
|
/// The nanoseconds part of the [`Duration`] will be discarded.
|
|
pub const fn new(duration: Duration) -> Self {
|
|
// TOOD: round instead of discarding?
|
|
Self(Duration::from_secs(duration.as_secs()))
|
|
}
|
|
|
|
/// Returns the maximum media segment duration.
|
|
///
|
|
/// # Example
|
|
/// ```
|
|
/// # use hls_m3u8::tags::ExtXTargetDuration;
|
|
/// use std::time::Duration;
|
|
///
|
|
/// let target_duration = ExtXTargetDuration::new(Duration::from_nanos(2_000_000_000));
|
|
///
|
|
/// assert_eq!(target_duration.duration(), Duration::from_secs(2));
|
|
/// ```
|
|
pub const fn duration(&self) -> Duration { self.0 }
|
|
}
|
|
|
|
/// This tag requires [`ProtocolVersion::V1`].
|
|
impl RequiredVersion for ExtXTargetDuration {
|
|
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(input: &str) -> Result<Self, Self::Err> {
|
|
let input = tag(input, Self::PREFIX)?.parse()?;
|
|
Ok(Self::new(Duration::from_secs(input)))
|
|
}
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod test {
|
|
use super::*;
|
|
use pretty_assertions::assert_eq;
|
|
|
|
#[test]
|
|
fn test_display() {
|
|
assert_eq!(
|
|
ExtXTargetDuration::new(Duration::from_secs(5)).to_string(),
|
|
"#EXT-X-TARGETDURATION:5".to_string()
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn test_required_version() {
|
|
assert_eq!(
|
|
ExtXTargetDuration::new(Duration::from_secs(5)).required_version(),
|
|
ProtocolVersion::V1
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn test_parser() {
|
|
assert_eq!(
|
|
ExtXTargetDuration::new(Duration::from_secs(5)),
|
|
"#EXT-X-TARGETDURATION:5".parse().unwrap()
|
|
);
|
|
}
|
|
}
|