Struct FunctionHandle 

pub struct FunctionHandle<'a, O> { /* private fields */ }

Available on crate feature di and non-WebAssembly only.

A handle for managing function-based dependency overrides.

FunctionHandle provides a fluent API for setting overrides on specific injectable functions. This is useful in tests where you want to mock specific dependency factories while leaving others unaffected.

Type Parameters

• 'a - Lifetime of the borrowed InjectionContext
• O - The output type of the function (the dependency type)

Examples

use reinhardt_di::{InjectionContext, SingletonScope};
use std::sync::Arc;


let singleton = Arc::new(SingletonScope::new());
let ctx = InjectionContext::builder(singleton).build();

// Set override using fluent API
ctx.dependency(create_database).override_with(Database::mock());

Implementations

impl<'a, O> FunctionHandle<'a, O>

where O: Clone + Send + Sync + 'static,

pub fn override_with(&self, value: O) -> &FunctionHandle<'a, O>

Sets an override value for this function.

When the injectable function is invoked, this override value will be returned instead of calling the actual function implementation.

Arguments

• value - The value to return when this function is called

Returns

A reference to self for method chaining.

Examples

ctx.dependency(create_database)
   .override_with(mock_database);

pub fn clear_override(&self) -> &FunctionHandle<'a, O>

Clears the override for this function.

After calling this method, the actual function implementation will be used when resolving this dependency.

Returns

A reference to self for method chaining.

Examples

// Set override
ctx.dependency(create_database).override_with(mock_database);

// Later, clear it
ctx.dependency(create_database).clear_override();

pub fn has_override(&self) -> bool

Checks if an override exists for this function.

Returns

true if an override is set, false otherwise.

Examples

assert!(!ctx.dependency(create_database).has_override());
ctx.dependency(create_database).override_with(mock_database);
assert!(ctx.dependency(create_database).has_override());

pub fn get_override(&self) -> Option<O>

Gets the current override value for this function, if any.

Returns

Some(value) if an override is set, None otherwise.

Examples

ctx.dependency(create_database).override_with(mock_database.clone());
let value = ctx.dependency(create_database).get_override();
assert_eq!(value, Some(mock_database));

pub fn func_ptr(&self) -> usize

Returns the function pointer address for this handle.

This is primarily useful for debugging or advanced use cases.