buffa-reflect 0.2.0

Runtime reflection for the buffa protobuf implementation.
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

//! Runtime-typed protobuf messages keyed by [`crate::MessageDescriptor`].
//!
//! Phase 2a delivers [`DynamicMessage`] — a message whose field set is
//! discovered at runtime from a descriptor. Use it when the wire schema is
//! known but the Rust type is not (e.g. proto-aware proxies, schema
//! migration tools, generic CLIs).
//!
//! # Examples
//!
//! ```no_run
//! use buffa_reflect::{DescriptorPool, DynamicMessage};
//!
//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
//! let bytes: &[u8] = &[];
//! let pool = DescriptorPool::decode(bytes)?;
//! let descriptor = pool.get_message_by_name("acme.v1.User").unwrap();
//!
//! let wire: &[u8] = &[];
//! let mut dyn_msg = DynamicMessage::decode(descriptor, wire)?;
//! dyn_msg.set_field_by_name("name", "Alice".into());
//! let bytes = dyn_msg.encode_to_vec();
//! # let _ = bytes;
//! # Ok(())
//! # }
//! ```

pub(crate) mod defaults;
mod fields;
mod message;
mod message_codec;
mod message_decode;
mod unknown;
mod value;

#[cfg(feature = "serde")]
pub mod serde;
#[cfg(feature = "text-format")]
pub mod text_format;

#[cfg(feature = "serde")]
pub use crate::dynamic::serde::{DeserializeOptions, SerializeOptions};
#[cfg(feature = "text-format")]
pub use crate::dynamic::text_format::{FormatOptions, ParseError, ParseErrorKind};
pub use crate::dynamic::{
    message::DynamicMessage,
    unknown::{UnknownField, UnknownFieldSet},
    value::{MapKey, SetFieldError, Value},
};