Struct TaskQuery 

pub struct TaskQuery {
    pub text: Option<TextQuery>,
    pub labels: LabelFilter,
    pub statuses: Vec<StatusCategory>,
    pub project: ProjectFilter,
    pub priorities: Vec<Priority>,
    pub commented_since: Option<DateTime<Utc>>,
}

A filter over a source’s tasks.

Every field narrows; an empty or None field means unfiltered.

Fields

text: Option<TextQuery>

Free-text search, when the caller asked for one.

labels: LabelFilter

Label membership.

statuses: Vec<StatusCategory>

Status categories to keep. Empty means unfiltered.

project: ProjectFilter

Which project the task belongs to.

priorities: Vec<Priority>

Priorities to keep: a task matches when its priority is any one of these. Empty means unfiltered.

Defaulted when absent and left out of the wire when empty, so a plugin written before there were priorities reads exactly the query it read before — and, declaring no Capabilities::filter_by_priority, is never handed one it would have to ignore.

commented_since: Option<DateTime<Utc>>

Comment activity to keep: a task matches when at least one of its comments was created, or last edited, at or after this instant — its Comment::created_at or Comment::updated_at is at or after it. A task with no comments never matches, and a comment deleted before the query is not a match. None means unfiltered. An RFC 3339 string on the wire.

Defaulted when absent and left out of the wire when None, so a plugin written before there was comment activity reads exactly the query it read before — and, declaring no Capabilities::filter_by_comment_activity, is never handed one it would have to ignore.

Implementations

impl TaskQuery

pub fn comments_match<'a>( &self, comments: impl IntoIterator<Item = &'a Comment>, ) -> bool

Whether comments — one task’s — satisfy commented_since: always when the query carries no instant, and otherwise exactly when one of them was created or last edited at or after it.

The one statement of the predicate’s meaning, so a source applying it natively and the engine narrowing for a source that does not cannot answer the same store differently.

Trait Implementations

impl Clone for TaskQuery

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 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<'de> Deserialize<'de> for TaskQuery

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for TaskQuery

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for TaskQuery

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TaskQuery

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TaskQuery