fhirkit 0.1.0

FHIR R4 for Rust: typed models for every resource and datatype generated from the official specification, lossless JSON with path-precise validation, typed search queries, FHIRPath
Documentation
// @generated by fhirkit-gen from hl7.fhir.r4.core 4.0.1. Do not edit.
//! The FHIR R4 `EvidenceVariable` resource.

#![allow(
    unused_imports,
    clippy::large_enum_variant,
    clippy::too_many_lines,
    clippy::doc_markdown
)]

use crate::decode::{
    choice_key, required, required_list, resource_type, Choice, Decoder, FhirJson, Obj, ObjWriter,
};
use crate::json::Json;
use crate::primitive::{Decimal, Kind, Primitive};
use crate::r4::*;

/// The EvidenceVariable resource describes a "PICO" element that knowledge (evidence, assertion, recommendation) is about.
///
/// FHIR path: `EvidenceVariable`.
#[cfg(feature = "specialized")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct EvidenceVariable {
    /// `id` (0..1): Logical id of this artifact
    pub id: Option<String>,
    /// `meta` (0..1): Metadata about the resource
    pub meta: Option<Meta>,
    /// `implicitRules` (0..1): A set of rules under which this content was created
    pub implicit_rules: Option<Primitive<String>>,
    /// `language` (0..1): Language of the resource content
    pub language: Option<Primitive<String>>,
    /// `text` (0..1): Text summary of the resource, for human interpretation
    pub text: Option<Narrative>,
    /// `contained` (0..*): Contained, inline Resources
    pub contained: Vec<Resource>,
    /// `extension` (0..*): Additional content defined by implementations
    pub extension: Vec<Extension>,
    /// `modifierExtension` (0..*): Extensions that cannot be ignored
    pub modifier_extension: Vec<Extension>,
    /// `url` (0..1): Canonical identifier for this evidence variable, represented as a URI (globally unique)
    pub url: Option<Primitive<String>>,
    /// `identifier` (0..*): Additional identifier for the evidence variable
    pub identifier: Vec<Identifier>,
    /// `version` (0..1): Business version of the evidence variable
    pub version: Option<Primitive<String>>,
    /// `name` (0..1): Name for this evidence variable (computer friendly)
    pub name: Option<Primitive<String>>,
    /// `title` (0..1): Name for this evidence variable (human friendly)
    pub title: Option<Primitive<String>>,
    /// `shortTitle` (0..1): Title for use in informal contexts
    pub short_title: Option<Primitive<String>>,
    /// `subtitle` (0..1): Subordinate title of the EvidenceVariable
    pub subtitle: Option<Primitive<String>>,
    /// `status` (1..1): draft | active | retired | unknown
    pub status: Option<Primitive<String>>,
    /// `date` (0..1): Date last changed
    pub date: Option<Primitive<String>>,
    /// `publisher` (0..1): Name of the publisher (organization or individual)
    pub publisher: Option<Primitive<String>>,
    /// `contact` (0..*): Contact details for the publisher
    pub contact: Vec<ContactDetail>,
    /// `description` (0..1): Natural language description of the evidence variable
    pub description: Option<Primitive<String>>,
    /// `note` (0..*): Used for footnotes or explanatory notes
    pub note: Vec<Annotation>,
    /// `useContext` (0..*): The context that the content is intended to support
    pub use_context: Vec<UsageContext>,
    /// `jurisdiction` (0..*): Intended jurisdiction for evidence variable (if applicable)
    pub jurisdiction: Vec<CodeableConcept>,
    /// `copyright` (0..1): Use and/or publishing restrictions
    pub copyright: Option<Primitive<String>>,
    /// `approvalDate` (0..1): When the evidence variable was approved by publisher
    pub approval_date: Option<Primitive<String>>,
    /// `lastReviewDate` (0..1): When the evidence variable was last reviewed
    pub last_review_date: Option<Primitive<String>>,
    /// `effectivePeriod` (0..1): When the evidence variable is expected to be used
    pub effective_period: Option<Period>,
    /// `topic` (0..*): The category of the EvidenceVariable, such as Education, Treatment, Assessment, etc.
    pub topic: Vec<CodeableConcept>,
    /// `author` (0..*): Who authored the content
    pub author: Vec<ContactDetail>,
    /// `editor` (0..*): Who edited the content
    pub editor: Vec<ContactDetail>,
    /// `reviewer` (0..*): Who reviewed the content
    pub reviewer: Vec<ContactDetail>,
    /// `endorser` (0..*): Who endorsed the content
    pub endorser: Vec<ContactDetail>,
    /// `relatedArtifact` (0..*): Additional documentation, citations, etc.
    pub related_artifact: Vec<RelatedArtifact>,
    /// `type` (0..1): dichotomous | continuous | descriptive
    pub type_: Option<Primitive<String>>,
    /// `characteristic` (1..*): What defines the members of the evidence element
    pub characteristic: Vec<EvidenceVariableCharacteristic>,
}

#[cfg(feature = "specialized")]
impl FhirJson for EvidenceVariable {
    const TYPE_NAME: &'static str = "EvidenceVariable";

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        resource_type(&mut o, d, "EvidenceVariable");
        let r = EvidenceVariable {
            id: o.string(d, "id"),
            meta: o.one(d, "meta"),
            implicit_rules: o.prim(d, "implicitRules", Kind::Uri),
            language: o.prim(d, "language", Kind::Code),
            text: o.one(d, "text"),
            contained: o.list(d, "contained"),
            extension: o.list(d, "extension"),
            modifier_extension: o.list(d, "modifierExtension"),
            url: o.prim(d, "url", Kind::Uri),
            identifier: o.list(d, "identifier"),
            version: o.prim(d, "version", Kind::String),
            name: o.prim(d, "name", Kind::String),
            title: o.prim(d, "title", Kind::String),
            short_title: o.prim(d, "shortTitle", Kind::String),
            subtitle: o.prim(d, "subtitle", Kind::String),
            status: o.prim(d, "status", Kind::Code),
            date: o.prim(d, "date", Kind::DateTime),
            publisher: o.prim(d, "publisher", Kind::String),
            contact: o.list(d, "contact"),
            description: o.prim(d, "description", Kind::Markdown),
            note: o.list(d, "note"),
            use_context: o.list(d, "useContext"),
            jurisdiction: o.list(d, "jurisdiction"),
            copyright: o.prim(d, "copyright", Kind::Markdown),
            approval_date: o.prim(d, "approvalDate", Kind::Date),
            last_review_date: o.prim(d, "lastReviewDate", Kind::Date),
            effective_period: o.one(d, "effectivePeriod"),
            topic: o.list(d, "topic"),
            author: o.list(d, "author"),
            editor: o.list(d, "editor"),
            reviewer: o.list(d, "reviewer"),
            endorser: o.list(d, "endorser"),
            related_artifact: o.list(d, "relatedArtifact"),
            type_: o.prim(d, "type", Kind::Code),
            characteristic: o.list(d, "characteristic"),
        };
        required(d, "status", &r.status);
        required_list(d, "characteristic", &r.characteristic, 1);
        o.finish(d);
        Some(r)
    }

    fn encode(&self) -> Json {
        let mut w = ObjWriter::new();
        w.raw("resourceType", Json::String("EvidenceVariable".into()));
        w.string("id", &self.id);
        w.one("meta", &self.meta);
        w.prim("implicitRules", &self.implicit_rules);
        w.prim("language", &self.language);
        w.one("text", &self.text);
        w.list("contained", &self.contained);
        w.list("extension", &self.extension);
        w.list("modifierExtension", &self.modifier_extension);
        w.prim("url", &self.url);
        w.list("identifier", &self.identifier);
        w.prim("version", &self.version);
        w.prim("name", &self.name);
        w.prim("title", &self.title);
        w.prim("shortTitle", &self.short_title);
        w.prim("subtitle", &self.subtitle);
        w.prim("status", &self.status);
        w.prim("date", &self.date);
        w.prim("publisher", &self.publisher);
        w.list("contact", &self.contact);
        w.prim("description", &self.description);
        w.list("note", &self.note);
        w.list("useContext", &self.use_context);
        w.list("jurisdiction", &self.jurisdiction);
        w.prim("copyright", &self.copyright);
        w.prim("approvalDate", &self.approval_date);
        w.prim("lastReviewDate", &self.last_review_date);
        w.one("effectivePeriod", &self.effective_period);
        w.list("topic", &self.topic);
        w.list("author", &self.author);
        w.list("editor", &self.editor);
        w.list("reviewer", &self.reviewer);
        w.list("endorser", &self.endorser);
        w.list("relatedArtifact", &self.related_artifact);
        w.prim("type", &self.type_);
        w.list("characteristic", &self.characteristic);
        w.finish()
    }
}

/// What defines the members of the evidence element
///
/// FHIR path: `EvidenceVariable.characteristic`.
#[cfg(feature = "specialized")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct EvidenceVariableCharacteristic {
    /// `id` (0..1): Unique id for inter-element referencing
    pub id: Option<String>,
    /// `extension` (0..*): Additional content defined by implementations
    pub extension: Vec<Extension>,
    /// `modifierExtension` (0..*): Extensions that cannot be ignored even if unrecognized
    pub modifier_extension: Vec<Extension>,
    /// `description` (0..1): Natural language description of the characteristic
    pub description: Option<Primitive<String>>,
    /// `definition[x]` (1..1): What code or expression defines members?
    pub definition: Option<EvidenceVariableCharacteristicDefinition>,
    /// `usageContext` (0..*): What code/value pairs define members?
    pub usage_context: Vec<UsageContext>,
    /// `exclude` (0..1): Whether the characteristic includes or excludes members
    pub exclude: Option<Primitive<bool>>,
    /// `participantEffective[x]` (0..1): What time period do participants cover
    pub participant_effective: Option<EvidenceVariableCharacteristicParticipantEffective>,
    /// `timeFromStart` (0..1): Observation time from study start
    pub time_from_start: Option<Duration>,
    /// `groupMeasure` (0..1): mean | median | mean-of-mean | mean-of-median | median-of-mean | median-of-median
    pub group_measure: Option<Primitive<String>>,
}

#[cfg(feature = "specialized")]
impl FhirJson for EvidenceVariableCharacteristic {
    const TYPE_NAME: &'static str = "EvidenceVariableCharacteristic";

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        let r = EvidenceVariableCharacteristic {
            id: o.string(d, "id"),
            extension: o.list(d, "extension"),
            modifier_extension: o.list(d, "modifierExtension"),
            description: o.prim(d, "description", Kind::String),
            definition: o.choice(d, "definition"),
            usage_context: o.list(d, "usageContext"),
            exclude: o.prim(d, "exclude", Kind::Boolean),
            participant_effective: o.choice(d, "participantEffective"),
            time_from_start: o.one(d, "timeFromStart"),
            group_measure: o.prim(d, "groupMeasure", Kind::Code),
        };
        required(d, "definition[x]", &r.definition);
        o.finish(d);
        Some(r)
    }

    fn encode(&self) -> Json {
        let mut w = ObjWriter::new();
        w.string("id", &self.id);
        w.list("extension", &self.extension);
        w.list("modifierExtension", &self.modifier_extension);
        w.prim("description", &self.description);
        w.choice("definition", &self.definition);
        w.list("usageContext", &self.usage_context);
        w.prim("exclude", &self.exclude);
        w.choice("participantEffective", &self.participant_effective);
        w.one("timeFromStart", &self.time_from_start);
        w.prim("groupMeasure", &self.group_measure);
        w.finish()
    }
}

/// The types `EvidenceVariable.characteristic.definition[x]` allows.
#[cfg(feature = "specialized")]
#[derive(Debug, Clone, PartialEq)]
pub enum EvidenceVariableCharacteristicDefinition {
    /// `Reference`
    Reference(Reference),
    /// `canonical`
    Canonical(Primitive<String>),
    /// `CodeableConcept`
    CodeableConcept(CodeableConcept),
    /// `Expression`
    Expression(Expression),
    /// `DataRequirement`
    DataRequirement(DataRequirement),
    /// `TriggerDefinition`
    TriggerDefinition(TriggerDefinition),
}

#[cfg(feature = "specialized")]
impl Choice for EvidenceVariableCharacteristicDefinition {
    const TYPES: &'static [&'static str] = &[
        "Reference",
        "canonical",
        "CodeableConcept",
        "Expression",
        "DataRequirement",
        "TriggerDefinition",
    ];

    fn decode_as(code: &str, key: &str, o: &mut Obj<'_>, d: &mut Decoder) -> Option<Self> {
        match code {
            "Reference" => o.one(d, key).map(Self::Reference),
            "canonical" => o.prim(d, key, Kind::Canonical).map(Self::Canonical),
            "CodeableConcept" => o.one(d, key).map(Self::CodeableConcept),
            "Expression" => o.one(d, key).map(Self::Expression),
            "DataRequirement" => o.one(d, key).map(Self::DataRequirement),
            "TriggerDefinition" => o.one(d, key).map(Self::TriggerDefinition),
            _ => None,
        }
    }

    fn encode_into(&self, base: &str, w: &mut ObjWriter) {
        match self {
            Self::Reference(v) => w.value(&choice_key(base, "Reference"), v),
            Self::Canonical(v) => w.prim_value(&choice_key(base, "canonical"), v),
            Self::CodeableConcept(v) => w.value(&choice_key(base, "CodeableConcept"), v),
            Self::Expression(v) => w.value(&choice_key(base, "Expression"), v),
            Self::DataRequirement(v) => w.value(&choice_key(base, "DataRequirement"), v),
            Self::TriggerDefinition(v) => w.value(&choice_key(base, "TriggerDefinition"), v),
        }
    }
}

/// The types `EvidenceVariable.characteristic.participantEffective[x]` allows.
#[cfg(feature = "specialized")]
#[derive(Debug, Clone, PartialEq)]
pub enum EvidenceVariableCharacteristicParticipantEffective {
    /// `dateTime`
    DateTime(Primitive<String>),
    /// `Period`
    Period(Period),
    /// `Duration`
    Duration(Duration),
    /// `Timing`
    Timing(Timing),
}

#[cfg(feature = "specialized")]
impl Choice for EvidenceVariableCharacteristicParticipantEffective {
    const TYPES: &'static [&'static str] = &["dateTime", "Period", "Duration", "Timing"];

    fn decode_as(code: &str, key: &str, o: &mut Obj<'_>, d: &mut Decoder) -> Option<Self> {
        match code {
            "dateTime" => o.prim(d, key, Kind::DateTime).map(Self::DateTime),
            "Period" => o.one(d, key).map(Self::Period),
            "Duration" => o.one(d, key).map(Self::Duration),
            "Timing" => o.one(d, key).map(Self::Timing),
            _ => None,
        }
    }

    fn encode_into(&self, base: &str, w: &mut ObjWriter) {
        match self {
            Self::DateTime(v) => w.prim_value(&choice_key(base, "dateTime"), v),
            Self::Period(v) => w.value(&choice_key(base, "Period"), v),
            Self::Duration(v) => w.value(&choice_key(base, "Duration"), v),
            Self::Timing(v) => w.value(&choice_key(base, "Timing"), v),
        }
    }
}