use crate::{Error, Result};
pub const PRIVATE_LAYOUT_TAG_MIN: u8 = 0xF0;
pub const PRIVATE_LAYOUT_TAG_MAX: u8 = 0xFE;
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub struct PrivateExtensionLayout {
pub tag: u8,
pub extension_layout_id: u64,
pub extension_data: Vec<u8>,
}
impl PrivateExtensionLayout {
pub fn new(tag: u8, extension_layout_id: u64, extension_data: Vec<u8>) -> Result<Self> {
if !(PRIVATE_LAYOUT_TAG_MIN..=PRIVATE_LAYOUT_TAG_MAX).contains(&tag) {
return Err(Error::InvalidLayout(format!(
"private extension layout tag 0x{tag:02X} is outside the valid range \
0x{PRIVATE_LAYOUT_TAG_MIN:02X}–0x{PRIVATE_LAYOUT_TAG_MAX:02X}"
)));
}
Ok(Self {
tag,
extension_layout_id,
extension_data,
})
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::layout::LayoutDescriptor;
#[test]
fn private_extension_tag_passthrough() {
for tag in 0xF0u8..=0xFEu8 {
let layout = LayoutDescriptor::PrivateExtension(
PrivateExtensionLayout::new(tag, 0, vec![]).unwrap(),
);
assert_eq!(layout.tag(), tag);
}
}
#[test]
fn private_extension_buffer_count_is_none() {
let layout = LayoutDescriptor::PrivateExtension(
PrivateExtensionLayout::new(0xF0, 0, vec![]).unwrap(),
);
assert!(layout.buffer_count().is_none());
}
#[test]
fn rejects_tag_below_range() {
assert!(matches!(
PrivateExtensionLayout::new(0xEF, 0, vec![]),
Err(Error::InvalidLayout(_))
));
}
#[test]
fn rejects_tag_0xff() {
assert!(matches!(
PrivateExtensionLayout::new(0xFF, 0, vec![]),
Err(Error::InvalidLayout(_))
));
}
#[test]
fn rejects_core_layout_tag() {
assert!(matches!(
PrivateExtensionLayout::new(0x01, 0, vec![]),
Err(Error::InvalidLayout(_))
));
}
}