stripe_shared/
invoice_rendering_pdf.rs

1#[derive(Clone, Debug)]
2#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
3#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
4pub struct InvoiceRenderingPdf {
5    /// Page size of invoice pdf.
6    /// Options include a4, letter, and auto.
7    /// If set to auto, page size will be switched to a4 or letter based on customer locale.
8    pub page_size: Option<InvoiceRenderingPdfPageSize>,
9}
10#[doc(hidden)]
11pub struct InvoiceRenderingPdfBuilder {
12    page_size: Option<Option<InvoiceRenderingPdfPageSize>>,
13}
14
15#[allow(
16    unused_variables,
17    irrefutable_let_patterns,
18    clippy::let_unit_value,
19    clippy::match_single_binding,
20    clippy::single_match
21)]
22const _: () = {
23    use miniserde::de::{Map, Visitor};
24    use miniserde::json::Value;
25    use miniserde::{Deserialize, Result, make_place};
26    use stripe_types::miniserde_helpers::FromValueOpt;
27    use stripe_types::{MapBuilder, ObjectDeser};
28
29    make_place!(Place);
30
31    impl Deserialize for InvoiceRenderingPdf {
32        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
33            Place::new(out)
34        }
35    }
36
37    struct Builder<'a> {
38        out: &'a mut Option<InvoiceRenderingPdf>,
39        builder: InvoiceRenderingPdfBuilder,
40    }
41
42    impl Visitor for Place<InvoiceRenderingPdf> {
43        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
44            Ok(Box::new(Builder {
45                out: &mut self.out,
46                builder: InvoiceRenderingPdfBuilder::deser_default(),
47            }))
48        }
49    }
50
51    impl MapBuilder for InvoiceRenderingPdfBuilder {
52        type Out = InvoiceRenderingPdf;
53        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
54            Ok(match k {
55                "page_size" => Deserialize::begin(&mut self.page_size),
56                _ => <dyn Visitor>::ignore(),
57            })
58        }
59
60        fn deser_default() -> Self {
61            Self { page_size: Deserialize::default() }
62        }
63
64        fn take_out(&mut self) -> Option<Self::Out> {
65            let (Some(page_size),) = (self.page_size.take(),) else {
66                return None;
67            };
68            Some(Self::Out { page_size })
69        }
70    }
71
72    impl Map for Builder<'_> {
73        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
74            self.builder.key(k)
75        }
76
77        fn finish(&mut self) -> Result<()> {
78            *self.out = self.builder.take_out();
79            Ok(())
80        }
81    }
82
83    impl ObjectDeser for InvoiceRenderingPdf {
84        type Builder = InvoiceRenderingPdfBuilder;
85    }
86
87    impl FromValueOpt for InvoiceRenderingPdf {
88        fn from_value(v: Value) -> Option<Self> {
89            let Value::Object(obj) = v else {
90                return None;
91            };
92            let mut b = InvoiceRenderingPdfBuilder::deser_default();
93            for (k, v) in obj {
94                match k.as_str() {
95                    "page_size" => b.page_size = FromValueOpt::from_value(v),
96                    _ => {}
97                }
98            }
99            b.take_out()
100        }
101    }
102};
103/// Page size of invoice pdf.
104/// Options include a4, letter, and auto.
105/// If set to auto, page size will be switched to a4 or letter based on customer locale.
106#[derive(Clone, Eq, PartialEq)]
107#[non_exhaustive]
108pub enum InvoiceRenderingPdfPageSize {
109    A4,
110    Auto,
111    Letter,
112    /// An unrecognized value from Stripe. Should not be used as a request parameter.
113    Unknown(String),
114}
115impl InvoiceRenderingPdfPageSize {
116    pub fn as_str(&self) -> &str {
117        use InvoiceRenderingPdfPageSize::*;
118        match self {
119            A4 => "a4",
120            Auto => "auto",
121            Letter => "letter",
122            Unknown(v) => v,
123        }
124    }
125}
126
127impl std::str::FromStr for InvoiceRenderingPdfPageSize {
128    type Err = std::convert::Infallible;
129    fn from_str(s: &str) -> Result<Self, Self::Err> {
130        use InvoiceRenderingPdfPageSize::*;
131        match s {
132            "a4" => Ok(A4),
133            "auto" => Ok(Auto),
134            "letter" => Ok(Letter),
135            v => {
136                tracing::warn!(
137                    "Unknown value '{}' for enum '{}'",
138                    v,
139                    "InvoiceRenderingPdfPageSize"
140                );
141                Ok(Unknown(v.to_owned()))
142            }
143        }
144    }
145}
146impl std::fmt::Display for InvoiceRenderingPdfPageSize {
147    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
148        f.write_str(self.as_str())
149    }
150}
151
152impl std::fmt::Debug for InvoiceRenderingPdfPageSize {
153    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
154        f.write_str(self.as_str())
155    }
156}
157#[cfg(feature = "serialize")]
158impl serde::Serialize for InvoiceRenderingPdfPageSize {
159    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
160    where
161        S: serde::Serializer,
162    {
163        serializer.serialize_str(self.as_str())
164    }
165}
166impl miniserde::Deserialize for InvoiceRenderingPdfPageSize {
167    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
168        crate::Place::new(out)
169    }
170}
171
172impl miniserde::de::Visitor for crate::Place<InvoiceRenderingPdfPageSize> {
173    fn string(&mut self, s: &str) -> miniserde::Result<()> {
174        use std::str::FromStr;
175        self.out = Some(InvoiceRenderingPdfPageSize::from_str(s).expect("infallible"));
176        Ok(())
177    }
178}
179
180stripe_types::impl_from_val_with_from_str!(InvoiceRenderingPdfPageSize);
181#[cfg(feature = "deserialize")]
182impl<'de> serde::Deserialize<'de> for InvoiceRenderingPdfPageSize {
183    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
184        use std::str::FromStr;
185        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
186        Ok(Self::from_str(&s).expect("infallible"))
187    }
188}