Trait ParcodeNative 

pub trait ParcodeNative: Sized {
    // Required method
    fn from_node(node: &ChunkNode<'_>) -> Result<Self>;
}

A trait for types that know how to reconstruct themselves from a ChunkNode.

This trait enables the high-level API (Parcode::load) to automatically select the optimal reconstruction strategy based on the type being read.

Strategy Selection

Different types use different reconstruction strategies:

• Vec<T>: Parallel reconstruction across shards (see ChunkNode::decode_parallel_collection)
• HashMap<K, V>: Shard merging with SOA deserialization
• Primitives: Direct bincode deserialization
• Custom Structs: Sequential deserialization of local fields + recursive child loading

Automatic Implementation

This trait is automatically implemented by the #[derive(ParcodeObject)] macro for custom structs. Primitive types and standard collections have manual implementations in this module.

Example

use parcode::Parcode;

// Automatically selects parallel reconstruction for Vec
let data = vec![1, 2, 3];
Parcode::save("numbers_native.par", &data).unwrap();
let data: Vec<i32> = Parcode::load("numbers_native.par").unwrap();

// Automatically selects sequential deserialization for primitives
let val = 42;
Parcode::save("value_native.par", &val).unwrap();
let value: i32 = Parcode::load("value_native.par").unwrap();

Required Methods

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

Reconstructs the object from the given graph node.

This method is called by Parcode::load after opening the file and locating the root chunk. Implementations should choose the most efficient reconstruction strategy for their type.

Parameters

• node: The chunk node to reconstruct from (typically the root node)

Returns

The fully reconstructed object of type Self.

Errors

Returns an error if:

• Decompression fails
• Deserialization fails (type mismatch, corrupted data)
• Child nodes are missing or invalid

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl ParcodeNative for bool

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for f32

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for f64

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for i8

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for i16

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for i32

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for i64

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for i128

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for isize

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for u8

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for u16

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for u32

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for u64

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for u128

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for usize

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl ParcodeNative for String

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl<K, V> ParcodeNative for HashMap<K, V>

where K: DeserializeOwned + Eq + Hash + Send + Sync, V: DeserializeOwned + Send + Sync,

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

impl<T> ParcodeNative for Vec<T>

where T: ParcodeItem,

Uses Parallel Stitching.

fn from_node(node: &ChunkNode<'_>) -> Result<Self>

Implementors