mirror of
https://github.com/sile/hls_m3u8.git
synced 2024-05-16 23:43:00 +00:00
139 lines
3.7 KiB
Rust
139 lines
3.7 KiB
Rust
use std::fmt;
|
|
use std::ops::{Deref, DerefMut};
|
|
use std::str::FromStr;
|
|
|
|
use chrono::{DateTime, FixedOffset};
|
|
|
|
use crate::types::{ProtocolVersion, RequiredVersion};
|
|
use crate::utils::tag;
|
|
use crate::Error;
|
|
|
|
/// # [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]
|
|
/// The [ExtXProgramDateTime] tag associates the first sample of a
|
|
/// [Media Segment] with an absolute date and/or time.
|
|
///
|
|
/// [Media Segment]: crate::MediaSegment
|
|
/// [4.3.2.6. EXT-X-PROGRAM-DATE-TIME]: https://tools.ietf.org/html/rfc8216#section-4.3.2.6
|
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]
|
|
pub struct ExtXProgramDateTime(DateTime<FixedOffset>);
|
|
|
|
impl ExtXProgramDateTime {
|
|
pub(crate) const PREFIX: &'static str = "#EXT-X-PROGRAM-DATE-TIME:";
|
|
|
|
/// Makes a new `ExtXProgramDateTime` tag.
|
|
///
|
|
/// # Example
|
|
/// ```
|
|
/// use hls_m3u8::tags::ExtXProgramDateTime;
|
|
/// use chrono::{FixedOffset, TimeZone};
|
|
///
|
|
/// const HOURS_IN_SECS: i32 = 3600; // 1 hour = 3600 seconds
|
|
///
|
|
/// let program_date_time = ExtXProgramDateTime::new(
|
|
/// FixedOffset::east(8 * HOURS_IN_SECS)
|
|
/// .ymd(2010, 2, 19)
|
|
/// .and_hms_milli(14, 54, 23, 31)
|
|
/// );
|
|
/// ```
|
|
pub const fn new(date_time: DateTime<FixedOffset>) -> Self {
|
|
Self(date_time)
|
|
}
|
|
|
|
/// Returns the date-time of the first sample of the associated media segment.
|
|
pub const fn date_time(&self) -> DateTime<FixedOffset> {
|
|
self.0
|
|
}
|
|
|
|
/// Sets the date-time of the first sample of the associated media segment.
|
|
pub fn set_date_time(&mut self, value: DateTime<FixedOffset>) -> &mut Self {
|
|
self.0 = value;
|
|
self
|
|
}
|
|
}
|
|
|
|
impl RequiredVersion for ExtXProgramDateTime {
|
|
fn required_version(&self) -> ProtocolVersion {
|
|
ProtocolVersion::V1
|
|
}
|
|
}
|
|
|
|
impl fmt::Display for ExtXProgramDateTime {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
let date_time = self.0.to_rfc3339();
|
|
write!(f, "{}{}", Self::PREFIX, date_time)
|
|
}
|
|
}
|
|
|
|
impl FromStr for ExtXProgramDateTime {
|
|
type Err = Error;
|
|
|
|
fn from_str(input: &str) -> Result<Self, Self::Err> {
|
|
let input = tag(input, Self::PREFIX)?;
|
|
|
|
let date_time = DateTime::parse_from_rfc3339(input)?;
|
|
Ok(Self::new(date_time))
|
|
}
|
|
}
|
|
|
|
impl Deref for ExtXProgramDateTime {
|
|
type Target = DateTime<FixedOffset>;
|
|
|
|
fn deref(&self) -> &Self::Target {
|
|
&self.0
|
|
}
|
|
}
|
|
|
|
impl DerefMut for ExtXProgramDateTime {
|
|
fn deref_mut(&mut self) -> &mut Self::Target {
|
|
&mut self.0
|
|
}
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod test {
|
|
use super::*;
|
|
use chrono::TimeZone;
|
|
|
|
const HOURS_IN_SECS: i32 = 3600; // 1 hour = 3600 seconds
|
|
|
|
#[test]
|
|
fn test_display() {
|
|
assert_eq!(
|
|
ExtXProgramDateTime::new(
|
|
FixedOffset::east(8 * HOURS_IN_SECS)
|
|
.ymd(2010, 2, 19)
|
|
.and_hms_milli(14, 54, 23, 31)
|
|
)
|
|
.to_string(),
|
|
"#EXT-X-PROGRAM-DATE-TIME:2010-02-19T14:54:23.031+08:00".to_string()
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn test_parser() {
|
|
assert_eq!(
|
|
ExtXProgramDateTime::new(
|
|
FixedOffset::east(8 * HOURS_IN_SECS)
|
|
.ymd(2010, 2, 19)
|
|
.and_hms_milli(14, 54, 23, 31)
|
|
),
|
|
"#EXT-X-PROGRAM-DATE-TIME:2010-02-19T14:54:23.031+08:00"
|
|
.parse::<ExtXProgramDateTime>()
|
|
.unwrap()
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn test_required_version() {
|
|
assert_eq!(
|
|
ExtXProgramDateTime::new(
|
|
FixedOffset::east(8 * HOURS_IN_SECS)
|
|
.ymd(2010, 2, 19)
|
|
.and_hms_milli(14, 54, 23, 31),
|
|
)
|
|
.required_version(),
|
|
ProtocolVersion::V1
|
|
);
|
|
}
|
|
}
|