breakpad-rs 0.2.0

Breakpad for 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
88
89
90
91

#![doc = include_str!("../README.md")]

use autocxx::subclass::prelude::*;
use ffi::ToCppString;

autocxx::include_cpp! {
    #include "breakpad_exception_handler_delegate.h"
    safety!(unsafe)
    generate!("breakpad::ExceptionHandlerDelegate")
}

#[cxx::bridge(namespace = "breakpad")]
mod breakpad {
    unsafe extern "C++" {
        include!("breakpad.h");
        type ExceptionHandler;
        type ExceptionHandlerDelegate = crate::ffi::breakpad::ExceptionHandlerDelegate;
        fn CreateExceptionHandler(
            delegate: &ExceptionHandlerDelegate,
        ) -> UniquePtr<ExceptionHandler>;
    }
}

// TODO: This struct is for internal use only, so its visibility should be private or pub(crate).
// The reason for making this struct public is due to the limitation of autocxx.
#[subclass(superclass("breakpad::ExceptionHandlerDelegate"))]
pub struct ExceptionHandlerDelegateBridge {
    delegate: Box<dyn ExceptionHandlerDelegate>,
}

impl ExceptionHandlerDelegateBridge {
    fn new(
        delegate: Option<Box<dyn ExceptionHandlerDelegate>>,
    ) -> std::rc::Rc<std::cell::RefCell<Self>> {
        Self::new_rust_owned(Self {
            cpp_peer: Default::default(),
            delegate: match delegate {
                Some(delegate) => delegate,
                None => Box::new(DefaultExceptionHandlerDelegate),
            },
        })
    }
}

#[allow(non_snake_case)]
impl ffi::breakpad::ExceptionHandlerDelegate_methods for ExceptionHandlerDelegateBridge {
    fn DidWriteMinidump(&self, working_path: &cxx::CxxString, minidump_id: &cxx::CxxString) {
        self.delegate.did_write_minidump(working_path.to_string(), minidump_id.to_string());
    }

    fn GetWorkingPath(&self) -> cxx::UniquePtr<cxx::CxxString> {
        self.delegate.get_working_path().into_cpp()
    }

    fn ShouldWriteMinidump(&self) -> bool {
        self.delegate.should_write_minidump()
    }
}

#[allow(unused_variables)]
pub trait ExceptionHandlerDelegate {
    fn did_write_minidump(&self, working_path: String, minidump_id: String) {}

    fn get_working_path(&self) -> String {
        String::new()
    }

    fn should_write_minidump(&self) -> bool {
        true
    }
}

struct DefaultExceptionHandlerDelegate;
impl ExceptionHandlerDelegate for DefaultExceptionHandlerDelegate {}

#[allow(dead_code)]
pub struct Breakpad {
    bridge: std::rc::Rc<std::cell::RefCell<ExceptionHandlerDelegateBridge>>,
    exception_handler: cxx::UniquePtr<breakpad::ExceptionHandler>,
}

impl Breakpad {
    pub fn new(delegate: Option<Box<dyn ExceptionHandlerDelegate>>) -> Self {
        let bridge = ExceptionHandlerDelegateBridge::new(delegate);
        let breakpad = Self {
            bridge: bridge.clone(),
            exception_handler: breakpad::CreateExceptionHandler(bridge.as_ref().borrow().as_ref()),
        };
        breakpad
    }
}