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

/// An action that is or was performed on or for a patient. This can be a physical intervention like an operation, or less invasive like long term services, counseling, or hypnotherapy.
///
/// FHIR path: `Procedure`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct Procedure {
    /// `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 Identifiers for this procedure
    pub identifier: Vec<Identifier>,
    /// `instantiatesCanonical` (0..*): Instantiates FHIR protocol or definition
    pub instantiates_canonical: Vec<Primitive<String>>,
    /// `instantiatesUri` (0..*): Instantiates external protocol or definition
    pub instantiates_uri: Vec<Primitive<String>>,
    /// `basedOn` (0..*): A request for this procedure
    pub based_on: Vec<Reference>,
    /// `partOf` (0..*): Part of referenced event
    pub part_of: Vec<Reference>,
    /// `status` (1..1): preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown
    pub status: Option<Primitive<String>>,
    /// `statusReason` (0..1): Reason for current status
    pub status_reason: Option<CodeableConcept>,
    /// `category` (0..1): Classification of the procedure
    pub category: Option<CodeableConcept>,
    /// `code` (0..1): Identification of the procedure
    pub code: Option<CodeableConcept>,
    /// `subject` (1..1): Who the procedure was performed on
    pub subject: Option<Reference>,
    /// `encounter` (0..1): Encounter created as part of
    pub encounter: Option<Reference>,
    /// `performed[x]` (0..1): When the procedure was performed
    pub performed: Option<ProcedurePerformed>,
    /// `recorder` (0..1): Who recorded the procedure
    pub recorder: Option<Reference>,
    /// `asserter` (0..1): Person who asserts this procedure
    pub asserter: Option<Reference>,
    /// `performer` (0..*): The people who performed the procedure
    pub performer: Vec<ProcedurePerformer>,
    /// `location` (0..1): Where the procedure happened
    pub location: Option<Reference>,
    /// `reasonCode` (0..*): Coded reason procedure performed
    pub reason_code: Vec<CodeableConcept>,
    /// `reasonReference` (0..*): The justification that the procedure was performed
    pub reason_reference: Vec<Reference>,
    /// `bodySite` (0..*): Target body sites
    pub body_site: Vec<CodeableConcept>,
    /// `outcome` (0..1): The result of procedure
    pub outcome: Option<CodeableConcept>,
    /// `report` (0..*): Any report resulting from the procedure
    pub report: Vec<Reference>,
    /// `complication` (0..*): Complication following the procedure
    pub complication: Vec<CodeableConcept>,
    /// `complicationDetail` (0..*): A condition that is a result of the procedure
    pub complication_detail: Vec<Reference>,
    /// `followUp` (0..*): Instructions for follow up
    pub follow_up: Vec<CodeableConcept>,
    /// `note` (0..*): Additional information about the procedure
    pub note: Vec<Annotation>,
    /// `focalDevice` (0..*): Manipulated, implanted, or removed device
    pub focal_device: Vec<ProcedureFocalDevice>,
    /// `usedReference` (0..*): Items used during procedure
    pub used_reference: Vec<Reference>,
    /// `usedCode` (0..*): Coded items used during the procedure
    pub used_code: Vec<CodeableConcept>,
}

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

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        resource_type(&mut o, d, "Procedure");
        let r = Procedure {
            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_canonical: o.prim_list(d, "instantiatesCanonical", Kind::Canonical),
            instantiates_uri: o.prim_list(d, "instantiatesUri", Kind::Uri),
            based_on: o.list(d, "basedOn"),
            part_of: o.list(d, "partOf"),
            status: o.prim(d, "status", Kind::Code),
            status_reason: o.one(d, "statusReason"),
            category: o.one(d, "category"),
            code: o.one(d, "code"),
            subject: o.one(d, "subject"),
            encounter: o.one(d, "encounter"),
            performed: o.choice(d, "performed"),
            recorder: o.one(d, "recorder"),
            asserter: o.one(d, "asserter"),
            performer: o.list(d, "performer"),
            location: o.one(d, "location"),
            reason_code: o.list(d, "reasonCode"),
            reason_reference: o.list(d, "reasonReference"),
            body_site: o.list(d, "bodySite"),
            outcome: o.one(d, "outcome"),
            report: o.list(d, "report"),
            complication: o.list(d, "complication"),
            complication_detail: o.list(d, "complicationDetail"),
            follow_up: o.list(d, "followUp"),
            note: o.list(d, "note"),
            focal_device: o.list(d, "focalDevice"),
            used_reference: o.list(d, "usedReference"),
            used_code: o.list(d, "usedCode"),
        };
        required(d, "status", &r.status);
        required(d, "subject", &r.subject);
        o.finish(d);
        Some(r)
    }

    fn encode(&self) -> Json {
        let mut w = ObjWriter::new();
        w.raw("resourceType", Json::String("Procedure".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("instantiatesCanonical", &self.instantiates_canonical);
        w.prim_list("instantiatesUri", &self.instantiates_uri);
        w.list("basedOn", &self.based_on);
        w.list("partOf", &self.part_of);
        w.prim("status", &self.status);
        w.one("statusReason", &self.status_reason);
        w.one("category", &self.category);
        w.one("code", &self.code);
        w.one("subject", &self.subject);
        w.one("encounter", &self.encounter);
        w.choice("performed", &self.performed);
        w.one("recorder", &self.recorder);
        w.one("asserter", &self.asserter);
        w.list("performer", &self.performer);
        w.one("location", &self.location);
        w.list("reasonCode", &self.reason_code);
        w.list("reasonReference", &self.reason_reference);
        w.list("bodySite", &self.body_site);
        w.one("outcome", &self.outcome);
        w.list("report", &self.report);
        w.list("complication", &self.complication);
        w.list("complicationDetail", &self.complication_detail);
        w.list("followUp", &self.follow_up);
        w.list("note", &self.note);
        w.list("focalDevice", &self.focal_device);
        w.list("usedReference", &self.used_reference);
        w.list("usedCode", &self.used_code);
        w.finish()
    }
}

/// The people who performed the procedure
///
/// FHIR path: `Procedure.performer`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct ProcedurePerformer {
    /// `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): The reference to the practitioner
    pub actor: Option<Reference>,
    /// `onBehalfOf` (0..1): Organization the device or practitioner was acting for
    pub on_behalf_of: Option<Reference>,
}

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

    fn decode(v: &Json, d: &mut Decoder) -> Option<Self> {
        let mut o = Obj::new(v, d)?;
        let r = ProcedurePerformer {
            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"),
            on_behalf_of: o.one(d, "onBehalfOf"),
        };
        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.one("onBehalfOf", &self.on_behalf_of);
        w.finish()
    }
}

/// Manipulated, implanted, or removed device
///
/// FHIR path: `Procedure.focalDevice`.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq, Default)]
pub struct ProcedureFocalDevice {
    /// `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>,
    /// `action` (0..1): Kind of change to device
    pub action: Option<CodeableConcept>,
    /// `manipulated` (1..1): Device that was changed
    pub manipulated: Option<Reference>,
}

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

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

/// The types `Procedure.performed[x]` allows.
#[cfg(feature = "clinical")]
#[derive(Debug, Clone, PartialEq)]
pub enum ProcedurePerformed {
    /// `dateTime`
    DateTime(Primitive<String>),
    /// `Period`
    Period(Period),
    /// `string`
    String(Primitive<String>),
    /// `Age`
    Age(Age),
    /// `Range`
    Range(Range),
}

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

    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),
            "string" => o.prim(d, key, Kind::String).map(Self::String),
            "Age" => o.one(d, key).map(Self::Age),
            "Range" => o.one(d, key).map(Self::Range),
            _ => 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::String(v) => w.prim_value(&choice_key(base, "string"), v),
            Self::Age(v) => w.value(&choice_key(base, "Age"), v),
            Self::Range(v) => w.value(&choice_key(base, "Range"), v),
        }
    }
}