nrbf 0.2.2

A parser for the .NET Remoting Binary Format (NRBF).
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

//! A parser for the [.NET Remoting Binary Format (NRBF)](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-nrbf/75b9fe09-be15-475f-85b8-ae7b7558cfe5).

#![warn(missing_docs)]

#[cfg(feature = "serde")]
use serde::de::{self, Deserialize};

pub(crate) mod common;
pub(crate) mod data_type;
pub(crate) mod enumeration;
pub(crate) mod record;

mod binary_parser;
pub(crate) use binary_parser::BinaryParser;
mod combinator;
mod error;
#[doc(inline)]
pub use error::Error;
mod remoting_message;
pub use remoting_message::{MethodCall, MethodReturn, RemotingMessage};

pub mod value;
#[doc(inline)]
pub use value::Value;

/// Deserialize an instance of type `T` from bytes of a .NET Remoting message.
///
/// # Example
///
/// ```
/// # use const_str::concat_bytes;
/// # #[rustfmt::skip]
/// let message = concat_bytes!(
///   0,
///     b"\x01\x00\x00\x00",
///     b"\xFF\xFF\xFF\xFF",
///     b"\x01\x00\x00\x00",
///     b"\x00\x00\x00\x00",
///   6,
///     b"\x01\x00\x00\x00",
///     17, "This is a string.",
///   11,
/// );
///
/// assert_eq!(nrbf::from_slice(message), Ok("This is a string."));
/// ```
#[cfg(feature = "serde")]
pub fn from_slice<'i, T>(bytes: &'i [u8]) -> Result<T, de::value::Error>
where
  T: Deserialize<'i>,
{
  let remoting_message =
    RemotingMessage::parse(bytes).map_err(|err| de::Error::custom(format!("parsing error: {}", err)))?;
  T::deserialize(remoting_message)
}