hickory-proto 0.26.0

hickory-proto is a safe and secure low-level DNS library. This is the foundational DNS protocol library used by the other higher-level Hickory DNS crates.
Documentation
// Copyright 2015-2018 Benjamin Fry <benjaminfry@me.com>
//
// Licensed under the Apache License, Version 2.0, <LICENSE-APACHE or
// https://apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or
// https://opensource.org/licenses/MIT>, at your option. This file may not be
// copied, modified, or distributed except according to those terms.

use alloc::vec::Vec;
use core::net::SocketAddr;

use crate::op::Message;
use crate::serialize::binary::DecodeError;

/// A DNS message in serialized form, with either the target address or source address
pub struct SerialMessage {
    // TODO: change to Bytes? this would be more compatible with some underlying libraries
    message: Vec<u8>,
    addr: SocketAddr,
}

impl SerialMessage {
    /// Construct a new SerialMessage and the source or destination address
    pub fn new(message: Vec<u8>, addr: SocketAddr) -> Self {
        Self { message, addr }
    }

    /// Get a reference to the bytes
    pub fn bytes(&self) -> &[u8] {
        &self.message
    }

    /// Get the source or destination address (context dependent)
    pub fn addr(&self) -> SocketAddr {
        self.addr
    }

    /// Unwrap the Bytes and address
    pub fn into_parts(self) -> (Vec<u8>, SocketAddr) {
        self.into()
    }

    /// Build a `SerialMessage` from some bytes and an address
    pub fn from_parts(message: Vec<u8>, addr: SocketAddr) -> Self {
        (message, addr).into()
    }

    /// Deserializes the inner data into a Message
    pub fn to_message(&self) -> Result<Message, DecodeError> {
        Message::from_vec(&self.message)
    }
}

impl From<(Vec<u8>, SocketAddr)> for SerialMessage {
    fn from((message, addr): (Vec<u8>, SocketAddr)) -> Self {
        Self { message, addr }
    }
}

impl From<SerialMessage> for (Vec<u8>, SocketAddr) {
    fn from(msg: SerialMessage) -> Self {
        let SerialMessage { message, addr } = msg;
        (message, addr)
    }
}