Struct ValueBytesCodecDescriptor 

pub struct ValueBytesCodecDescriptor { /* private fields */ }

An immutable, safely erased bidirectional bytes codec for one value type.

Each operation creates a fresh default codec; no codec state is retained. Type identities are process-local and names are diagnostic, not stable IDs.

Examples

use core::convert::Infallible;

use qubit_codec::ValueBytesCodecDescriptor;
use qubit_codec::ValueDecoder;
use qubit_codec::ValueEncoder;

#[derive(Default)]
struct Bytes;
impl ValueEncoder<Vec<u8>> for Bytes {
    type Error = Infallible;
    type Output = Vec<u8>;
    fn encode(&mut self, value: &Vec<u8>) -> Result<Vec<u8>, Infallible> {
        Ok(value.clone())
    }
}
impl ValueDecoder<[u8]> for Bytes {
    type Error = Infallible;
    type Output = Vec<u8>;
    fn decode(&mut self, input: &[u8]) -> Result<Vec<u8>, Infallible> {
        Ok(input.to_vec())
    }
}
let descriptor = ValueBytesCodecDescriptor::of::<Bytes, Vec<u8>>();
let bytes = descriptor.encode(&vec![1_u8, 2]).unwrap();
let decoded = descriptor.decode(&bytes).unwrap();
assert_eq!(*decoded.downcast::<Vec<u8>>().unwrap(), vec![1, 2]);

Implementations

impl ValueBytesCodecDescriptor

pub const fn of<C, V>() -> Self

where C: Default + ValueEncoder<V, Output = Vec<u8>> + ValueDecoder<[u8], Output = V> + 'static, <C as ValueEncoder<V>>::Error: Error + Send + Sync + 'static, <C as ValueDecoder<[u8]>>::Error: Error + Send + Sync + 'static, V: 'static,

Creates a descriptor for codec C and value type V.

Both codec error types must implement Send + Sync so execution errors can retain their source across thread boundaries. The codec and value types themselves need not implement these traits; V only needs to be 'static because decoded values are returned through Any.

Type Parameters

• C: Default-constructible bytes encoder/decoder with owned errors.
• V: Owned value type accepted and produced by C.

Returns

Returns immutable function metadata without constructing a codec.

pub fn codec_type_id(&self) -> TypeId

Returns the process-local codec type identity.

Returns

Returns metadata for the type selected by Self::of, without allocation.

pub fn codec_type_name(&self) -> &'static str

Returns the diagnostic codec type name.

Returns

Returns metadata for the type selected by Self::of, without allocation.

pub fn value_type_id(&self) -> TypeId

Returns the process-local value type identity.

Returns

Returns metadata for the type selected by Self::of, without allocation.

pub fn value_type_name(&self) -> &'static str

Returns the diagnostic value type name.

Returns

Returns metadata for the type selected by Self::of, without allocation.

pub fn encode( &self, value: &dyn Any, ) -> Result<Vec<u8>, ValueCodecExecutionError>

Encodes one erased value after checking its concrete type.

Parameters

• value: Borrowed value whose concrete type must match the descriptor.

Returns

Returns owned bytes produced by a fresh default codec.

Errors

Returns a type mismatch or the typed encoder source error.

pub fn decode( &self, input: &[u8], ) -> Result<Box<dyn Any>, ValueCodecExecutionError>

Decodes one byte slice into a safely erased value of the declared type.

Parameters

• input: Bytes borrowed for one decoding operation.

Returns

Returns a boxed owned value that can be downcast to the declared type.

Errors

Returns the typed decoder source error.

Trait Implementations

impl Clone for ValueBytesCodecDescriptor

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ValueBytesCodecDescriptor

impl Debug for ValueBytesCodecDescriptor

fn fmt(&self, formatter: &mut Formatter<'_>) -> FmtResult

Formats descriptor metadata without invoking either codec function.

Parameters

• formatter: Destination receiving the diagnostic type names.

Returns

Returns success after both names have been formatted.

Errors

Returns the formatting error if the destination rejects output.