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 `MedicationAdministration` 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::*;

/// Describes the event of a patient consuming or otherwise being administered a medication. This may be as simple as swallowing a tablet or it may be a long running infusion. Related resources tie this event to the authorizing prescription, and the specific encounter between patient and health care practitioner.
///
/// FHIR path: `MedicationAdministration`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct MedicationAdministration {
    /// `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>,
    /// `identifier` (0..*): External identifier
    pub identifier: Vec<Identifier>,
    /// `instantiates` (0..*): Instantiates protocol or definition
    pub instantiates: Vec<Primitive<String>>,
    /// `partOf` (0..*): Part of referenced event
    pub part_of: Vec<Reference>,
    /// `status` (1..1): in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown
    pub status: Option<Primitive<String>>,
    /// `statusReason` (0..*): Reason administration not performed
    pub status_reason: Vec<CodeableConcept>,
    /// `category` (0..1): Type of medication usage
    pub category: Option<CodeableConcept>,
    /// `medication[x]` (1..1): What was administered
    pub medication: Option<MedicationAdministrationMedication>,
    /// `subject` (1..1): Who received medication
    pub subject: Option<Reference>,
    /// `context` (0..1): Encounter or Episode of Care administered as part of
    pub context: Option<Reference>,
    /// `supportingInformation` (0..*): Additional information to support administration
    pub supporting_information: Vec<Reference>,
    /// `effective[x]` (1..1): Start and end time of administration
    pub effective: Option<MedicationAdministrationEffective>,
    /// `performer` (0..*): Who performed the medication administration and what they did
    pub performer: Vec<MedicationAdministrationPerformer>,
    /// `reasonCode` (0..*): Reason administration performed
    pub reason_code: Vec<CodeableConcept>,
    /// `reasonReference` (0..*): Condition or observation that supports why the medication was administered
    pub reason_reference: Vec<Reference>,
    /// `request` (0..1): Request administration performed against
    pub request: Option<Reference>,
    /// `device` (0..*): Device used to administer
    pub device: Vec<Reference>,
    /// `note` (0..*): Information about the administration
    pub note: Vec<Annotation>,
    /// `dosage` (0..1): Details of how medication was taken
    pub dosage: Option<MedicationAdministrationDosage>,
    /// `eventHistory` (0..*): A list of events of interest in the lifecycle
    pub event_history: Vec<Reference>,
}

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

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        resource_type(&mut o, d, "MedicationAdministration");
        let r = MedicationAdministration {
            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"),
            identifier: o.list(d, "identifier"),
            instantiates: o.prim_list(d, "instantiates", Kind::Uri),
            part_of: o.list(d, "partOf"),
            status: o.prim(d, "status", Kind::Code),
            status_reason: o.list(d, "statusReason"),
            category: o.one(d, "category"),
            medication: o.choice(d, "medication"),
            subject: o.one(d, "subject"),
            context: o.one(d, "context"),
            supporting_information: o.list(d, "supportingInformation"),
            effective: o.choice(d, "effective"),
            performer: o.list(d, "performer"),
            reason_code: o.list(d, "reasonCode"),
            reason_reference: o.list(d, "reasonReference"),
            request: o.one(d, "request"),
            device: o.list(d, "device"),
            note: o.list(d, "note"),
            dosage: o.one(d, "dosage"),
            event_history: o.list(d, "eventHistory"),
        };
        required(d, "status", &r.status);
        required(d, "medication[x]", &r.medication);
        required(d, "subject", &r.subject);
        required(d, "effective[x]", &r.effective);
        o.finish(d);
        Some(r)
    }

    fn encode(&self) -> Json {
        let mut w = ObjWriter::new();
        w.raw(
            "resourceType",
            Json::String("MedicationAdministration".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.list("identifier", &self.identifier);
        w.prim_list("instantiates", &self.instantiates);
        w.list("partOf", &self.part_of);
        w.prim("status", &self.status);
        w.list("statusReason", &self.status_reason);
        w.one("category", &self.category);
        w.choice("medication", &self.medication);
        w.one("subject", &self.subject);
        w.one("context", &self.context);
        w.list("supportingInformation", &self.supporting_information);
        w.choice("effective", &self.effective);
        w.list("performer", &self.performer);
        w.list("reasonCode", &self.reason_code);
        w.list("reasonReference", &self.reason_reference);
        w.one("request", &self.request);
        w.list("device", &self.device);
        w.list("note", &self.note);
        w.one("dosage", &self.dosage);
        w.list("eventHistory", &self.event_history);
        w.finish()
    }
}

/// Who performed the medication administration and what they did
///
/// FHIR path: `MedicationAdministration.performer`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct MedicationAdministrationPerformer {
    /// `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>,
    /// `function` (0..1): Type of performance
    pub function: Option<CodeableConcept>,
    /// `actor` (1..1): Who performed the medication administration
    pub actor: Option<Reference>,
}

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

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        let r = MedicationAdministrationPerformer {
            id: o.string(d, "id"),
            extension: o.list(d, "extension"),
            modifier_extension: o.list(d, "modifierExtension"),
            function: o.one(d, "function"),
            actor: o.one(d, "actor"),
        };
        required(d, "actor", &r.actor);
        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.one("function", &self.function);
        w.one("actor", &self.actor);
        w.finish()
    }
}

/// Details of how medication was taken
///
/// FHIR path: `MedicationAdministration.dosage`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct MedicationAdministrationDosage {
    /// `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>,
    /// `text` (0..1): Free text dosage instructions e.g. SIG
    pub text: Option<Primitive<String>>,
    /// `site` (0..1): Body site administered to
    pub site: Option<CodeableConcept>,
    /// `route` (0..1): Path of substance into body
    pub route: Option<CodeableConcept>,
    /// `method` (0..1): How drug was administered
    pub method: Option<CodeableConcept>,
    /// `dose` (0..1): Amount of medication per dose
    pub dose: Option<Quantity>,
    /// `rate[x]` (0..1): Dose quantity per unit of time
    pub rate: Option<MedicationAdministrationDosageRate>,
}

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

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        let r = MedicationAdministrationDosage {
            id: o.string(d, "id"),
            extension: o.list(d, "extension"),
            modifier_extension: o.list(d, "modifierExtension"),
            text: o.prim(d, "text", Kind::String),
            site: o.one(d, "site"),
            route: o.one(d, "route"),
            method: o.one(d, "method"),
            dose: o.one(d, "dose"),
            rate: o.choice(d, "rate"),
        };
        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("text", &self.text);
        w.one("site", &self.site);
        w.one("route", &self.route);
        w.one("method", &self.method);
        w.one("dose", &self.dose);
        w.choice("rate", &self.rate);
        w.finish()
    }
}

/// The types `MedicationAdministration.medication[x]` allows.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq)]
pub enum MedicationAdministrationMedication {
    /// `CodeableConcept`
    CodeableConcept(CodeableConcept),
    /// `Reference`
    Reference(Reference),
}

#[cfg(feature = "clinical")]
impl Choice for MedicationAdministrationMedication {
    const TYPES: &'static [&'static str] = &["CodeableConcept", "Reference"];

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

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

/// The types `MedicationAdministration.effective[x]` allows.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq)]
pub enum MedicationAdministrationEffective {
    /// `dateTime`
    DateTime(Primitive<String>),
    /// `Period`
    Period(Period),
}

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

    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),
            _ => 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),
        }
    }
}

/// The types `MedicationAdministration.dosage.rate[x]` allows.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq)]
pub enum MedicationAdministrationDosageRate {
    /// `Ratio`
    Ratio(Ratio),
    /// `Quantity`
    Quantity(Quantity),
}

#[cfg(feature = "clinical")]
impl Choice for MedicationAdministrationDosageRate {
    const TYPES: &'static [&'static str] = &["Ratio", "Quantity"];

    fn decode_as(code: &str, key: &str, o: &mut Obj<'_>, d: &mut Decoder) -> Option<Self> {
        match code {
            "Ratio" => o.one(d, key).map(Self::Ratio),
            "Quantity" => o.one(d, key).map(Self::Quantity),
            _ => None,
        }
    }

    fn encode_into(&self, base: &str, w: &mut ObjWriter) {
        match self {
            Self::Ratio(v) => w.value(&choice_key(base, "Ratio"), v),
            Self::Quantity(v) => w.value(&choice_key(base, "Quantity"), v),
        }
    }
}