dns-parser-revived 0.10.0

Pure-rust DNS protocol parser library. This does not support network, only raw protocol parser.
Documentation
use crate::Error;

#[derive(Debug, Clone)]
pub struct Record<'a> {
    pub bytes: &'a [u8],
}

#[derive(Debug)]
pub struct RecordIter<'a> {
    bytes: &'a [u8],
}

impl<'a> Iterator for RecordIter<'a> {
    type Item = &'a [u8];
    fn next(&mut self) -> Option<&'a [u8]> {
        if !self.bytes.is_empty() {
            let len = self.bytes[0] as usize;
            debug_assert!(self.bytes.len() > len);
            let (head, tail) = self.bytes[1..].split_at(len);
            self.bytes = tail;
            return Some(head);
        }
        None
    }
}

impl<'a> Record<'a> {
    // Returns iterator over text chunks
    pub fn iter(&self) -> RecordIter<'a> {
        RecordIter { bytes: self.bytes }
    }
}

impl<'a> super::Record<'a> for Record<'a> {
    const TYPE: isize = 16;

    fn parse(rdata: &'a [u8], _original: &'a [u8]) -> super::RDataResult<'a> {
        // Just a quick check that record is valid
        let len = rdata.len();
        if len < 1 {
            return Err(Error::WrongRdataLength);
        }
        let mut pos = 0;
        while pos < len {
            let rdlen = rdata[pos] as usize;
            pos += 1;
            if len < rdlen + pos {
                return Err(Error::WrongRdataLength);
            }
            pos += rdlen;
        }
        Ok(super::RData::TXT(Record { bytes: rdata }))
    }
}

#[cfg(test)]
mod test {

    use std::str::from_utf8;

    use crate::Class as C;
    use crate::Opcode::*;
    use crate::QueryClass as QC;
    use crate::QueryType as QT;
    use crate::RData;
    use crate::ResponseCode::NoError;
    use crate::{Header, Packet};

    #[test]
    fn parse_response_multiple_strings() {
        let response = b"\x06%\x81\x80\x00\x01\x00\x01\x00\x00\x00\x00\
                          \x08facebook\x03com\x00\x00\x10\x00\x01\
                          \xc0\x0c\x00\x10\x00\x01\x00\x01\x51\x3d\x00\x23\
                          \x15\x76\x3d\x73\x70\x66\x31\x20\x72\x65\x64\x69\
                          \x72\x65\x63\x74\x3d\x5f\x73\x70\x66\x2e\
                          \x0c\x66\x61\x63\x65\x62\x6f\x6f\x6b\x2e\x63\x6f\x6d";

        let packet = Packet::parse(response).unwrap();
        assert_eq!(
            packet.header,
            Header {
                id: 1573,
                query: false,
                opcode: StandardQuery,
                authoritative: false,
                truncated: false,
                recursion_desired: true,
                recursion_available: true,
                authenticated_data: false,
                checking_disabled: false,
                response_code: NoError,
                questions: 1,
                answers: 1,
                nameservers: 0,
                additional: 0,
            }
        );
        assert_eq!(packet.questions.len(), 1);
        assert_eq!(packet.questions[0].qtype, QT::TXT);
        assert_eq!(packet.questions[0].qclass, QC::IN);
        assert_eq!(&packet.questions[0].qname.to_string()[..], "facebook.com");
        assert_eq!(packet.answers.len(), 1);
        assert_eq!(&packet.answers[0].name.to_string()[..], "facebook.com");
        assert!(!packet.answers[0].multicast_unique);
        assert_eq!(packet.answers[0].cls, C::IN);
        assert_eq!(packet.answers[0].ttl, 86333);
        match packet.answers[0].data {
            RData::TXT(ref text) => {
                assert_eq!(
                    text.iter()
                        .map(|x| from_utf8(x).unwrap())
                        .collect::<Vec<_>>()
                        .concat(),
                    "v=spf1 redirect=_spf.facebook.com"
                );

                // also assert boundaries are kept
                assert_eq!(
                    text.iter().collect::<Vec<_>>(),
                    [
                        "v=spf1 redirect=_spf.".as_bytes(),
                        "facebook.com".as_bytes()
                    ]
                );
            }
            ref x => panic!("Wrong rdata {:?}", x),
        }
    }
}