Enum DataBuffer 

pub enum DataBuffer {
    Uma(Vec<u8>),
    Numa((Topology, Bytes<'static>, usize)),
}

ZERO-COPY buffer abstraction for UMA and NUMA allocations

CRITICAL: This type NEVER copies data - it holds the actual memory and provides mutable slices for zero-copy operations. Python bindings access this memory directly via raw pointers.

Variants

Uma(Vec<u8>)

UMA allocation using Vec (fast path, 43-50 GB/s) Python accesses via Vec’s raw pointer

Numa((Topology, Bytes<'static>, usize))

NUMA allocation using hwlocality Bytes (target: 1,200-1,400 GB/s) Python accesses via Bytes’ raw pointer - ZERO COPY to Python! Stores (Topology, Bytes, actual_size) to keep Topology alive

Implementations

impl DataBuffer

pub fn as_mut_slice(&mut self) -> &mut [u8]

Get mutable slice for data generation (zero-copy)

pub fn as_slice(&self) -> &[u8]

Get immutable slice view (zero-copy)

pub fn as_ptr(&self) -> *const u8

Get raw pointer for zero-copy Python access

pub fn as_mut_ptr(&mut self) -> *mut u8

Get mutable raw pointer for zero-copy Python access

pub fn len(&self) -> usize

Get length (actual data size, not allocated size)

pub fn is_empty(&self) -> bool

Check if buffer is empty

pub fn truncate(&mut self, size: usize)

Truncate to requested size (modifies metadata only, NO COPY)

pub fn into_bytes(self) -> Bytes

Convert to bytes::Bytes for Python API (ZERO-COPY for UMA, minimal copy for NUMA)

For UMA: Uses Bytes::from(Vec) which is cheap (just wraps the allocation) For NUMA: Must copy to bytes::Bytes since hwlocality::Bytes can’t be converted directly Alternative: Keep as DataBuffer and implement Python buffer protocol directly