Enum Location 

pub enum Location {
    Url(String),
    Path(String),
}

Where an entity is, in the one form a consumer can act on without knowing the backend.

Externally tagged with exactly two variants, so the JSON is {"url": "https://…"} or {"path": "/home/…"} and a consumer tells them apart by which key is present. A reader handed one of these knows what to do with it — open a link, or print a path and read the file out — which is what a bare string could not have said.

It carries no third case on purpose. None on the field is the third case, and it means the source did not say where the entity is, which is not the same as saying it is nowhere.

This does not redefine, replace or derive from the url field of Task, Project or Document: a source that reports a web URL there goes on reporting it, and every existing consumer sees exactly what it saw.

Variants

Url(String)

The entity lives at an external website, and this is a link a reader can open.

Path(String)

The entity is a file on the machine the source runs on, and this is that file’s absolute path, so a reader can print the path or read the contents out.

Trait Implementations

impl Clone for Location

fn clone(&self) -> Location

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Location

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Location

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Location

impl Hash for Location

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for Location

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 Location

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Location

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 Location