Struct DoubleCheckedLockReadyBuilder 

pub struct DoubleCheckedLockReadyBuilder<L, T> { /* private fields */ }

Convenience builder state with tester attached.

Implementations

impl<L, T> DoubleCheckedLockReadyBuilder<L, T>

where L: Lock<T>,

pub fn log_unmet_condition( self, level: Level, message: impl Into<String>, ) -> Self

Configures logging when the double-checked condition is not met.

Parameters

• level - Log level used for unmet-condition messages.
• message - Full log message emitted when the condition is not met.

Returns

This builder with unmet-condition logging configured.

pub fn disable_unmet_condition_logging(self) -> Self

Disables logging when the double-checked condition is not met.

Returns

This builder with unmet-condition logging disabled.

pub fn log_prepare_failure( self, level: Level, message_prefix: impl Into<String>, ) -> Self

Configures logging when the prepare action fails.

Parameters

• level - Log level used for prepare failure messages.
• message_prefix - Prefix placed before the prepare failure text.

Returns

This builder with prepare failure logging configured.

pub fn disable_prepare_failure_logging(self) -> Self

Disables logging when the prepare action fails.

Returns

This builder with prepare failure logging disabled.

pub fn log_prepare_commit_failure( self, level: Level, message_prefix: impl Into<String>, ) -> Self

Configures logging when the prepare commit action fails.

Parameters

• level - Log level used for prepare-commit failure messages.
• message_prefix - Prefix placed before the prepare-commit failure text.

Returns

This builder with prepare-commit failure logging configured.

pub fn disable_prepare_commit_failure_logging(self) -> Self

Disables logging when the prepare commit action fails.

Returns

This builder with prepare-commit failure logging disabled.

pub fn log_prepare_rollback_failure( self, level: Level, message_prefix: impl Into<String>, ) -> Self

Configures logging when the prepare rollback action fails.

Parameters

• level - Log level used for prepare-rollback failure messages.
• message_prefix - Prefix placed before the prepare-rollback failure text.

Returns

This builder with prepare-rollback failure logging configured.

pub fn disable_prepare_rollback_failure_logging(self) -> Self

Disables logging when the prepare rollback action fails.

Returns

This builder with prepare-rollback failure logging disabled.

pub fn catch_panics(self) -> Self

Enables panic capture for tester, prepare callbacks, and task execution.

Returns

This builder with panic capture enabled.

pub fn with_panic_capture(self, catch_panics: bool) -> Self

Derives a builder with panic capture enabled or disabled for tester, prepare callbacks, and task execution.

Parameters

• catch_panics - true to capture panics as execution errors, or false to let panics unwind.

Returns

A reconfigured builder with the updated panic-capture setting.

pub fn disable_catch_panics(self) -> Self

Disables panic capture for tester, prepare callbacks, and task execution.

Returns

This builder with panic capture disabled.

pub fn prepare<Rn, E>(self, prepare_action: Rn) -> Self

where Rn: Runnable<E> + Send + 'static, E: Display,

Sets the prepare action.

Parameters

• prepare_action - Fallible action to run after the first condition check and before locking.

Returns

This builder with prepare configured.

Errors

This builder method does not return errors. If prepare_action later returns an error during execution, the execution result becomes super::ExecutionResult::Failed with super::ExecutorError::PrepareFailed.

pub fn rollback_prepare<Rn, E>(self, rollback_prepare_action: Rn) -> Self

where Rn: Runnable<E> + Send + 'static, E: Display,

Sets the rollback action for prepare.

Parameters

• rollback_prepare_action - Fallible action to run when prepare completed but the second condition check or task fails.

Returns

This builder with prepare rollback configured.

Errors

This builder method does not return errors. If rollback_prepare_action later returns an error during execution, the execution result becomes super::ExecutionResult::Failed with super::ExecutorError::PrepareRollbackFailed.

pub fn commit_prepare<Rn, E>(self, commit_prepare_action: Rn) -> Self

where Rn: Runnable<E> + Send + 'static, E: Display,

Sets the commit action for prepare.

Parameters

• commit_prepare_action - Fallible action to run when prepare completed and the task succeeds.

Returns

This builder with prepare commit configured.

Errors

This builder method does not return errors. If commit_prepare_action later returns an error during execution, the execution result becomes super::ExecutionResult::Failed with super::ExecutorError::PrepareCommitFailed.

pub fn build(self) -> DoubleCheckedLockExecutor<L, T>

Builds a reusable DoubleCheckedLockExecutor.

Returns

A reusable executor containing the configured lock, tester, logger, and prepare lifecycle callbacks.

pub fn call<C, R, E>(self, task: C) -> ExecutionContext<R, E>

where C: Callable<R, E>, E: Display,

Runs a callable task with one-shot executor creation.

Parameters

• task - Zero-argument callable executed after both condition checks pass.

Returns

An ExecutionContext containing success, unmet-condition, or failure information.

pub fn execute<Rn, E>(self, task: Rn) -> ExecutionContext<(), E>

where Rn: Runnable<E>, E: Display,

Runs a runnable task with one-shot executor creation.

Parameters

• task - Zero-argument runnable executed after both condition checks pass.

Returns

An ExecutionContext containing success, unmet-condition, or failure information.

pub fn call_with<C, R, E>(self, task: C) -> ExecutionContext<R, E>

where C: CallableWith<T, R, E>, E: Display,

Runs a callable task with mutable protected data.

Parameters

• task - Callable receiving &mut T after both condition checks pass.

Returns

An ExecutionContext containing success, unmet-condition, or failure information.

pub fn execute_with<Rn, E>(self, task: Rn) -> ExecutionContext<(), E>

where Rn: RunnableWith<T, E>, E: Display,

Runs a runnable task with mutable protected data.

Parameters

• task - Runnable receiving &mut T after both condition checks pass.

Returns

An ExecutionContext containing success, unmet-condition, or failure information.

Trait Implementations

impl<L: Clone, T: Clone> Clone for DoubleCheckedLockReadyBuilder<L, T>

fn clone(&self) -> DoubleCheckedLockReadyBuilder<L, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.