Struct Task 

pub struct Task {
    pub id: NativeId,
    pub title: String,
    pub content: Option<String>,
    pub status: Status,
    pub labels: Vec<Label>,
    pub project: Option<NativeId>,
    pub url: Option<String>,
    pub location: Option<Location>,
    pub created_at: Option<DateTime<Utc>>,
    pub updated_at: Option<DateTime<Utc>>,
    pub metadata: BTreeMap<String, Value>,
    pub repositories: Vec<Repository>,
}

One unit of work as a source reports it.

Fields

id: NativeId

The source’s own opaque identifier.

title: String

The one-line summary a user recognises the task by.

content: Option<String>

The long-form body, when the source has one.

status: Status

The source’s status, normalised and preserved.

labels: Vec<Label>

Inline rather than by id: a source returning a task already knows them.

project: Option<NativeId>

None is a first-class case — an orphan task — not an edge case.

url: Option<String>

Where a human can open this task.

location: Option<Location>

Where this task is, when the source says (see Location).

Absent by default, so a source that predates this field — and every source that simply does not say — reads as None, which means the source did not say where this is rather than this is nowhere. It neither replaces nor derives from url, which goes on meaning exactly what it always did.

created_at: Option<DateTime<Utc>>

When the source says the task was created.

updated_at: Option<DateTime<Utc>>

When the source says the task last changed.

metadata: BTreeMap<String, Value>

Caller-defined attributes, preserving their JSON types.

Keys are free-form, with two reserved prefixes: onetaskgraph. belongs to this product — Repository::METADATA_KEY and DependencyEdge::RECORDED_KEY are the two every source honours, and ItemKind::METADATA_KEY is one plugin’s — and onepipeline. belongs to that consumer. Every other key is the caller’s, and a source returns it exactly as it holds it.

repositories: Vec<Repository>

Normalized repository origins this task concerns, in source order and without repeats.

Trait Implementations

impl Clone for Task

fn clone(&self) -> Task

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.

impl<'de> Deserialize<'de> for Task

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Task

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 Task

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Task

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 Task