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
73                _ => <dyn Visitor>::ignore(),
74            })
75        }
76
77        fn deser_default() -> Self {
78            Self {
79                defaults: Deserialize::default(),
80                head_office: Deserialize::default(),
81                livemode: Deserialize::default(),
82                status: Deserialize::default(),
83                status_details: Deserialize::default(),
84            }
85        }
86
87        fn take_out(&mut self) -> Option<Self::Out> {
88            let (
89                Some(defaults),
90                Some(head_office),
91                Some(livemode),
92                Some(status),
93                Some(status_details),
94            ) = (
95                self.defaults.take(),
96                self.head_office.take(),
97                self.livemode,
98                self.status,
99                self.status_details.take(),
100            )
101            else {
102                return None;
103            };
104            Some(Self::Out { defaults, head_office, livemode, status, status_details })
105        }
106    }
107
108    impl Map for Builder<'_> {
109        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
110            self.builder.key(k)
111        }
112
113        fn finish(&mut self) -> Result<()> {
114            *self.out = self.builder.take_out();
115            Ok(())
116        }
117    }
118
119    impl ObjectDeser for TaxSettings {
120        type Builder = TaxSettingsBuilder;
121    }
122
123    impl FromValueOpt for TaxSettings {
124        fn from_value(v: Value) -> Option<Self> {
125            let Value::Object(obj) = v else {
126                return None;
127            };
128            let mut b = TaxSettingsBuilder::deser_default();
129            for (k, v) in obj {
130                match k.as_str() {
131                    "defaults" => b.defaults = FromValueOpt::from_value(v),
132                    "head_office" => b.head_office = FromValueOpt::from_value(v),
133                    "livemode" => b.livemode = FromValueOpt::from_value(v),
134                    "status" => b.status = FromValueOpt::from_value(v),
135                    "status_details" => b.status_details = FromValueOpt::from_value(v),
136
137                    _ => {}
138                }
139            }
140            b.take_out()
141        }
142    }
143};
144#[cfg(feature = "serialize")]
145impl serde::Serialize for TaxSettings {
146    fn serialize<S: serde::Serializer>(&self, s: S) -> Result<S::Ok, S::Error> {
147        use serde::ser::SerializeStruct;
148        let mut s = s.serialize_struct("TaxSettings", 6)?;
149        s.serialize_field("defaults", &self.defaults)?;
150        s.serialize_field("head_office", &self.head_office)?;
151        s.serialize_field("livemode", &self.livemode)?;
152        s.serialize_field("status", &self.status)?;
153        s.serialize_field("status_details", &self.status_details)?;
154
155        s.serialize_field("object", "tax.settings")?;
156        s.end()
157    }
158}
159/// The status of the Tax `Settings`.
160#[derive(Copy, Clone, Eq, PartialEq)]
161pub enum TaxSettingsStatus {
162    Active,
163    Pending,
164}
165impl TaxSettingsStatus {
166    pub fn as_str(self) -> &'static str {
167        use TaxSettingsStatus::*;
168        match self {
169            Active => "active",
170            Pending => "pending",
171        }
172    }
173}
174
175impl std::str::FromStr for TaxSettingsStatus {
176    type Err = stripe_types::StripeParseError;
177    fn from_str(s: &str) -> Result<Self, Self::Err> {
178        use TaxSettingsStatus::*;
179        match s {
180            "active" => Ok(Active),
181            "pending" => Ok(Pending),
182            _ => Err(stripe_types::StripeParseError),
183        }
184    }
185}
186impl std::fmt::Display for TaxSettingsStatus {
187    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
188        f.write_str(self.as_str())
189    }
190}
191
192impl std::fmt::Debug for TaxSettingsStatus {
193    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
194        f.write_str(self.as_str())
195    }
196}
197#[cfg(feature = "serialize")]
198impl serde::Serialize for TaxSettingsStatus {
199    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
200    where
201        S: serde::Serializer,
202    {
203        serializer.serialize_str(self.as_str())
204    }
205}
206impl miniserde::Deserialize for TaxSettingsStatus {
207    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
208        crate::Place::new(out)
209    }
210}
211
212impl miniserde::de::Visitor for crate::Place<TaxSettingsStatus> {
213    fn string(&mut self, s: &str) -> miniserde::Result<()> {
214        use std::str::FromStr;
215        self.out = Some(TaxSettingsStatus::from_str(s).map_err(|_| miniserde::Error)?);
216        Ok(())
217    }
218}
219
220stripe_types::impl_from_val_with_from_str!(TaxSettingsStatus);
221#[cfg(feature = "deserialize")]
222impl<'de> serde::Deserialize<'de> for TaxSettingsStatus {
223    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
224        use std::str::FromStr;
225        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
226        Self::from_str(&s)
227            .map_err(|_| serde::de::Error::custom("Unknown value for TaxSettingsStatus"))
228    }
229}