stripe_misc/tax_settings/
types.rs

1/// You can use Tax `Settings` to manage configurations used by Stripe Tax calculations.
2///
3/// Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
4///
5/// For more details see <<https://stripe.com/docs/api/tax/settings/object>>.
6#[derive(Clone, Debug)]
7#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
8pub struct TaxSettings {
9    pub defaults: stripe_misc::TaxProductResourceTaxSettingsDefaults,
10    /// The place where your business is located.
11    pub head_office: Option<stripe_misc::TaxProductResourceTaxSettingsHeadOffice>,
12    /// Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
13    pub livemode: bool,
14    /// The status of the Tax `Settings`.
15    pub status: TaxSettingsStatus,
16    pub status_details: stripe_misc::TaxProductResourceTaxSettingsStatusDetails,
17}
18#[doc(hidden)]
19pub struct TaxSettingsBuilder {
20    defaults: Option<stripe_misc::TaxProductResourceTaxSettingsDefaults>,
21    head_office: Option<Option<stripe_misc::TaxProductResourceTaxSettingsHeadOffice>>,
22    livemode: Option<bool>,
23    status: Option<TaxSettingsStatus>,
24    status_details: Option<stripe_misc::TaxProductResourceTaxSettingsStatusDetails>,
25}
26
27#[allow(
28    unused_variables,
29    irrefutable_let_patterns,
30    clippy::let_unit_value,
31    clippy::match_single_binding,
32    clippy::single_match
33)]
34const _: () = {
35    use miniserde::de::{Map, Visitor};
36    use miniserde::json::Value;
37    use miniserde::{Deserialize, Result, make_place};
38    use stripe_types::miniserde_helpers::FromValueOpt;
39    use stripe_types::{MapBuilder, ObjectDeser};
40
41    make_place!(Place);
42
43    impl Deserialize for TaxSettings {
44        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
45            Place::new(out)
46        }
47    }
48
49    struct Builder<'a> {
50        out: &'a mut Option<TaxSettings>,
51        builder: TaxSettingsBuilder,
52    }
53
54    impl Visitor for Place<TaxSettings> {
55        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
56            Ok(Box::new(Builder {
57                out: &mut self.out,
58                builder: TaxSettingsBuilder::deser_default(),
59            }))
60        }
61    }
62
63    impl MapBuilder for TaxSettingsBuilder {
64        type Out = TaxSettings;
65        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
66            Ok(match k {
67                "defaults" => Deserialize::begin(&mut self.defaults),
68                "head_office" => Deserialize::begin(&mut self.head_office),
69                "livemode" => Deserialize::begin(&mut self.livemode),
70                "status" => Deserialize::begin(&mut self.status),
71                "status_details" => Deserialize::begin(&mut self.status_details),
72                _ => <dyn Visitor>::ignore(),
73            })
74        }
75
76        fn deser_default() -> Self {
77            Self {
78                defaults: Deserialize::default(),
79                head_office: Deserialize::default(),
80                livemode: Deserialize::default(),
81                status: Deserialize::default(),
82                status_details: Deserialize::default(),
83            }
84        }
85
86        fn take_out(&mut self) -> Option<Self::Out> {
87            let (
88                Some(defaults),
89                Some(head_office),
90                Some(livemode),
91                Some(status),
92                Some(status_details),
93            ) = (
94                self.defaults.take(),
95                self.head_office.take(),
96                self.livemode,
97                self.status.take(),
98                self.status_details.take(),
99            )
100            else {
101                return None;
102            };
103            Some(Self::Out { defaults, head_office, livemode, status, status_details })
104        }
105    }
106
107    impl Map for Builder<'_> {
108        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
109            self.builder.key(k)
110        }
111
112        fn finish(&mut self) -> Result<()> {
113            *self.out = self.builder.take_out();
114            Ok(())
115        }
116    }
117
118    impl ObjectDeser for TaxSettings {
119        type Builder = TaxSettingsBuilder;
120    }
121
122    impl FromValueOpt for TaxSettings {
123        fn from_value(v: Value) -> Option<Self> {
124            let Value::Object(obj) = v else {
125                return None;
126            };
127            let mut b = TaxSettingsBuilder::deser_default();
128            for (k, v) in obj {
129                match k.as_str() {
130                    "defaults" => b.defaults = FromValueOpt::from_value(v),
131                    "head_office" => b.head_office = FromValueOpt::from_value(v),
132                    "livemode" => b.livemode = FromValueOpt::from_value(v),
133                    "status" => b.status = FromValueOpt::from_value(v),
134                    "status_details" => b.status_details = FromValueOpt::from_value(v),
135                    _ => {}
136                }
137            }
138            b.take_out()
139        }
140    }
141};
142#[cfg(feature = "serialize")]
143impl serde::Serialize for TaxSettings {
144    fn serialize<S: serde::Serializer>(&self, s: S) -> Result<S::Ok, S::Error> {
145        use serde::ser::SerializeStruct;
146        let mut s = s.serialize_struct("TaxSettings", 6)?;
147        s.serialize_field("defaults", &self.defaults)?;
148        s.serialize_field("head_office", &self.head_office)?;
149        s.serialize_field("livemode", &self.livemode)?;
150        s.serialize_field("status", &self.status)?;
151        s.serialize_field("status_details", &self.status_details)?;
152
153        s.serialize_field("object", "tax.settings")?;
154        s.end()
155    }
156}
157/// The status of the Tax `Settings`.
158#[derive(Clone, Eq, PartialEq)]
159#[non_exhaustive]
160pub enum TaxSettingsStatus {
161    Active,
162    Pending,
163    /// An unrecognized value from Stripe. Should not be used as a request parameter.
164    Unknown(String),
165}
166impl TaxSettingsStatus {
167    pub fn as_str(&self) -> &str {
168        use TaxSettingsStatus::*;
169        match self {
170            Active => "active",
171            Pending => "pending",
172            Unknown(v) => v,
173        }
174    }
175}
176
177impl std::str::FromStr for TaxSettingsStatus {
178    type Err = std::convert::Infallible;
179    fn from_str(s: &str) -> Result<Self, Self::Err> {
180        use TaxSettingsStatus::*;
181        match s {
182            "active" => Ok(Active),
183            "pending" => Ok(Pending),
184            v => {
185                tracing::warn!("Unknown value '{}' for enum '{}'", v, "TaxSettingsStatus");
186                Ok(Unknown(v.to_owned()))
187            }
188        }
189    }
190}
191impl std::fmt::Display for TaxSettingsStatus {
192    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
193        f.write_str(self.as_str())
194    }
195}
196
197impl std::fmt::Debug for TaxSettingsStatus {
198    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
199        f.write_str(self.as_str())
200    }
201}
202#[cfg(feature = "serialize")]
203impl serde::Serialize for TaxSettingsStatus {
204    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
205    where
206        S: serde::Serializer,
207    {
208        serializer.serialize_str(self.as_str())
209    }
210}
211impl miniserde::Deserialize for TaxSettingsStatus {
212    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
213        crate::Place::new(out)
214    }
215}
216
217impl miniserde::de::Visitor for crate::Place<TaxSettingsStatus> {
218    fn string(&mut self, s: &str) -> miniserde::Result<()> {
219        use std::str::FromStr;
220        self.out = Some(TaxSettingsStatus::from_str(s).expect("infallible"));
221        Ok(())
222    }
223}
224
225stripe_types::impl_from_val_with_from_str!(TaxSettingsStatus);
226#[cfg(feature = "deserialize")]
227impl<'de> serde::Deserialize<'de> for TaxSettingsStatus {
228    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
229        use std::str::FromStr;
230        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
231        Ok(Self::from_str(&s).expect("infallible"))
232    }
233}
stripe_misc/tax_settings/types.rs

stripe_misc/tax_settings/
types.rs
