Enum insta::internals::Content

pub enum Content {
    Bool(bool),
    U8(u8),
    U16(u16),
    U32(u32),
    U64(u64),
    U128(u128),
    I8(i8),
    I16(i16),
    I32(i32),
    I64(i64),
    I128(i128),
    F32(f32),
    F64(f64),
    Char(char),
    String(String),
    Bytes(Vec<u8>),
    Seq(Vec<Content>),
    Map(Vec<(Content, Content)>),
    // some variants omitted
}

Represents variable typed content.

This is used for the serialization system to represent values before the actual snapshots are written and is also exposed to dynamic redaction functions.

Some enum variants are intentionally not exposed to user code. It’s generally recommended to construct content objects by using the From trait and by using the accessor methods to assert on it.

While matching on the content is possible in theory it is recommended against. The reason for this is that the content enum holds variants that can “wrap” values where it’s not expected. For instance if a field holds an Option<String> you cannot use pattern matching to extract the string as it will be contained in an internal Some variant that is not exposed. On the other hand the as_str method will automatically resolve such internal wrappers.

If you do need to pattern match you should use the resolve_inner method to resolve such internal wrappers.

Variants

Bool(bool)

Tuple Fields of Bool

0: bool

U8(u8)

Tuple Fields of U8

0: u8

U16(u16)

Tuple Fields of U16

0: u16

U32(u32)

Tuple Fields of U32

0: u32

U64(u64)

Tuple Fields of U64

0: u64

U128(u128)

Tuple Fields of U128

0: u128

I8(i8)

Tuple Fields of I8

0: i8

I16(i16)

Tuple Fields of I16

0: i16

I32(i32)

Tuple Fields of I32

0: i32

I64(i64)

Tuple Fields of I64

0: i64

I128(i128)

Tuple Fields of I128

0: i128

F32(f32)

Tuple Fields of F32

0: f32

F64(f64)

Tuple Fields of F64

0: f64

Char(char)

Tuple Fields of Char

0: char

String(String)

Tuple Fields of String

0: String

Bytes(Vec<u8>)

Tuple Fields of Bytes

0: Vec<u8>

Seq(Vec<Content>)

Tuple Fields of Seq

0: Vec<Content>

Map(Vec<(Content, Content)>)

Tuple Fields of Map

0: Vec<(Content, Content)>

Implementations

impl Content

pub fn resolve_inner(&self) -> &Content

This resolves the innermost content in a chain of wrapped content.

For instance if you encounter an Option<Option<String>> field the content will be wrapped twice in an internal option wrapper. If you need to pattern match you will need in some situations to first resolve the inner value before such matching can take place as there is no exposed way to match on these wrappers.

This method does not need to be called for the as_ methods which resolve automatically.

pub fn as_str(&self) -> Option<&str>

Returns the value as string

pub fn as_bytes(&self) -> Option<&[u8]>

Returns the value as bytes

pub fn as_slice(&self) -> Option<&[Content]>

Returns the value as slice of content values.

pub fn is_nil(&self) -> bool

Returns true if the value is nil.

pub fn as_bool(&self) -> Option<bool>

Returns the value as bool

pub fn as_u64(&self) -> Option<u64>

Returns the value as u64

pub fn as_u128(&self) -> Option<u128>

Returns the value as u128

pub fn as_i64(&self) -> Option<i64>

Returns the value as i64

pub fn as_i128(&self) -> Option<i128>

Returns the value as i128

pub fn as_f64(&self) -> Option<f64>

Returns the value as f64

pub fn walk<F: FnMut(&mut Content) -> bool>(&mut self, visit: &mut F)

Recursively walks the content structure mutably.

The callback is invoked for every content in the tree.

Trait Implementations

impl Clone for Content

fn clone(&self) -> Content

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Content

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for Content

fn from(value: &'a [u8]) -> Content

Performs the conversion.

impl<'a> From<&'a str> for Content

fn from(value: &'a str) -> Content

Performs the conversion.

impl From<()> for Content

fn from(_value: ()) -> Content

Performs the conversion.

impl From<String> for Content

fn from(value: String) -> Content

Performs the conversion.

impl From<Vec<u8, Global>> for Content

fn from(value: Vec<u8>) -> Content

Performs the conversion.

impl From<bool> for Content

fn from(value: bool) -> Content

Performs the conversion.

impl From<char> for Content

fn from(value: char) -> Content

Performs the conversion.

impl From<f32> for Content

fn from(value: f32) -> Content

Performs the conversion.

impl From<f64> for Content

fn from(value: f64) -> Content

Performs the conversion.

impl From<i128> for Content

fn from(value: i128) -> Content

Performs the conversion.

impl From<i16> for Content

fn from(value: i16) -> Content

Performs the conversion.

impl From<i32> for Content

fn from(value: i32) -> Content

Performs the conversion.

impl From<i64> for Content

fn from(value: i64) -> Content

Performs the conversion.

impl From<i8> for Content

fn from(value: i8) -> Content

Performs the conversion.

impl From<u128> for Content

fn from(value: u128) -> Content

Performs the conversion.

impl From<u16> for Content

fn from(value: u16) -> Content

Performs the conversion.

impl From<u32> for Content

fn from(value: u32) -> Content

Performs the conversion.

impl From<u64> for Content

fn from(value: u64) -> Content

Performs the conversion.

impl From<u8> for Content

fn from(value: u8) -> Content

Performs the conversion.

impl Serialize for Content

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.