mirror of https://github.com/chipsenkbeil/distant
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
2.6 KiB
Rust
93 lines
2.6 KiB
Rust
use crate::common::{utils, Value};
|
|
use derive_more::IntoIterator;
|
|
use serde::de::DeserializeOwned;
|
|
use serde::{Deserialize, Serialize};
|
|
use std::collections::HashMap;
|
|
use std::io;
|
|
use std::ops::{Deref, DerefMut};
|
|
|
|
/// Generates a new [`Header`] of key/value pairs based on literals.
|
|
///
|
|
/// ```
|
|
/// use distant_net::header;
|
|
///
|
|
/// let _header = header!("key" -> "value", "key2" -> 123);
|
|
/// ```
|
|
#[macro_export]
|
|
macro_rules! header {
|
|
($($key:literal -> $value:expr),* $(,)?) => {{
|
|
let mut _header = $crate::common::Header::default();
|
|
|
|
$(
|
|
_header.insert($key, $value);
|
|
)*
|
|
|
|
_header
|
|
}};
|
|
}
|
|
|
|
/// Represents a packet header comprised of arbitrary data tied to string keys.
|
|
#[derive(Clone, Debug, Default, PartialEq, Eq, IntoIterator, Serialize, Deserialize)]
|
|
#[serde(transparent)]
|
|
pub struct Header(HashMap<String, Value>);
|
|
|
|
impl Header {
|
|
/// Creates an empty [`Header`] newtype wrapper.
|
|
pub fn new() -> Self {
|
|
Self::default()
|
|
}
|
|
|
|
/// Exists purely to support serde serialization checks.
|
|
#[inline]
|
|
pub(crate) fn is_empty(&self) -> bool {
|
|
self.0.is_empty()
|
|
}
|
|
|
|
/// Inserts a key-value pair into the map.
|
|
///
|
|
/// If the map did not have this key present, [`None`] is returned.
|
|
///
|
|
/// If the map did have this key present, the value is updated, and the old value is returned.
|
|
/// The key is not updated, though; this matters for types that can be `==` without being
|
|
/// identical. See the [module-level documentation](std::collections#insert-and-complex-keys)
|
|
/// for more.
|
|
pub fn insert(&mut self, key: impl Into<String>, value: impl Into<Value>) -> Option<Value> {
|
|
self.0.insert(key.into(), value.into())
|
|
}
|
|
|
|
/// Retrieves a value from the header, attempting to convert it to the specified type `T`
|
|
/// by cloning the value and then converting it.
|
|
pub fn get_as<T>(&self, key: impl AsRef<str>) -> Option<io::Result<T>>
|
|
where
|
|
T: DeserializeOwned,
|
|
{
|
|
self.0
|
|
.get(key.as_ref())
|
|
.map(|value| value.clone().cast_as())
|
|
}
|
|
|
|
/// Serializes the header into bytes.
|
|
pub fn to_vec(&self) -> io::Result<Vec<u8>> {
|
|
utils::serialize_to_vec(self)
|
|
}
|
|
|
|
/// Deserializes the header from bytes.
|
|
pub fn from_slice(slice: &[u8]) -> io::Result<Self> {
|
|
utils::deserialize_from_slice(slice)
|
|
}
|
|
}
|
|
|
|
impl Deref for Header {
|
|
type Target = HashMap<String, Value>;
|
|
|
|
fn deref(&self) -> &Self::Target {
|
|
&self.0
|
|
}
|
|
}
|
|
|
|
impl DerefMut for Header {
|
|
fn deref_mut(&mut self) -> &mut Self::Target {
|
|
&mut self.0
|
|
}
|
|
}
|