Struct ShallowObserver 

pub struct ShallowObserver<'i, T> { /* private fields */ }

A generic observer that only tracks complete replacements.

ShallowObserver provides a basic observer implementation that treats any mutation through DerefMut as a complete replacement of the value. It does not track internal mutations, making it suitable for:

1. Primitive types (numbers, booleans, etc.) that cannot be partially modified
2. Types where internal mutation tracking is not needed
3. External types that do not implement Observe

Examples

Built-in implementation for primitive types:

use morphix::{Observe, Observer, JsonAdapter};

let mut value = 42i32;
let mut observer = value.observe();  // ShallowObserver<i32>
*observer = 43;  // Recorded as a complete replacement

Explicit usage via #[observe(shallow)] attribute:

use morphix::Observe;
use serde::Serialize;

// External type that doesn't implement Observe
#[derive(Serialize)]
struct External;

#[derive(Serialize, Observe)]
struct MyStruct {
    #[observe(shallow)]
    external: External,  // use ShallowObserver<External>
    normal: String,      // use StringObserver
}

Type Parameters

• 'i - lifetime of the observed value
• T - type being observed

Implementations

impl<'i, T> ShallowObserver<'i, T>

pub fn new(value: &'i mut T) -> Self

Creates a new shallow observer for the given value.

Arguments

• value - value to observe

Trait Implementations

impl<'i, T: Copy + Add<U>, U> Add<U> for ShallowObserver<'i, T>

type Output = <T as Add<U>>::Output

The resulting type after applying the + operator.

fn add(self, rhs: U) -> Self::Output

Performs the + operation.

impl<'i, T: AddAssign<U>, U> AddAssign<U> for ShallowObserver<'i, T>

fn add_assign(&mut self, rhs: U)

Performs the += operation.

impl<'i, T: Copy + BitAnd<U>, U> BitAnd<U> for ShallowObserver<'i, T>

type Output = <T as BitAnd<U>>::Output

The resulting type after applying the & operator.

fn bitand(self, rhs: U) -> Self::Output

Performs the & operation.

impl<'i, T: BitAndAssign<U>, U> BitAndAssign<U> for ShallowObserver<'i, T>

fn bitand_assign(&mut self, rhs: U)

Performs the &= operation.

impl<'i, T: Copy + BitOr<U>, U> BitOr<U> for ShallowObserver<'i, T>

type Output = <T as BitOr<U>>::Output

The resulting type after applying the | operator.

fn bitor(self, rhs: U) -> Self::Output

Performs the | operation.

impl<'i, T: BitOrAssign<U>, U> BitOrAssign<U> for ShallowObserver<'i, T>

fn bitor_assign(&mut self, rhs: U)

Performs the |= operation.

impl<'i, T: Copy + BitXor<U>, U> BitXor<U> for ShallowObserver<'i, T>

type Output = <T as BitXor<U>>::Output

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: U) -> Self::Output

Performs the ^ operation.

impl<'i, T: BitXorAssign<U>, U> BitXorAssign<U> for ShallowObserver<'i, T>

fn bitxor_assign(&mut self, rhs: U)

Performs the ^= operation.

impl<'i, T> Deref for ShallowObserver<'i, T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'i, T> DerefMut for ShallowObserver<'i, T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'i, T: Copy + Div<U>, U> Div<U> for ShallowObserver<'i, T>

type Output = <T as Div<U>>::Output

The resulting type after applying the / operator.

fn div(self, rhs: U) -> Self::Output

Performs the / operation.

impl<'i, T: DivAssign<U>, U> DivAssign<U> for ShallowObserver<'i, T>

fn div_assign(&mut self, rhs: U)

Performs the /= operation.

impl<'i, T: Index<U>, U> Index<U> for ShallowObserver<'i, T>

type Output = <T as Index<U>>::Output

The returned type after indexing.

fn index(&self, index: U) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'i, T: IndexMut<U>, U> IndexMut<U> for ShallowObserver<'i, T>

fn index_mut(&mut self, index: U) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<'i, T: Copy + Mul<U>, U> Mul<U> for ShallowObserver<'i, T>

type Output = <T as Mul<U>>::Output

The resulting type after applying the * operator.

fn mul(self, rhs: U) -> Self::Output

Performs the * operation.

impl<'i, T: MulAssign<U>, U> MulAssign<U> for ShallowObserver<'i, T>

fn mul_assign(&mut self, rhs: U)

Performs the *= operation.

impl<'i, T> Observer<'i, T> for ShallowObserver<'i, T>

fn observe(value: &'i mut T) -> Self

Creates a new observer for the given value.

fn collect<A: Adapter>(this: Self) -> Result<Option<Mutation<A>>, A::Error>

where T: Serialize,

Collects all recorded mutations using the specified adapter.

impl<'i, T: PartialEq<U>, U: ?Sized> PartialEq<U> for ShallowObserver<'i, T>

fn eq(&self, other: &U) -> 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<'i, T: PartialOrd<U>, U: ?Sized> PartialOrd<U> for ShallowObserver<'i, T>

fn partial_cmp(&self, other: &U) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'i, T: Copy + Rem<U>, U> Rem<U> for ShallowObserver<'i, T>

type Output = <T as Rem<U>>::Output

The resulting type after applying the % operator.

fn rem(self, rhs: U) -> Self::Output

Performs the % operation.

impl<'i, T: RemAssign<U>, U> RemAssign<U> for ShallowObserver<'i, T>

fn rem_assign(&mut self, rhs: U)

Performs the %= operation.

impl<'i, T: Copy + Shl<U>, U> Shl<U> for ShallowObserver<'i, T>

type Output = <T as Shl<U>>::Output

The resulting type after applying the << operator.

fn shl(self, rhs: U) -> Self::Output

Performs the << operation.

impl<'i, T: ShlAssign<U>, U> ShlAssign<U> for ShallowObserver<'i, T>

fn shl_assign(&mut self, rhs: U)

Performs the <<= operation.

impl<'i, T: Copy + Shr<U>, U> Shr<U> for ShallowObserver<'i, T>

type Output = <T as Shr<U>>::Output

The resulting type after applying the >> operator.

fn shr(self, rhs: U) -> Self::Output

Performs the >> operation.

impl<'i, T: ShrAssign<U>, U> ShrAssign<U> for ShallowObserver<'i, T>

fn shr_assign(&mut self, rhs: U)

Performs the >>= operation.

impl<'i, T: Copy + Sub<U>, U> Sub<U> for ShallowObserver<'i, T>

type Output = <T as Sub<U>>::Output

The resulting type after applying the - operator.

fn sub(self, rhs: U) -> Self::Output

Performs the - operation.

impl<'i, T: SubAssign<U>, U> SubAssign<U> for ShallowObserver<'i, T>

fn sub_assign(&mut self, rhs: U)

Performs the -= operation.