bugsnag 0.2.1

The api of Bugsnag in rust.
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

//! An example showing the integration of the bugsnag api using a global instance object
//!
//! We provide a class for wrapping the api object in the global state by using
//! the lazy_static crate.

extern crate bugsnag;
#[macro_use]
extern crate lazy_static;

use std::panic;
use std::sync::{Arc, Mutex};

/// The wrapper for storing the global instance
struct GlobalInstanceWrapper {
    instance: Option<Arc<Mutex<bugsnag::Bugsnag>>>,
}

impl GlobalInstanceWrapper {
    pub fn new() -> GlobalInstanceWrapper {
        GlobalInstanceWrapper { instance: None }
    }

    pub fn instance(&mut self) -> Option<Arc<Mutex<bugsnag::Bugsnag>>> {
        self.instance.clone()
    }

    pub fn set_instance(&mut self, instance: bugsnag::Bugsnag) {
        self.instance = Some(Arc::new(Mutex::new(instance)))
    }
}

// The global instance that holds our wrapper
lazy_static! {
    static ref INSTANCE: Mutex<GlobalInstanceWrapper> = Mutex::new(GlobalInstanceWrapper::new());
}

/// Returns the global api object
/// To be accessible by this function, the api object needs to be registered
/// with the 'to_global_instance' function!
pub fn global_instance() -> Option<Arc<Mutex<bugsnag::Bugsnag>>> {
    match INSTANCE.lock() {
        Ok(mut res) => res.instance(),
        Err(_) => None,
    }
}

/// Consumes the api object and registers this object as the global api object
pub fn to_global_instance(api: bugsnag::Bugsnag) {
    if let Ok(mut res) = INSTANCE.lock() {
        res.set_instance(api);
    }
}

/// Converts our api object to the global api object and registers the panic
/// handler. This panic handler will use the global api object, if called.
fn register_panic_handler_with_global_instance(api: bugsnag::Bugsnag) {
    to_global_instance(api);

    panic::set_hook(Box::new(|info| {
        if let Some(api_mtx) = global_instance() {
            if let Ok(api) = api_mtx.lock() {
                if bugsnag::panic::handle(
                    &api,
                    &info,
                    Some(&["register_panic_handler_with_global_instance"]),
                ).is_err()
                {
                    println!("Error at notifying bugsnag!");
                }
            }
        }
    }));
}

fn main() {
    let mut api =
        bugsnag::Bugsnag::new("api-key", concat!(env!("CARGO_MANIFEST_DIR"), "/examples"));
    api.set_app_info(
        Some(env!("CARGO_PKG_VERSION")),
        Some("development"),
        Some("rust"),
    );

    register_panic_handler_with_global_instance(api);

    panic!("Hello from a Rust panic!");
}