Struct Task 

pub struct Task { /* private fields */ }

A unit of deferred work.

Tasks encapsulate a closure to be executed later by the scheduler. Each task has a unique ID, priority, and execution state.

Example

use reovim_kernel::api::v1::*;

// Create a high-priority task with a name
let mut task = Task::with_priority(Priority::HIGH, || println!("Hello!"))
    .with_name("greeting");

assert_eq!(task.state(), TaskState::Pending);
assert_eq!(task.priority(), Priority::HIGH);

// Execute the task
let result = task.execute();
assert!(result.is_ok());
assert_eq!(task.state(), TaskState::Completed);

Implementations

impl Task

pub fn new<F>(work: F) -> Self

where F: FnOnce() + Send + 'static,

Create a new task with normal priority.

pub fn with_priority<F>(priority: Priority, work: F) -> Self

where F: FnOnce() + Send + 'static,

Create a task with specific priority.

pub const fn with_name(self, name: &'static str) -> Self

Set the task name for debugging.

pub const fn id(&self) -> TaskId

Get the task ID.

pub const fn priority(&self) -> Priority

Get the task priority.

pub const fn state(&self) -> TaskState

Get the current state.

pub const fn name(&self) -> Option<&'static str>

Get the task name (if set).

pub const fn is_executable(&self) -> bool

Check if the task can still be executed.

pub fn execute(&mut self) -> Result<(), &'static str>

Execute the task.

Consumes the work closure and transitions state to Completed.

Errors

Returns an error if:

• Task has already been executed
• Task was cancelled (work is None)

pub fn mark_failed(&mut self)

Mark the task as failed.

Used by the executor when a panic is caught during execution.

pub fn cancel(&mut self)

Cancel the task.

Removes the work closure without executing it.

Trait Implementations

impl Debug for Task

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

Formats the value using the given formatter.