Skip to main content

InMemoryKernelJournal

Struct InMemoryKernelJournal 

Source
pub struct InMemoryKernelJournal { /* private fields */ }
Expand description

Single-process dev/test implementation (spec Task 8b, criterion 2).

CAS is genuinely atomic here — every check-then-mutate below happens while the single Mutex is held, and none of those critical sections contains an .await, so the compiler itself guarantees no task interleaves inside one — but that atomicity ends at the process boundary. Two processes sharing “the same” journal do not exist: each has its own map. Production hosts must supply a KernelJournal whose CAS is a real storage-layer primitive (spec §9.1); FileKernelJournal is the reference for that.

Implementations§

Trait Implementations§

Source§

impl Default for InMemoryKernelJournal

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl KernelJournal for InMemoryKernelJournal

Source§

fn stage_outbound_envelope<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, operation_id: &'life1 str, envelope_json: &'life2 str, ) -> Pin<Box<dyn Future<Output = JournalResult<()>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Persist the byte-identical canonical input envelope before attempting its record append. Read more
Source§

fn read_outbound_envelope<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = JournalResult<Option<String>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Return the staged outbound envelope, if an append-before crash left one behind.
Source§

fn clear_outbound_envelope<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = JournalResult<()>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Clear a staged outbound envelope after its input is durably owned or rejected.
Source§

fn compare_and_append<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, operation_id: &'life1 str, expected_head: Option<&'life2 str>, record: JournalRecordInput, ) -> Pin<Box<dyn Future<Output = JournalResult<JournalAppendReceipt>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Atomically append record iff the operation’s head is exactly expected_head. Read more
Source§

fn head<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = JournalResult<Option<JournalHead>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

The current head, or None when the operation has no records and no pruned anchor.
Source§

fn read_from<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, from_step_seq: u64, ) -> Pin<Box<dyn Future<Output = JournalResult<Vec<JournalEntry>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Records with step_seq >= from_step_seq, in chain order. 0 returns the whole retained chain (Rust has no default arguments; node’s optional parameter defaults to the same).
Source§

fn records_after<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, operation_id: &'life1 str, after_head: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = JournalResult<Vec<JournalEntry>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Records strictly after the record whose digest is after_head — the digest-anchored cursor §9.1 names records_after(operation_id, checkpoint_head). None returns everything retained. Read more
Source§

fn compare_and_install_checkpoint<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, operation_id: &'life1 str, previous_checkpoint_id: Option<&'life2 str>, covered_head: &'life3 str, checkpoint: CheckpointCandidate, ) -> Pin<Box<dyn Future<Output = JournalResult<InstalledCheckpoint>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Atomically install checkpoint iff the operation’s checkpoint pointer is exactly previous_checkpoint_id, and covered_head is the record digest at checkpoint.through_step_seq. Read more
Source§

fn latest_checkpoint<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = JournalResult<Option<InstalledCheckpoint>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

The highest-ordinal installed checkpoint, acknowledged or not.
Source§

fn ack_checkpoint<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, operation_id: &'life1 str, checkpoint_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = JournalResult<InstalledCheckpoint>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Record the durable acknowledgement that opens the prefix-reclamation boundary. Idempotent. Read more
Source§

fn prune_acked_prefix<'life0, 'life1, 'async_trait>( &'life0 self, operation_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = JournalResult<JournalPruneReceipt>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Reclaim the record prefix covered by the latest acknowledged checkpoint. A no-op while no checkpoint is acknowledged. The pruned boundary is retained as an anchor so Self::head and the next CAS still resolve on a fully-pruned chain (Task 8b correction (d)).

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more