Enum TimeEventCallback 

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

Callback type 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 doesn’t 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. With LiveClock, use it only for existing single-threaded callback paths; live timer callback registry dispatch is still pending.

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_rust(&self) -> bool

Returns true if this is a thread-safe Rust callback.

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.

impl TimeEventCallback

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

Creates a Python callback that receives a PyO3 TimeEvent.

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

Creates a legacy Python callback that receives a PyCapsule.

Trait Implementations

impl Clone for TimeEventCallback

fn clone(&self) -> Self

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) + Sync + Send>> 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.

impl Send for TimeEventCallback

impl Sync for TimeEventCallback