mirror of
https://github.com/sile/hls_m3u8.git
synced 2024-06-02 07:19:50 +00:00
81 lines
1.9 KiB
Rust
81 lines
1.9 KiB
Rust
use std::fmt;
|
|
use std::str::FromStr;
|
|
|
|
use crate::types::{ProtocolVersion, RequiredVersion};
|
|
use crate::utils::tag;
|
|
use crate::Error;
|
|
|
|
/// # [4.4.1.1. EXTM3U]
|
|
/// The [`ExtM3u`] tag indicates that the file is an **Ext**ended **[`M3U`]**
|
|
/// Playlist file.
|
|
/// It is the at the start of every [`Media Playlist`] and [`Master Playlist`].
|
|
///
|
|
/// # Examples
|
|
/// Parsing from a [`str`]:
|
|
/// ```
|
|
/// # use failure::Error;
|
|
/// # use hls_m3u8::tags::ExtM3u;
|
|
/// #
|
|
/// # fn main() -> Result<(), Error> {
|
|
/// assert_eq!("#EXTM3U".parse::<ExtM3u>()?, ExtM3u);
|
|
/// #
|
|
/// # Ok(())
|
|
/// # }
|
|
/// ```
|
|
/// Converting to a [`str`]:
|
|
/// ```
|
|
/// # use hls_m3u8::tags::ExtM3u;
|
|
/// #
|
|
/// assert_eq!("#EXTM3U".to_string(), ExtM3u.to_string());
|
|
/// ```
|
|
///
|
|
/// [`Media Playlist`]: crate::MediaPlaylist
|
|
/// [`Master Playlist`]: crate::MasterPlaylist
|
|
/// [`M3U`]: https://en.wikipedia.org/wiki/M3U
|
|
/// [4.4.1.1. EXTM3U]:
|
|
/// https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-05#section-4.4.1.1
|
|
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Debug, Default)]
|
|
pub struct ExtM3u;
|
|
|
|
impl ExtM3u {
|
|
pub(crate) const PREFIX: &'static str = "#EXTM3U";
|
|
}
|
|
|
|
/// This tag requires [`ProtocolVersion::V1`].
|
|
impl RequiredVersion for ExtM3u {
|
|
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(input: &str) -> Result<Self, Self::Err> {
|
|
tag(input, Self::PREFIX)?;
|
|
Ok(Self)
|
|
}
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod test {
|
|
use super::*;
|
|
|
|
#[test]
|
|
fn test_display() {
|
|
assert_eq!(ExtM3u.to_string(), "#EXTM3U".to_string());
|
|
}
|
|
|
|
#[test]
|
|
fn test_parser() {
|
|
assert_eq!("#EXTM3U".parse::<ExtM3u>().ok(), Some(ExtM3u));
|
|
}
|
|
|
|
#[test]
|
|
fn test_required_version() {
|
|
assert_eq!(ExtM3u.required_version(), ProtocolVersion::V1);
|
|
}
|
|
}
|