dvb-si 1.0.0

ETSI EN 300 468 DVB Service Information parser + builder. MPEG-2 PSI included.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! DVB + MPEG-2 descriptors. Each descriptor tag gets its own submodule file.
//!
//! The usual way to consume a descriptor is to walk a table's raw descriptor
//! loop and call the specific descriptor module's `parse` for the tags you
//! care about (e.g. [`satellite_delivery_system`], [`service`], [`linkage`]).
//!
//! The [`Descriptor`] enum covers only the small set of MPEG-2 descriptors
//! that appear in contexts without surrounding table semantics (CA,
//! data_stream_alignment, private_data_indicator, registration); every other
//! tag lands as [`Descriptor::Unknown`] with its raw bytes preserved — it is
//! NOT a dispatcher over the full typed-descriptor set.

pub mod ac3;
pub mod bouquet_name;
pub mod ca;
pub mod cable_delivery_system;
pub mod component;
pub mod content;
pub mod content_identifier;
pub mod data_stream_alignment;
pub mod default_authority;
pub mod enhanced_ac3;
pub mod extended_event;
pub mod frequency_list;
pub mod iso_639_language;
pub mod linkage;
pub mod local_time_offset;
pub mod logical_channel;
pub mod network_name;
pub mod parental_rating;
pub mod private_data_indicator;
pub mod registration;
pub mod s2_satellite_delivery_system;
pub mod satellite_delivery_system;
pub mod service;
pub mod service_list;
pub mod short_event;
pub mod stream_identifier;
pub mod subtitling;
pub mod teletext;
pub mod terrestrial_delivery_system;

pub use ca::CaDescriptor;
pub use data_stream_alignment::DataStreamAlignmentDescriptor;
pub use private_data_indicator::PrivateDataIndicatorDescriptor;
pub use registration::RegistrationDescriptor;

/// Unified descriptor variant. Variants land as per-descriptor phases complete.
#[derive(Debug, Clone, PartialEq, Eq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[non_exhaustive]
pub enum Descriptor<'a> {
    /// Conditional Access descriptor (tag 0x09).
    Ca(CaDescriptor<'a>),
    /// Data stream alignment descriptor (tag 0x06).
    DataStreamAlignment(DataStreamAlignmentDescriptor),
    /// Private Data Indicator descriptor (tag 0x0F).
    PrivateDataIndicator(PrivateDataIndicatorDescriptor),
    /// Registration descriptor (tag 0x05).
    Registration(RegistrationDescriptor<'a>),
    /// Forward-compatible fallthrough for tags we don't recognise.
    Unknown {
        /// The raw tag byte.
        tag: u8,
        /// The raw payload (descriptor_length bytes, not including the 2-byte header).
        #[cfg_attr(feature = "serde", serde(borrow))]
        bytes: &'a [u8],
    },
}

impl<'a> Descriptor<'a> {
    /// The underlying tag byte.
    #[must_use]
    pub const fn tag(&self) -> u8 {
        match self {
            Self::Ca(_) => ca::TAG,
            Self::DataStreamAlignment(_) => data_stream_alignment::TAG,
            Self::PrivateDataIndicator(_) => private_data_indicator::TAG,
            Self::Registration(_) => registration::TAG,
            Self::Unknown { tag, .. } => *tag,
        }
    }
}