Struct Task

pub struct Task { /* private fields */ }

A scheduled task that can be executed

This struct represents a task in the scheduler, containing all the information needed to execute the task at the appropriate time and track its status.

Fields

• id - Unique identifier for the task
• name - Human-readable name of the task
• task_name - Name of the function being executed
• task - The actual function to execute
• next_run - When the task should next execute
• last_run - When the task last executed
• interval - Time between executions
• status - Current execution status
• retries - Number of retry attempts remaining
• created_at - When the task was created

Implementations

impl Task

pub fn new<F>( name: String, task_name: String, task: F, next_run: Option<DateTime<Utc>>, interval: Option<Duration>, retries: u32, ) -> Self

where F: Fn() -> Result<(), SchedulerError> + Send + Sync + 'static,

Creates a new task with the specified parameters

Arguments

• name - Human-readable name for the task
• task_name - Name of the function being executed
• task - The function to execute
• next_run - Optional next execution time
• interval - Optional interval between executions
• retries - Number of retry attempts allowed

Returns

A new Task instance configured with the provided parameters

pub async fn execute(&mut self) -> Result<(), SchedulerError>

Executes the task and updates its status

This method runs the task function and handles any errors that occur, including retry logic if configured.

Returns

• Ok(()) if the task executed successfully
• Err(SchedulerError) if the task failed and retries were exhausted

pub fn is_due(&self) -> bool

Checks if the task is due for execution

Returns

true if the task should be executed now, false otherwise

pub async fn get_status(&self) -> TaskStatus

Gets the current status of the task

Returns

The current TaskStatus

pub fn get_name(&self) -> &str

Gets the human-readable name of the task

Returns

The task’s name as a string slice

pub fn get_task_name(&self) -> &str

Gets the name of the function being executed

Returns

The task function’s name as a string slice

pub fn id(&self) -> &str

Gets the task’s unique identifier

Returns

The task’s ID as a string slice

pub fn name(&self) -> &str

Gets the task’s human-readable name

Returns

The task’s name as a string slice

Trait Implementations

impl Clone for Task

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 Task

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

Formats the value using the given formatter.