Struct MockPurgeExecutor 

pub struct MockPurgeExecutor { /* private fields */ }

Defines the behavior for log entry compaction and physical deletion.

Safety Requirements

Implementations MUST guarantee:

1. All entries up to last_included.index are preserved in snapshots
2. No concurrent modifications during purge execution
3. Atomic persistence of purge metadata

Implementations

impl MockPurgeExecutor

pub fn checkpoint(&mut self)

Validate that all current expectations for all methods have been satisfied, and discard them.

pub fn new() -> Self

Create a new mock object with no expectations.

This method will not be generated if the real struct already has a new method. However, it will be generated if the struct implements a trait with a new method. The trait’s new method can still be called like <MockX as TraitY>::new

impl MockPurgeExecutor

pub fn expect_execute_purge(&mut self) -> &mut Expectation

Create an Expectation for mocking the execute_purge method

pub fn expect_validate_purge(&mut self) -> &mut Expectation

Create an Expectation for mocking the validate_purge method

pub fn expect_pre_purge(&mut self) -> &mut Expectation

Create an Expectation for mocking the pre_purge method

pub fn expect_post_purge(&mut self) -> &mut Expectation

Create an Expectation for mocking the post_purge method

Trait Implementations

impl Debug for MockPurgeExecutor

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

Formats the value using the given formatter.

impl Default for MockPurgeExecutor

fn default() -> Self

Returns the “default value” for a type.

impl PurgeExecutor for MockPurgeExecutor

Defines the behavior for log entry compaction and physical deletion.

Safety Requirements

Implementations MUST guarantee:

1. All entries up to last_included.index are preserved in snapshots
2. No concurrent modifications during purge execution
3. Atomic persistence of purge metadata

fn execute_purge<'life0, 'async_trait>( &'life0 self, last_included: LogId, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Physically removes log entries up to specified index (inclusive)

Arguments

• last_included The last log index included in the latest snapshot

Implementation Notes

• Should be atomic with updating last_purged_index
• Must not delete any entries required for log matching properties

fn validate_purge<'life0, 'async_trait>( &'life0 self, last_included: LogId, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Validates if purge can be safely executed

Key Characteristics

• Stateless: Does NOT validate Raft protocol state (commit index/purge order/cluster progress)
• Storage-focused: Performs physical storage checks (disk space/snapshot integrity/I/O health)

Default implementation checks:

• No pending purge operations

fn pre_purge<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lifecycle hook before purge execution

Use for:

• Acquiring resource locks
• Starting transactions

fn post_purge<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lifecycle hook after purge execution

Use for:

• Releasing resource locks
• Finalizing transactions
• Triggering backups