aws_sdk_lexmodelsv2/types/
_analytics_session_metric_name.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2
3/// When writing a match expression against `AnalyticsSessionMetricName`, it is important to ensure
4/// your code is forward-compatible. That is, if a match arm handles a case for a
5/// feature that is supported by the service but has not been represented as an enum
6/// variant in a current version of SDK, your code should continue to work when you
7/// upgrade SDK to a future version in which the enum does include a variant for that
8/// feature.
9///
10/// Here is an example of how you can make a match expression forward-compatible:
11///
12/// ```text
13/// # let analyticssessionmetricname = unimplemented!();
14/// match analyticssessionmetricname {
15///     AnalyticsSessionMetricName::Concurrency => { /* ... */ },
16///     AnalyticsSessionMetricName::Count => { /* ... */ },
17///     AnalyticsSessionMetricName::Dropped => { /* ... */ },
18///     AnalyticsSessionMetricName::Duration => { /* ... */ },
19///     AnalyticsSessionMetricName::Failure => { /* ... */ },
20///     AnalyticsSessionMetricName::Success => { /* ... */ },
21///     AnalyticsSessionMetricName::TurnsPerConversation => { /* ... */ },
22///     other @ _ if other.as_str() == "NewFeature" => { /* handles a case for `NewFeature` */ },
23///     _ => { /* ... */ },
24/// }
25/// ```
26/// The above code demonstrates that when `analyticssessionmetricname` represents
27/// `NewFeature`, the execution path will lead to the second last match arm,
28/// even though the enum does not contain a variant `AnalyticsSessionMetricName::NewFeature`
29/// in the current version of SDK. The reason is that the variable `other`,
30/// created by the `@` operator, is bound to
31/// `AnalyticsSessionMetricName::Unknown(UnknownVariantValue("NewFeature".to_owned()))`
32/// and calling `as_str` on it yields `"NewFeature"`.
33/// This match expression is forward-compatible when executed with a newer
34/// version of SDK where the variant `AnalyticsSessionMetricName::NewFeature` is defined.
35/// Specifically, when `analyticssessionmetricname` represents `NewFeature`,
36/// the execution path will hit the second last match arm as before by virtue of
37/// calling `as_str` on `AnalyticsSessionMetricName::NewFeature` also yielding `"NewFeature"`.
38///
39/// Explicitly matching on the `Unknown` variant should
40/// be avoided for two reasons:
41/// - The inner data `UnknownVariantValue` is opaque, and no further information can be extracted.
42/// - It might inadvertently shadow other intended match arms.
43///
44#[allow(missing_docs)] // documentation missing in model
45#[non_exhaustive]
46#[derive(
47    ::std::clone::Clone, ::std::cmp::Eq, ::std::cmp::Ord, ::std::cmp::PartialEq, ::std::cmp::PartialOrd, ::std::fmt::Debug, ::std::hash::Hash,
48)]
49pub enum AnalyticsSessionMetricName {
50    #[allow(missing_docs)] // documentation missing in model
51    Concurrency,
52    #[allow(missing_docs)] // documentation missing in model
53    Count,
54    #[allow(missing_docs)] // documentation missing in model
55    Dropped,
56    #[allow(missing_docs)] // documentation missing in model
57    Duration,
58    #[allow(missing_docs)] // documentation missing in model
59    Failure,
60    #[allow(missing_docs)] // documentation missing in model
61    Success,
62    #[allow(missing_docs)] // documentation missing in model
63    TurnsPerConversation,
64    /// `Unknown` contains new variants that have been added since this code was generated.
65    #[deprecated(note = "Don't directly match on `Unknown`. See the docs on this enum for the correct way to handle unknown variants.")]
66    Unknown(crate::primitives::sealed_enum_unknown::UnknownVariantValue),
67}
68impl ::std::convert::From<&str> for AnalyticsSessionMetricName {
69    fn from(s: &str) -> Self {
70        match s {
71            "Concurrency" => AnalyticsSessionMetricName::Concurrency,
72            "Count" => AnalyticsSessionMetricName::Count,
73            "Dropped" => AnalyticsSessionMetricName::Dropped,
74            "Duration" => AnalyticsSessionMetricName::Duration,
75            "Failure" => AnalyticsSessionMetricName::Failure,
76            "Success" => AnalyticsSessionMetricName::Success,
77            "TurnsPerConversation" => AnalyticsSessionMetricName::TurnsPerConversation,
78            other => AnalyticsSessionMetricName::Unknown(crate::primitives::sealed_enum_unknown::UnknownVariantValue(other.to_owned())),
79        }
80    }
81}
82impl ::std::str::FromStr for AnalyticsSessionMetricName {
83    type Err = ::std::convert::Infallible;
84
85    fn from_str(s: &str) -> ::std::result::Result<Self, <Self as ::std::str::FromStr>::Err> {
86        ::std::result::Result::Ok(AnalyticsSessionMetricName::from(s))
87    }
88}
89impl AnalyticsSessionMetricName {
90    /// Returns the `&str` value of the enum member.
91    pub fn as_str(&self) -> &str {
92        match self {
93            AnalyticsSessionMetricName::Concurrency => "Concurrency",
94            AnalyticsSessionMetricName::Count => "Count",
95            AnalyticsSessionMetricName::Dropped => "Dropped",
96            AnalyticsSessionMetricName::Duration => "Duration",
97            AnalyticsSessionMetricName::Failure => "Failure",
98            AnalyticsSessionMetricName::Success => "Success",
99            AnalyticsSessionMetricName::TurnsPerConversation => "TurnsPerConversation",
100            AnalyticsSessionMetricName::Unknown(value) => value.as_str(),
101        }
102    }
103    /// Returns all the `&str` representations of the enum members.
104    pub const fn values() -> &'static [&'static str] {
105        &[
106            "Concurrency",
107            "Count",
108            "Dropped",
109            "Duration",
110            "Failure",
111            "Success",
112            "TurnsPerConversation",
113        ]
114    }
115}
116impl ::std::convert::AsRef<str> for AnalyticsSessionMetricName {
117    fn as_ref(&self) -> &str {
118        self.as_str()
119    }
120}
121impl AnalyticsSessionMetricName {
122    /// Parses the enum value while disallowing unknown variants.
123    ///
124    /// Unknown variants will result in an error.
125    pub fn try_parse(value: &str) -> ::std::result::Result<Self, crate::error::UnknownVariantError> {
126        match Self::from(value) {
127            #[allow(deprecated)]
128            Self::Unknown(_) => ::std::result::Result::Err(crate::error::UnknownVariantError::new(value)),
129            known => Ok(known),
130        }
131    }
132}
133impl ::std::fmt::Display for AnalyticsSessionMetricName {
134    fn fmt(&self, f: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
135        match self {
136            AnalyticsSessionMetricName::Concurrency => write!(f, "Concurrency"),
137            AnalyticsSessionMetricName::Count => write!(f, "Count"),
138            AnalyticsSessionMetricName::Dropped => write!(f, "Dropped"),
139            AnalyticsSessionMetricName::Duration => write!(f, "Duration"),
140            AnalyticsSessionMetricName::Failure => write!(f, "Failure"),
141            AnalyticsSessionMetricName::Success => write!(f, "Success"),
142            AnalyticsSessionMetricName::TurnsPerConversation => write!(f, "TurnsPerConversation"),
143            AnalyticsSessionMetricName::Unknown(value) => write!(f, "{value}"),
144        }
145    }
146}
aws_sdk_lexmodelsv2/types/_analytics_session_metric_name.rs

aws_sdk_lexmodelsv2/types/
_analytics_session_metric_name.rs
