mp4san 0.3.0

An MP4 file sanitizer.
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

use std::fmt;
use std::io;

use bytes::{Buf, BufMut};
use futures_util::{pin_mut, AsyncRead, AsyncReadExt};

use crate::error::Result;

use super::error::ParseResultExt;
use super::integers::Mpeg4IntWriterExt;
use super::{Mpeg4Int, ParseError};

/// A four-byte character code.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct FourCC {
    /// The character code, as an array of four bytes.
    pub value: [u8; 4],
}

impl FourCC {
    /// Return the size of a [`FourCC`].
    pub const fn size() -> u64 {
        4
    }

    pub(crate) async fn read<R: AsyncRead>(input: R) -> io::Result<Self> {
        let mut value = [0; 4];
        pin_mut!(input);
        input.read_exact(&mut value).await?;
        Ok(Self { value })
    }

    /// Writes `self` to the [`BufMut`] `out`.
    pub fn put_buf<B: BufMut>(&self, mut out: B) {
        out.put(&self.value[..])
    }
}

impl Mpeg4Int for FourCC {
    fn parse<B: Buf>(buf: B) -> Result<Self, ParseError> {
        Ok(FourCC { value: Mpeg4Int::parse(buf).while_parsing_type::<Self>()? })
    }

    fn put_buf<B: BufMut>(&self, mut buf: B) {
        buf.put_mp4int(self.value);
    }
}

impl fmt::Display for FourCC {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        if let Ok(string) = std::str::from_utf8(&self.value) {
            let string = string.trim();
            write!(f, "{string}")
        } else {
            write!(f, "0x{:08x}", u32::from_be_bytes(self.value))
        }
    }
}