fhir 1.1.0

Fast Healthcare Interoperability Resources (FHIR) data model for Rust: the complete FHIR R5 and R4 resources, datatypes, and code systems as serde-serializable types, plus a spec-driven code generator.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

//! FHIR R5 XML serialization (feature `xml`).
//!
//! FHIR XML differs from JSON: a primitive is `<field value="…"/>`, an element's
//! `id` (and an extension's `url`) are XML attributes, complex elements nest, and
//! repeating elements are simply repeated. The conversion itself does not vary
//! by release and lives in [`crate::xml`]; this module binds it to the R5
//! [`meta`](crate::r5::meta) table.
//!
//! ```
//! use fhir::r5::resources::Patient;
//! use fhir::r5::xml::{to_xml, from_xml};
//!
//! let patient: Patient = serde_json::from_value(serde_json::json!({
//!     "resourceType": "Patient", "id": "pat-1", "active": true,
//!     "name": [{ "family": "Chalmers", "given": ["Peter"] }]
//! })).unwrap();
//!
//! let xml = to_xml(&patient, "Patient");
//! assert!(xml.contains("<active value=\"true\"/>"));
//!
//! let back: Patient = from_xml(&xml).unwrap();
//! assert_eq!(back, patient);
//! ```

use ::serde::de::DeserializeOwned;
use ::serde_json::Value;

use crate::r5::meta;

pub use crate::xml::{to_xml, XmlError};

/// Parse a FHIR R5 XML string into a resource.
pub fn from_xml<T: DeserializeOwned>(xml: &str) -> Result<T, XmlError> {
    crate::xml::from_xml(meta::elements(), xml)
}

/// Parse a FHIR R5 XML string into untyped JSON.
pub fn xml_to_value(xml: &str) -> Result<Value, XmlError> {
    crate::xml::xml_to_value(meta::elements(), xml)
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::r5::resources::{Observation, Patient};

    fn roundtrip_patient(json: ::serde_json::Value) {
        let patient: Patient = ::serde_json::from_value(json).unwrap();
        let xml = to_xml(&patient, "Patient");
        let back: Patient = from_xml(&xml).unwrap_or_else(|e| panic!("from_xml failed: {e}\n{xml}"));
        assert_eq!(back, patient, "\nXML was:\n{xml}");
    }

    #[test]
    fn patient_roundtrips() {
        roundtrip_patient(::serde_json::json!({
            "resourceType": "Patient",
            "id": "pat-1",
            "active": true,
            "gender": "male",
            "birthDate": "1970-03-25",
            "name": [{ "family": "Chalmers", "given": ["Peter", "James"] }],
            "telecom": [{ "system": "phone", "value": "555" }]
        }));
    }

    #[test]
    fn primitive_written_as_value_attribute() {
        let patient: Patient = ::serde_json::from_value(::serde_json::json!({
            "resourceType": "Patient", "active": true
        }))
        .unwrap();
        let xml = to_xml(&patient, "Patient");
        assert!(xml.contains("<active value=\"true\"/>"), "{xml}");
        assert!(xml.contains("xmlns=\"http://hl7.org/fhir\""), "{xml}");
    }

    #[test]
    fn choice_element_roundtrips() {
        // Observation.value[x] — a choice — plus a required 1..1 code.
        let obs: Observation = ::serde_json::from_value(::serde_json::json!({
            "resourceType": "Observation",
            "status": "final",
            "code": { "text": "temp" },
            "valueString": "warm"
        }))
        .unwrap();
        let xml = to_xml(&obs, "Observation");
        let back: Observation = from_xml(&xml).unwrap_or_else(|e| panic!("{e}\n{xml}"));
        assert_eq!(back, obs, "\nXML was:\n{xml}");
    }
}