lemon_bugsnag_rs 0.1.2

A library for interacting with the BugSnag error-reporting and sessions APIs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use crate::error::error_client_builder::ErrorClientBuilder;

#[cfg(all(feature = "error-client", feature = "async"))]
use super::non_blocking::ClientBuilderReqwestErrorAsync;
#[cfg(feature = "async")]
use crate::common::traits::decider_trait_async::DeciderTraitAsync;
#[cfg(feature = "async")]
use reqwest::ClientBuilder as ReqwestClientBuilder;

#[cfg(all(feature = "error-client", feature = "sync"))]
use super::blocking::ClientBuilderReqwestErrorSync;
#[cfg(feature = "sync")]
use crate::common::traits::decider_trait_sync::DeciderTraitSync;
#[cfg(feature = "sync")]
use reqwest::blocking::ClientBuilder as ReqwestBlockingClientBuilder;

/// Intermediate struct that implements [DeciderTraitAsync] and
/// [DeciderTraitSync], allowing the user to choose between blocking and
/// non-blocking network clients.
///
/// ```
/// use lemon_bugsnag_rs::common::builder::client_builder::ClientBuilder;
/// use lemon_bugsnag_rs::common::traits::decider_trait_async::DeciderTraitAsync;
///
/// let mut cb = ClientBuilder::error();
///
/// cb.configure(
///     "YOUR_BUGSNAG_API_KEY"
///     , "NAB BugSnag RS Doctest Error Class"
///     , "Some generic error message"
///     , "NAB BugSnag RS Doctest Notifier"
///     , "0.0.2"
///     , "Your application type"
///     , "dev"
/// );
///
/// // This section of code is broken into two pieces for demonstration
/// // purposes. You can also chain the calls to retrieve a client.
/// // `cb.reqwest().non_blocking()`
/// let mut decider = cb.reqwest();
/// let client = decider.non_blocking();
/// ```
pub struct ReqwestErrorDecider {
    pub(crate) builder: ErrorClientBuilder,
}

#[cfg_attr(docsrs, doc(cfg(feature = "async")))]
#[cfg(feature = "async")]
impl DeciderTraitAsync<ClientBuilderReqwestErrorAsync> for ReqwestErrorDecider {
    /// Select a non-blocking backend for your request to the BugSnag API.
    ///
    /// ```
    /// use lemon_bugsnag_rs::common::builder::client_builder::ClientBuilder;
    /// use lemon_bugsnag_rs::common::traits::decider_trait_async::DeciderTraitAsync;
    ///
    /// let mut cb = ClientBuilder::error();
    ///
    /// cb.configure(
    ///     "YOUR_BUGSNAG_API_KEY"
    ///     , "NAB BugSnag RS Doctest Error Class"
    ///     , "Some generic error message"
    ///     , "NAB BugSnag RS Doctest Notifier"
    ///     , "0.0.2"
    ///     , "Your application type"
    ///     , "dev"
    /// );
    ///
    /// let client = cb.reqwest().non_blocking();
    /// ```
    fn non_blocking(self) -> ClientBuilderReqwestErrorAsync {
        ClientBuilderReqwestErrorAsync {
            client_builder: ReqwestClientBuilder::default(),
            options: self.builder.options.clone(),
            api_key: self.builder.api_key.clone(),
            payload_version: self
                .builder
                .payload_version_override
                .clone()
                .unwrap_or(self.builder.payload_version.clone()),
            notifier: self.builder.notifier,
            events: self.builder.events,
        }
    }
}

#[cfg_attr(docsrs, doc(cfg(feature = "sync")))]
#[cfg(feature = "sync")]
impl DeciderTraitSync<ClientBuilderReqwestErrorSync> for ReqwestErrorDecider {
    /// Select a blocking backend for your request to the BugSnag API.
    ///
    /// ```
    /// use lemon_bugsnag_rs::common::builder::client_builder::ClientBuilder;
    /// use lemon_bugsnag_rs::common::traits::decider_trait_sync::DeciderTraitSync;
    ///
    /// let mut cb = ClientBuilder::error();
    ///
    /// cb.configure(
    ///     "YOUR_BUGSNAG_API_KEY"
    ///     , "NAB BugSnag RS Doctest Error Class"
    ///     , "Some generic error message"
    ///     , "NAB BugSnag RS Doctest Notifier"
    ///     , "0.0.2"
    ///     , "Your application type"
    ///     , "dev"
    /// );
    ///
    /// let client = cb.reqwest().blocking();
    /// ```
    fn blocking(self) -> ClientBuilderReqwestErrorSync {
        ClientBuilderReqwestErrorSync {
            client_builder: ReqwestBlockingClientBuilder::default(),
            options: self.builder.options.clone(),
            api_key: self.builder.api_key.clone(),
            payload_version: self
                .builder
                .payload_version_override
                .clone()
                .unwrap_or(self.builder.payload_version.clone()),
            notifier: self.builder.notifier.clone(),
            events: self.builder.events.clone(),
        }
    }
}