fhir-types 0.1.102

// @generated by fhir-codegen from hl7.fhir.r6.core 6.0.0-ballot5. DO NOT EDIT.
// Change the emitter (tools/fhir-codegen) and regenerate.
// SPDX-FileCopyrightText: Ruben Talstra
// SPDX-License-Identifier: Apache-2.0
//! Expresses a time or time period as relative to the time of an event

/// Expresses a time or time period as relative to the time of an event
///
/// RelativeTime expresses a time or time period as relative to the time of an
/// event defined in data types other than dateTime.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct RelativeTime {
    /// Unique id for inter-element referencing
    ///
    /// Unique id for the element within a resource (for internal references). This
    /// may be any string value that does not contain spaces.
    pub id: Option<std::string::String>,
    /// Additional content defined by implementations
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element. To make the use of extensions safe and
    /// managable, there is a strict set of governance applied to the definition and
    /// use of extensions. Though any implementer can define an extension, there is
    /// a set of requirements that SHALL be met as part of the definition of the
    /// extension.
    pub extension: Vec<super::extension::Extension>,
    /// Extensions that cannot be ignored even if unrecognized
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element and that modifies the understanding of the
    /// element in which it is contained and/or the understanding of the containing
    /// element's descendants. Usually modifier elements provide negation or
    /// qualification. To make the use of extensions safe and managable, there is a
    /// strict set of governance applied to the definition and use of extensions.
    /// Though any implementer can define an extension, there is a set of
    /// requirements that SHALL be met as part of the definition of the extension.
    /// Applications processing a resource are required to check for modifier
    /// extensions. Modifier extensions SHALL NOT change the meaning of any elements
    /// on Resource or DomainResource (including cannot change the meaning of
    /// modifierExtension itself).
    pub modifier_extension: Vec<super::extension::Extension>,
    /// The specific event occurrence or resource context used as a base point
    /// (reference point) in time
    ///
    /// The specific event occurrence or resource context used as a base point
    /// (reference point) in time. This establishes the context in which the 'path'
    /// is evaluated.
    pub context_reference: Option<super::reference::Reference>,
    /// The type of event used as a base point
    ///
    /// The type of event used as a base point. Instances of this definition will
    /// establish the context for evaluating the path to determine the base time for
    /// the offset.
    pub context_definition: Option<super::primitives::Canonical>,
    /// Path to the element defining the basis for the relative time
    ///
    /// Path to the element defining the basis for the relative time. Any valid
    /// FHIRPath expression.
    pub context_path: Option<super::primitives::String>,
    /// Coded representation of the event used as a base point (reference point) in
    /// time.
    pub context_code: Option<super::codeable_concept::CodeableConcept>,
    /// An offset or offset range before (negative values) or after (positive
    /// values) the event
    ///
    /// An offset or offset range before (negative values) or after (positive
    /// values) the event. Range is limited to time-valued quantities (Durations).
    pub offset: Option<RelativeTimeOffset>,
    /// Free-text description
    ///
    /// Free-text (human-readable) description.
    pub text: Option<super::primitives::String>,
}

impl super::super::codec::Json for RelativeTime {
    fn to_json(&self) -> Result<super::super::codec::Object, super::super::codec::EncodeError> {
        let mut object = super::super::codec::Object::new();
        if let Some(v) = &self.id {
            object.insert(
                std::string::String::from("id"),
                super::super::codec::Value::String(v.clone()),
            );
        }
        if !self.extension.is_empty() {
            let mut items = Vec::with_capacity(self.extension.len());
            for item in &self.extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("extension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.modifier_extension.is_empty() {
            let mut items = Vec::with_capacity(self.modifier_extension.len());
            for item in &self.modifier_extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("modifierExtension"),
                super::super::codec::Value::Array(items),
            );
        }
        if let Some(item) = &self.context_reference {
            object.insert(
                std::string::String::from("contextReference"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if let Some(item) = &self.context_definition {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("contextDefinition"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_contextDefinition"), e);
            }
        }
        if let Some(item) = &self.context_path {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("contextPath"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_contextPath"), e);
            }
        }
        if let Some(item) = &self.context_code {
            object.insert(
                std::string::String::from("contextCode"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if let Some(item) = &self.offset {
            let (suffix, value, element) = item.to_json_parts()?;
            if let Some(value) = value {
                object.insert(format!("offset{suffix}"), value);
            }
            if let Some(element) = element {
                object.insert(format!("_offset{suffix}"), element);
            }
        }
        if let Some(item) = &self.text {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("text"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_text"), e);
            }
        }
        Ok(object)
    }

    fn from_json(
        object: &super::super::codec::Object,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        let mut raw_id: Option<&super::super::codec::Value> = None;
        let mut raw_extension: Option<&super::super::codec::Value> = None;
        let mut raw_modifier_extension: Option<&super::super::codec::Value> = None;
        let mut raw_context_reference: Option<&super::super::codec::Value> = None;
        let mut raw_context_definition: Option<&super::super::codec::Value> = None;
        let mut raw_context_definition_element: Option<&super::super::codec::Value> = None;
        let mut raw_context_path: Option<&super::super::codec::Value> = None;
        let mut raw_context_path_element: Option<&super::super::codec::Value> = None;
        let mut raw_context_code: Option<&super::super::codec::Value> = None;
        let mut raw_offset = super::super::codec::ChoiceSlot::default();
        let mut raw_text: Option<&super::super::codec::Value> = None;
        let mut raw_text_element: Option<&super::super::codec::Value> = None;
        for (key, value) in object {
            match key.as_str() {
                "id" => {
                    raw_id = Some(value);
                }
                "extension" => {
                    raw_extension = Some(value);
                }
                "modifierExtension" => {
                    raw_modifier_extension = Some(value);
                }
                "contextReference" => {
                    raw_context_reference = Some(value);
                }
                "contextDefinition" => {
                    raw_context_definition = Some(value);
                }
                "_contextDefinition" => {
                    raw_context_definition_element = Some(value);
                }
                "contextPath" => {
                    raw_context_path = Some(value);
                }
                "_contextPath" => {
                    raw_context_path_element = Some(value);
                }
                "contextCode" => {
                    raw_context_code = Some(value);
                }
                "offsetDuration" => {
                    raw_offset.value("Duration", value, path)?;
                }
                "_offsetDuration" => {
                    raw_offset.element("Duration", value, path)?;
                }
                "offsetRange" => {
                    raw_offset.value("Range", value, path)?;
                }
                "_offsetRange" => {
                    raw_offset.element("Range", value, path)?;
                }
                "text" => {
                    raw_text = Some(value);
                }
                "_text" => {
                    raw_text_element = Some(value);
                }
                other => {
                    return path.with(other, |path| {
                        Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty))
                    });
                }
            }
        }
        let field_id = raw_id
            .map(|value| {
                path.with("id", |path| {
                    let value = super::super::codec::expect_single(value, path)?;
                    super::super::codec::expect_string(value, path)
                })
            })
            .transpose()?;
        let mut field_extension = Vec::new();
        if let Some(raw) = raw_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_extension.push(path.with_index("extension", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_modifier_extension = Vec::new();
        if let Some(raw) = raw_modifier_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_modifier_extension.push(path.with_index(
                    "modifierExtension",
                    index,
                    |path| {
                        super::super::codec::Json::from_json(
                            super::super::codec::expect_object(value, path)?,
                            path,
                        )
                    },
                )?);
            }
        }
        let field_context_reference = raw_context_reference
            .map(|value| {
                path.with("contextReference", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let field_context_definition =
            match (raw_context_definition, raw_context_definition_element) {
                (None, None) => None,
                (value, element) => Some(path.with("contextDefinition", |path| {
                    super::super::codec::Primitive::from_json_parts(value, element, path)
                })?),
            };
        let field_context_path = match (raw_context_path, raw_context_path_element) {
            (None, None) => None,
            (value, element) => Some(path.with("contextPath", |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?),
        };
        let field_context_code = raw_context_code
            .map(|value| {
                path.with("contextCode", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let field_offset = match raw_offset.suffix {
            None => None,
            Some(suffix) => Some(path.with("offset", |path| {
                RelativeTimeOffset::from_json_parts(
                    suffix,
                    raw_offset.value,
                    raw_offset.element,
                    path,
                )
            })?),
        };
        let field_text = match (raw_text, raw_text_element) {
            (None, None) => None,
            (value, element) => Some(path.with("text", |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?),
        };
        Ok(Self {
            id: field_id,
            extension: field_extension,
            modifier_extension: field_modifier_extension,
            context_reference: field_context_reference,
            context_definition: field_context_definition,
            context_path: field_context_path,
            context_code: field_context_code,
            offset: field_offset,
            text: field_text,
        })
    }
}

impl serde::Serialize for RelativeTime {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let mut map = serde::Serializer::serialize_map(serializer, None)?;
        if let Some(item) = &self.context_definition {
            super::super::codec::element_entry(&mut map, "_contextDefinition", item)?;
        }
        if let Some(item) = &self.context_path {
            super::super::codec::element_entry(&mut map, "_contextPath", item)?;
        }
        if let Some(item) = &self.text {
            super::super::codec::element_entry(&mut map, "_text", item)?;
        }
        if let Some(item) = &self.context_code {
            serde::ser::SerializeMap::serialize_entry(&mut map, "contextCode", item)?;
        }
        if let Some(item) = &self.context_definition {
            super::super::codec::value_entry(&mut map, "contextDefinition", item)?;
        }
        if let Some(item) = &self.context_path {
            super::super::codec::value_entry(&mut map, "contextPath", item)?;
        }
        if let Some(item) = &self.context_reference {
            serde::ser::SerializeMap::serialize_entry(&mut map, "contextReference", item)?;
        }
        if !self.extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "extension", &self.extension)?;
        }
        if let Some(v) = &self.id {
            serde::ser::SerializeMap::serialize_entry(&mut map, "id", v)?;
        }
        if !self.modifier_extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(
                &mut map,
                "modifierExtension",
                &self.modifier_extension,
            )?;
        }
        match &self.offset {
            Some(RelativeTimeOffset::Duration(inner)) => {
                serde::ser::SerializeMap::serialize_entry(
                    &mut map,
                    "offsetDuration",
                    inner.as_ref(),
                )?;
            }
            Some(RelativeTimeOffset::Range(inner)) => {
                serde::ser::SerializeMap::serialize_entry(&mut map, "offsetRange", inner.as_ref())?;
            }
            None => {}
        }
        if let Some(item) = &self.text {
            super::super::codec::value_entry(&mut map, "text", item)?;
        }
        serde::ser::SerializeMap::end(map)
    }
}

impl<'de> serde::Deserialize<'de> for RelativeTime {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <super::super::codec::Value as serde::Deserialize>::deserialize(deserializer)?;
        let mut path = super::super::codec::Path::root("RelativeTime");
        let object =
            super::super::codec::expect_object(&value, &path).map_err(serde::de::Error::custom)?;
        super::super::codec::Json::from_json(object, &mut path).map_err(serde::de::Error::custom)
    }
}

/// The \`offset\[x\]\` choice of \`RelativeTime\`.
///
/// An offset or offset range before (negative values) or after (positive
/// values) the event. Range is limited to time-valued quantities (Durations).
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum RelativeTimeOffset {
    /// The `Duration` form.
    Duration(Box<super::duration::Duration>),
    /// The `Range` form.
    Range(Box<super::range::Range>),
}

impl RelativeTimeOffset {
    /// The key suffix, the value part, and the `_name` part of this form.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::EncodeError`] when a held value has no JSON form.
    pub fn to_json_parts(
        &self,
    ) -> Result<
        (
            &'static str,
            Option<super::super::codec::Value>,
            Option<super::super::codec::Value>,
        ),
        super::super::codec::EncodeError,
    > {
        match self {
            Self::Duration(inner) => Ok((
                "Duration",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
            Self::Range(inner) => Ok((
                "Range",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
        }
    }

    /// Decodes the form named by `suffix` from its value and `_name` parts.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::DecodeError`] for an unknown suffix or a malformed part.
    pub fn from_json_parts(
        suffix: &str,
        value: Option<&super::super::codec::Value>,
        element: Option<&super::super::codec::Value>,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        match suffix {
            "Duration" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Duration(Box::new(inner)))
            }
            "Range" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Range(Box::new(inner)))
            }
            _ => Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty)),
        }
    }
}