Struct MemorySink 

pub struct MemorySink { /* private fields */ }

Available on crate feature alloc only.

In-memory Sink: appends every record into a Vec<OwnedRecord>.

Intended for tests, prototypes, and short-lived buffering. Holds the entire chain in memory, so it is not suitable for long-running production workloads — use a file-backed or streaming sink instead.

Example

use audit_trail::{
    Action, Actor, Chain, Clock, Digest, Hasher, MemorySink, Outcome, Record, RecordId,
    SinkError, Target, Timestamp, HASH_LEN,
};

// Minimal hasher / clock for the example.
struct XorHasher([u8; HASH_LEN], usize);
impl Hasher for XorHasher {
    fn reset(&mut self) { self.0 = [0u8; HASH_LEN]; self.1 = 0; }
    fn update(&mut self, bytes: &[u8]) {
        for b in bytes { self.0[self.1 % HASH_LEN] ^= *b; self.1 = self.1.wrapping_add(1); }
    }
    fn finalize(&mut self, out: &mut Digest) { *out = Digest::from_bytes(self.0); }
}
struct Tick(core::cell::Cell<u64>);
impl Clock for Tick {
    fn now(&self) -> Timestamp {
        let v = self.0.get(); self.0.set(v + 1); Timestamp::from_nanos(v)
    }
}

let mut chain = Chain::new(
    XorHasher([0u8; HASH_LEN], 0),
    MemorySink::new(),
    Tick(core::cell::Cell::new(1)),
);
chain.append(Actor::new("a"), Action::new("x"), Target::new("t"), Outcome::Success).unwrap();

assert_eq!(chain.sink().len(), 1);

Implementations

impl MemorySink

pub const fn new() -> Self

Construct an empty MemorySink.

pub fn with_capacity(cap: usize) -> Self

Construct a MemorySink with pre-allocated capacity for cap records.

pub fn len(&self) -> usize

Number of records currently held.

pub fn is_empty(&self) -> bool

true if no records have been written.

pub fn records(&self) -> &[OwnedRecord]

Borrow the recorded log.

pub fn into_records(self) -> Vec<OwnedRecord>

Consume the sink and return its records.

pub fn clear(&mut self)

Drop all stored records.

Trait Implementations

impl Clone for MemorySink

fn clone(&self) -> MemorySink

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemorySink

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

Formats the value using the given formatter.

impl Default for MemorySink

fn default() -> MemorySink

Returns the “default value” for a type.

impl Sink for MemorySink

fn write(&mut self, record: &Record<'_>) -> Result<(), SinkError>

Persist a single record.