Enum Value 

#[non_exhaustive]
pub enum Value {
    Tensor {
        values: Arc<Vec<f64>>,
        shape: Vec<usize>,
    },
    Json(Arc<Value>),
    Bytes(Arc<Vec<u8>>),
    Object(Arc<Vec<u8>>),
    Empty,
}

Typed values flowing between filters in a pipeline.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Tensor

Numeric tensor data (shape + flat data). values is wrapped in Arc so that cloning a Value is O(1).

Fields

values: Arc<Vec<f64>>

shape: Vec<usize>

Json(Arc<Value>)

Structured JSON data (Arc-wrapped for cheap cloning).

Bytes(Arc<Vec<u8>>)

Raw bytes (Arc-wrapped for cheap cloning).

Object(Arc<Vec<u8>>)

Opaque serialized object (e.g. Python pickle). Soma passes it through without interpreting the contents. Used for efficient inter-filter data transfer when the producing and consuming runtimes share a serialization format.

Empty

Empty / void value

Implementations

impl Value

pub fn tensor(values: Vec<f64>, shape: Vec<usize>) -> Self

pub fn json(val: Value) -> Self

pub fn bytes(data: Vec<u8>) -> Self

pub fn object(data: Vec<u8>) -> Self

pub fn is_empty(&self) -> bool

pub fn as_tensor(&self) -> Option<(&[f64], &[usize])>

Try to extract tensor data.

pub fn as_json(&self) -> Option<&Value>

Try to extract JSON value.

pub fn size(&self) -> usize

Number of elements (for tensors) or bytes.

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Value

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Value

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Value> for Value

fn from(v: Value) -> Self

Converts to this type from the input type.

impl From<Value> for VirtualValue

fn from(value: Value) -> Self

Converts to this type from the input type.

impl From<Vec<f64>> for Value

fn from(values: Vec<f64>) -> Self

Converts to this type from the input type.

impl PartialEq for Value

fn eq(&self, other: &Value) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Value

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Value