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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
//! Ratio
//!
//! URL: http://hl7.org/fhir/StructureDefinition/Ratio
//!
//! Version: 5.0.0
//!
//! Ratio Type: A relationship of two Quantity values - expressed as a numerator and a denominator.
//!
//! FHIR: <https://build.fhir.org/>
//!
//! UML: <https://build.fhir.org/uml.html>
//!
//! A `Ratio` datatype pairs a numerator and denominator `Quantity` to express a rate or proportion, such as a lab result ratio or a dosage rate.
// Allow unused crate::r5::types as types;
#![allow(unused_imports)]
use crate::r5::types;
use ::serde::{Deserialize, Serialize};
use fhir_derive_macros::{Builder, Validate};
/// A relationship of two `Quantity` values, expressed as a numerator and a denominator, used to represent ratios and rates such as concentrations or infusion rates.
///
/// # Examples
///
/// ```
/// use fhir::r5::types::ratio::Ratio;
///
/// let value = Ratio::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: Ratio = ::serde_json::from_value(json).unwrap();
/// assert_eq!(value, back);
/// ```
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate, Builder)]
#[serde(rename_all = "camelCase")]
pub struct Ratio {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub extension: Vec<types::Extension>,
/// The value of the numerator, i.e. the value that is on the top of the ratio expression. // « C »
pub numerator: Option<types::Quantity>,
/// The value of the denominator, i.e. the value that is on the bottom of the ratio expression. // Quantity(SimpleQuantity)
pub denominator: Option<types::Quantity>,
}
#[cfg(test)]
mod tests {
use super::*;
type T = Ratio;
#[test]
fn test_default() {
// Both elements are 0..1, so an empty Ratio has neither. This test
// previously asserted a defaulted denominator, which only held
// because the field was wrongly modelled as required (T35).
let actual = T::default();
let expect = T {
numerator: None,
denominator: None,
..Default::default()
};
assert_eq!(actual, expect);
}
mod serde_json {
use super::*;
use ::serde_json::json;
#[test]
fn test_serde_json_from_value() {
let json = json!({});
let actual: T = ::serde_json::from_value(json).expect("from_value");
let expect: T = T::default();
assert_eq!(actual, expect);
}
#[test]
fn test_serde_json_to_value() {
let actual: ::serde_json::Value =
::serde_json::to_value(T::default()).expect("to_value");
// An absent optional element is omitted, not emitted empty.
let expect: ::serde_json::Value = json!({});
assert_eq!(actual, expect);
}
}
}
#[cfg(test)]
mod drift_tests {
//! Regression tests for defects found by the T35 drift audit — cases
//! where the hand-maintained R5 tree had fallen behind the generator and
//! the published example corpus happened not to exercise them.
use super::*;
/// `Ratio.denominator` is `0..1` in R5. Requiring it rejected a valid
/// resource outright, which is a harder failure than dropping data.
#[test]
fn a_ratio_may_omit_its_denominator() {
let json = r#"{"numerator":{"value":5}}"#;
let parsed: Ratio = ::serde_json::from_str(json).expect("0..1 means optional");
assert!(parsed.denominator.is_none());
assert_eq!(::serde_json::to_string(&parsed).expect("serialize"), json);
}
}