Struct TaskQuery 

pub struct TaskQuery { /* private fields */ }

Query parameters for listing tasks with filtering and pagination.

 TaskQuery::new()
     .with_slot("build")      // filter by slot
     .with_active()           // Pending | Running
     .with_limit(50)
     .with_offset(0)
               │
               ▼  state.query(&q)
 TaskPage { items: [Task, ...], total: 123 }

An empty status filter matches all phases (no filtering). Multiple with_status calls accumulate with OR semantics.

Also

• TaskPage paginated result returned by state queries.
• TaskPhase phase values used as status filters.

Implementations

impl TaskQuery

pub fn new() -> Self

Create a new query with default pagination (limit=100, offset=0) and without filters.

pub fn with_slot(self, slot: impl Into<Slot>) -> Self

Filter by slot name.

pub fn with_status(self, status: TaskPhase) -> Self

Add a phase filter. Multiple calls accumulate (OR semantics).

pub fn with_active(self) -> Self

Filter by all active phases (Pending, Running).

pub fn with_terminal(self) -> Self

Filter by all terminal phases.

pub fn with_limit(self, limit: usize) -> Self

Set page size. Capped at 1000.

pub fn with_offset(self, offset: usize) -> Self

Set the starting offset for pagination.

pub fn matches_phase(&self, phase: &TaskPhase) -> bool

Returns true if the given phase passes the status filter.

An empty filter matches all phases.

pub fn limit(&self) -> usize

Page size limit.

pub fn offset(&self) -> usize

Starting offset for pagination.

pub fn slot(&self) -> Option<&Slot>

Slot filter (if any).

pub fn status_filters(&self) -> &[TaskPhase]

Status filters.

Trait Implementations

impl Clone for TaskQuery

fn clone(&self) -> TaskQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskQuery

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

Formats the value using the given formatter.

impl Default for TaskQuery

fn default() -> Self

Returns the “default value” for a type.