Struct TaskQuery 

pub struct TaskQuery { /* private fields */ }

Query parameters for filtered, snapshot-consistent Task listing.

Filtering is carried by TaskFilter. Pagination applies only to list operations.

Implementations

impl TaskQuery

pub fn new() -> Self

Creates an unfiltered query with default pagination.

Example

use solti_model::{DEFAULT_LIMIT, TaskPhase, TaskQuery};

let query = TaskQuery::new();
assert_eq!(query.limit(), DEFAULT_LIMIT);
assert!(query.matches_phase(&TaskPhase::Failed));

pub fn from_filter(filter: TaskFilter) -> Self

Creates a query from filters.

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

Filter by slot name.

pub fn with_phase(self, phase: TaskPhase) -> Self

Adds a phase filter.

Multiple calls accumulate with OR semantics.

pub fn with_phases(self, phases: impl IntoIterator<Item = TaskPhase>) -> Self

Adds phase filters from an iterator.

Values are deduplicated and retain OR semantics.

pub fn with_label_selector(self, selector: LabelSelector) -> ModelResult<Self>

Filter by labels.

Every selector requirement is ANDed. An empty selector matches all tasks.

Errors

Returns ModelError::Invalid when the selector is invalid.

pub fn with_active(self) -> Self

Filter by all active phases: Pending and Running.

pub fn with_terminal(self) -> Self

Filter by all terminal phases.

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

Sets the page size.

Zero selects DEFAULT_LIMIT. Values above MAX_LIMIT are capped.

pub fn with_continuation(self, continuation: TaskContinuation) -> Self

Continue a previously returned collection snapshot.

pub fn matches(&self, task: &Task) -> bool

Returns whether a task passes every filter.

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

Returns whether a phase passes the phase filter.

pub fn matches_labels(&self, labels: &Labels) -> bool

Returns whether labels pass the selector.

pub fn limit(&self) -> usize

Page size limit.

pub fn continuation(&self) -> Option<&TaskContinuation>

Continuation cursor, when this is not the first page.

pub fn filter(&self) -> &TaskFilter

Filters applied before pagination.

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

Slot filter (if any).

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

Phase filters.

pub fn label_selector(&self) -> &LabelSelector

Label selector.

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.

impl Eq for TaskQuery

impl PartialEq for TaskQuery

fn eq(&self, other: &TaskQuery) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TaskQuery