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,
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(Copy, Clone, Eq, PartialEq)]
159pub enum TaxSettingsStatus {
160    Active,
161    Pending,
162}
163impl TaxSettingsStatus {
164    pub fn as_str(self) -> &'static str {
165        use TaxSettingsStatus::*;
166        match self {
167            Active => "active",
168            Pending => "pending",
169        }
170    }
171}
172
173impl std::str::FromStr for TaxSettingsStatus {
174    type Err = stripe_types::StripeParseError;
175    fn from_str(s: &str) -> Result<Self, Self::Err> {
176        use TaxSettingsStatus::*;
177        match s {
178            "active" => Ok(Active),
179            "pending" => Ok(Pending),
180            _ => Err(stripe_types::StripeParseError),
181        }
182    }
183}
184impl std::fmt::Display for TaxSettingsStatus {
185    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
186        f.write_str(self.as_str())
187    }
188}
189
190impl std::fmt::Debug for TaxSettingsStatus {
191    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
192        f.write_str(self.as_str())
193    }
194}
195#[cfg(feature = "serialize")]
196impl serde::Serialize for TaxSettingsStatus {
197    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
198    where
199        S: serde::Serializer,
200    {
201        serializer.serialize_str(self.as_str())
202    }
203}
204impl miniserde::Deserialize for TaxSettingsStatus {
205    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
206        crate::Place::new(out)
207    }
208}
209
210impl miniserde::de::Visitor for crate::Place<TaxSettingsStatus> {
211    fn string(&mut self, s: &str) -> miniserde::Result<()> {
212        use std::str::FromStr;
213        self.out = Some(TaxSettingsStatus::from_str(s).map_err(|_| miniserde::Error)?);
214        Ok(())
215    }
216}
217
218stripe_types::impl_from_val_with_from_str!(TaxSettingsStatus);
219#[cfg(feature = "deserialize")]
220impl<'de> serde::Deserialize<'de> for TaxSettingsStatus {
221    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
222        use std::str::FromStr;
223        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
224        Self::from_str(&s)
225            .map_err(|_| serde::de::Error::custom("Unknown value for TaxSettingsStatus"))
226    }
227}