Enum Value 

pub enum Value {
    Null,
    Bool(bool),
    Int(i64),
    Float(f64),
    String(String),
    Bytes(Vec<u8>),
    List(Vec<Value>),
    Map(BTreeMap<String, Value>),
}

Serialize/Deserialize are hand-written in [mod@codec] and are untagged: Value::String("foo") goes on the wire as "foo", not {"String":"foo"}. Do not replace them with a derive — that reintroduces serde’s externally-tagged enum representation into every wire payload and every generated client. See the module docs on [mod@codec] for the two format-specific choices (Null via serialize_none, Bytes branching on is_human_readable) and why each is load-bearing.

Variants

Null

Bool(bool)

Int(i64)

Float(f64)

String(String)

Bytes(Vec<u8>)

List(Vec<Value>)

Map(BTreeMap<String, Value>)

Implementations

impl Value

pub fn to_plain_json(&self) -> Value

Convert to the plain, untagged JSON shape used for a schema Json column’s on-disk representation (cratestack#162): an empty map becomes {}, a list becomes [...], Value::Null becomes null.

Since the externally-tagged derive was replaced by the hand-written untagged impls in [mod@codec], this is no longer the only plain path — serde_json::to_value(&value) now produces the same shape. The method is kept because it is infallible and total (it cannot fail on a NaN float, it substitutes null), which the persistence layer relies on, and because it makes the on-disk contract explicit at the call site rather than implicit in a serde impl.

Value::Bytes has no native JSON representation, so it is base64-encoded into a JSON string. That direction is lossy on the way back: Value::from_plain_json has no way to tell a base64-looking string from an ordinary one, so it always decodes JSON strings as Value::String. Callers that need Bytes to round-trip losslessly should use a Bytes column, not Json.

pub fn from_plain_json(json: Value) -> Value

Inverse of Value::to_plain_json: parse a plain JSON value — cratestack’s own past writes, legacy rows, or data written by any other JSON producer — into a Value. Every JSON number that fits in an i64 decodes as Value::Int; everything else numeric decodes as Value::Float. Never produces Value::Bytes — see the round-trip caveat on Value::to_plain_json.

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<(), Error>

Formats the value using the given formatter.

impl Default for Value

Default is required by every generated model struct since #51 (column projection): non-selected fields hold T::default() so the returned Projection<T> is constructable without re-fetching. Value::Null is the natural identity — JSON columns surfacing as cratestack::Value default to “no payload” until the next read.

fn default() -> Value

Returns the “default value” for a type.

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

fn deserialize<D>( deserializer: D, ) -> Result<Value, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoSqlValue for Value

fn into_sql_value(self) -> SqlValue

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 as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Value