Enum TimeEventCallback 

pub enum TimeEventCallback {
    Python(Arc<PythonTimeEventCallback>),
    Rust(Arc<dyn Fn(TimeEvent) + Send + Sync>),
    RustLocal(Rc<dyn Fn(TimeEvent)>),
}

Represents a callback invoked for time events.

Variants

• Python: For Python callbacks (requires python feature).
• Rust: Thread-safe callbacks using Arc. Use when the closure is Send + Sync.
• RustLocal: Single-threaded callbacks using Rc. Use when capturing Rc<RefCell<...>>.

Choosing Between Rust and RustLocal

Use Rust (thread-safe) when:

• The callback does not capture Rc<RefCell<...>> or other non-Send types.
• The closure is Send + Sync (most simple closures qualify).

Use RustLocal when:

• The callback captures Rc<RefCell<...>> for shared mutable state.
• Thread safety constraints prevent using Arc.

RustLocal works with TestClock and with LiveClock when its event channel is drained on the callback’s originating thread.

Automatic Conversion

• Closures that are Fn + Send + Sync + 'static automatically convert to Rust.
• Rc<dyn Fn(TimeEvent)> converts to RustLocal.
• Arc<dyn Fn(TimeEvent) + Send + Sync> converts to Rust.

Variants

Python(Arc<PythonTimeEventCallback>)

Python callable for use from Python via PyO3.

Rust(Arc<dyn Fn(TimeEvent) + Send + Sync>)

Thread-safe Rust callback using Arc (Send + Sync).

RustLocal(Rc<dyn Fn(TimeEvent)>)

Local Rust callback using Rc (not Send/Sync).

Implementations

impl TimeEventCallback

pub const fn is_local(&self) -> bool

Returns true if this is a local (non-thread-safe) Rust callback.

Local callbacks use Rc internally and require creation, cloning, dropping, and invocation to stay on the originating thread.

pub fn call(&self, event: TimeEvent)

Invokes the callback for the given TimeEvent.

For Python callbacks, exceptions are logged as errors rather than panicking.

Panics

Panics from Rust callbacks propagate to the caller.

impl TimeEventCallback

pub fn from_python_time_event(callback: Py<PyAny>) -> Self

Creates a Python callback that receives a PyO3 TimeEvent.

Trait Implementations

impl Clone for TimeEventCallback

fn clone(&self) -> TimeEventCallback

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeEventCallback

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

Formats the value using the given formatter.

impl From<Arc<dyn Fn(TimeEvent) + Send + Sync>> for TimeEventCallback

fn from(value: Arc<dyn Fn(TimeEvent) + Send + Sync>) -> Self

Converts to this type from the input type.

impl<F> From<F> for TimeEventCallback

where F: Fn(TimeEvent) + Send + Sync + 'static,

fn from(value: F) -> Self

Converts to this type from the input type.

impl From<Py<PyAny>> for TimeEventCallback

Available on crate feature python only.

fn from(value: Py<PyAny>) -> Self

Converts to this type from the input type.

impl From<Rc<dyn Fn(TimeEvent)>> for TimeEventCallback

fn from(value: Rc<dyn Fn(TimeEvent)>) -> Self

Converts to this type from the input type.