Skip to main content

stripe_shared/
subscriptions_resource_pause_collection.rs

1/// The Pause Collection settings determine how we will pause collection for this subscription and for how long the subscription.
2/// should be paused.
3#[derive(Clone, Eq, PartialEq)]
4#[cfg_attr(not(feature = "redact-generated-debug"), derive(Debug))]
5#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
6#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
7pub struct SubscriptionsResourcePauseCollection {
8    /// The payment collection behavior for this subscription while paused.
9    pub behavior: SubscriptionsResourcePauseCollectionBehavior,
10    /// The time after which the subscription will resume collecting payments.
11    pub resumes_at: Option<stripe_types::Timestamp>,
12}
13#[cfg(feature = "redact-generated-debug")]
14impl std::fmt::Debug for SubscriptionsResourcePauseCollection {
15    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
16        f.debug_struct("SubscriptionsResourcePauseCollection").finish_non_exhaustive()
17    }
18}
19#[doc(hidden)]
20pub struct SubscriptionsResourcePauseCollectionBuilder {
21    behavior: Option<SubscriptionsResourcePauseCollectionBehavior>,
22    resumes_at: Option<Option<stripe_types::Timestamp>>,
23}
24
25#[allow(
26    unused_variables,
27    irrefutable_let_patterns,
28    clippy::let_unit_value,
29    clippy::match_single_binding,
30    clippy::single_match
31)]
32const _: () = {
33    use miniserde::de::{Map, Visitor};
34    use miniserde::json::Value;
35    use miniserde::{Deserialize, Result, make_place};
36    use stripe_types::miniserde_helpers::FromValueOpt;
37    use stripe_types::{MapBuilder, ObjectDeser};
38
39    make_place!(Place);
40
41    impl Deserialize for SubscriptionsResourcePauseCollection {
42        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
43            Place::new(out)
44        }
45    }
46
47    struct Builder<'a> {
48        out: &'a mut Option<SubscriptionsResourcePauseCollection>,
49        builder: SubscriptionsResourcePauseCollectionBuilder,
50    }
51
52    impl Visitor for Place<SubscriptionsResourcePauseCollection> {
53        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
54            Ok(Box::new(Builder {
55                out: &mut self.out,
56                builder: SubscriptionsResourcePauseCollectionBuilder::deser_default(),
57            }))
58        }
59    }
60
61    impl MapBuilder for SubscriptionsResourcePauseCollectionBuilder {
62        type Out = SubscriptionsResourcePauseCollection;
63        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
64            Ok(match k {
65                "behavior" => Deserialize::begin(&mut self.behavior),
66                "resumes_at" => Deserialize::begin(&mut self.resumes_at),
67                _ => <dyn Visitor>::ignore(),
68            })
69        }
70
71        fn deser_default() -> Self {
72            Self { behavior: None, resumes_at: Some(None) }
73        }
74
75        fn take_out(&mut self) -> Option<Self::Out> {
76            let (Some(behavior), Some(resumes_at)) = (self.behavior.take(), self.resumes_at) else {
77                return None;
78            };
79            Some(Self::Out { behavior, resumes_at })
80        }
81    }
82
83    impl Map for Builder<'_> {
84        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
85            self.builder.key(k)
86        }
87
88        fn finish(&mut self) -> Result<()> {
89            *self.out = self.builder.take_out();
90            Ok(())
91        }
92    }
93
94    impl ObjectDeser for SubscriptionsResourcePauseCollection {
95        type Builder = SubscriptionsResourcePauseCollectionBuilder;
96    }
97
98    impl FromValueOpt for SubscriptionsResourcePauseCollection {
99        fn from_value(v: Value) -> Option<Self> {
100            let Value::Object(obj) = v else {
101                return None;
102            };
103            let mut b = SubscriptionsResourcePauseCollectionBuilder::deser_default();
104            for (k, v) in obj {
105                match k.as_str() {
106                    "behavior" => b.behavior = FromValueOpt::from_value(v),
107                    "resumes_at" => b.resumes_at = FromValueOpt::from_value(v),
108                    _ => {}
109                }
110            }
111            b.take_out()
112        }
113    }
114};
115/// The payment collection behavior for this subscription while paused.
116#[derive(Clone, Eq, PartialEq)]
117#[non_exhaustive]
118pub enum SubscriptionsResourcePauseCollectionBehavior {
119    KeepAsDraft,
120    MarkUncollectible,
121    Void,
122    /// An unrecognized value from Stripe. Should not be used as a request parameter.
123    Unknown(String),
124}
125impl SubscriptionsResourcePauseCollectionBehavior {
126    pub fn as_str(&self) -> &str {
127        use SubscriptionsResourcePauseCollectionBehavior::*;
128        match self {
129            KeepAsDraft => "keep_as_draft",
130            MarkUncollectible => "mark_uncollectible",
131            Void => "void",
132            Unknown(v) => v,
133        }
134    }
135}
136
137impl std::str::FromStr for SubscriptionsResourcePauseCollectionBehavior {
138    type Err = std::convert::Infallible;
139    fn from_str(s: &str) -> Result<Self, Self::Err> {
140        use SubscriptionsResourcePauseCollectionBehavior::*;
141        match s {
142            "keep_as_draft" => Ok(KeepAsDraft),
143            "mark_uncollectible" => Ok(MarkUncollectible),
144            "void" => Ok(Void),
145            v => {
146                tracing::warn!(
147                    "Unknown value '{}' for enum '{}'",
148                    v,
149                    "SubscriptionsResourcePauseCollectionBehavior"
150                );
151                Ok(Unknown(v.to_owned()))
152            }
153        }
154    }
155}
156impl std::fmt::Display for SubscriptionsResourcePauseCollectionBehavior {
157    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
158        f.write_str(self.as_str())
159    }
160}
161
162#[cfg(not(feature = "redact-generated-debug"))]
163impl std::fmt::Debug for SubscriptionsResourcePauseCollectionBehavior {
164    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
165        f.write_str(self.as_str())
166    }
167}
168#[cfg(feature = "redact-generated-debug")]
169impl std::fmt::Debug for SubscriptionsResourcePauseCollectionBehavior {
170    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
171        f.debug_struct(stringify!(SubscriptionsResourcePauseCollectionBehavior))
172            .finish_non_exhaustive()
173    }
174}
175#[cfg(feature = "serialize")]
176impl serde::Serialize for SubscriptionsResourcePauseCollectionBehavior {
177    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
178    where
179        S: serde::Serializer,
180    {
181        serializer.serialize_str(self.as_str())
182    }
183}
184impl miniserde::Deserialize for SubscriptionsResourcePauseCollectionBehavior {
185    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
186        crate::Place::new(out)
187    }
188}
189
190impl miniserde::de::Visitor for crate::Place<SubscriptionsResourcePauseCollectionBehavior> {
191    fn string(&mut self, s: &str) -> miniserde::Result<()> {
192        use std::str::FromStr;
193        self.out =
194            Some(SubscriptionsResourcePauseCollectionBehavior::from_str(s).expect("infallible"));
195        Ok(())
196    }
197}
198
199stripe_types::impl_from_val_with_from_str!(SubscriptionsResourcePauseCollectionBehavior);
200#[cfg(feature = "deserialize")]
201impl<'de> serde::Deserialize<'de> for SubscriptionsResourcePauseCollectionBehavior {
202    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
203        use std::str::FromStr;
204        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
205        Ok(Self::from_str(&s).expect("infallible"))
206    }
207}