try-drop 0.2.0

Batteries included error handling mechanisms for drops which can fail
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

use super::{fallback, primary};
use std::boxed::Box;

#[cfg(feature = "global")]
use crate::{GlobalDynFallibleTryDropStrategy, GlobalTryDropStrategy};

#[cfg(feature = "thread-local")]
use crate::{ThreadLocalFallibleTryDropStrategy, ThreadLocalTryDropStrategy};

/// This installs the primary and fallback global handlers.
#[cfg(feature = "global")]
pub fn install_global_handlers(
    primary: impl GlobalDynFallibleTryDropStrategy,
    fallback: impl GlobalTryDropStrategy,
) {
    install_global_handlers_dyn(Box::new(primary), Box::new(fallback))
}

/// This installs the primary and fallback global handlers. Must be a dynamic trait object.
#[cfg(feature = "global")]
pub fn install_global_handlers_dyn(
    primary: Box<dyn GlobalDynFallibleTryDropStrategy>,
    fallback: Box<dyn GlobalTryDropStrategy>,
) {
    primary::global::install_dyn(primary);
    fallback::global::install_dyn(fallback);
}

/// This uninstalls the primary and fallback global handlers.
#[cfg(feature = "global")]
pub fn uninstall_globally() {
    primary::global::uninstall();
    fallback::global::uninstall();
}

/// This installs the primary and fallback thread local handlers.
#[cfg(feature = "thread-local")]
pub fn install_thread_local_handlers(
    primary: impl ThreadLocalFallibleTryDropStrategy,
    fallback: impl ThreadLocalTryDropStrategy,
) {
    install_thread_local_handlers_dyn(Box::new(primary), Box::new(fallback))
}

/// This installs the primary and fallback thread local handlers. Must be a dynamic trait
/// object.
#[cfg(feature = "thread-local")]
pub fn install_thread_local_handlers_dyn(
    primary: Box<dyn ThreadLocalFallibleTryDropStrategy>,
    fallback: Box<dyn ThreadLocalTryDropStrategy>,
) {
    primary::thread_local::install_dyn(primary);
    fallback::thread_local::install_dyn(fallback);
}

/// This installs the primary and fallback thread local handlers for this scope.
#[cfg(feature = "thread-local")]
pub fn install_thread_local_handlers_for_this_scope(
    primary: impl ThreadLocalFallibleTryDropStrategy,
    fallback: impl ThreadLocalTryDropStrategy,
) -> (
    primary::thread_local::ScopeGuard,
    fallback::thread_local::ScopeGuard,
) {
    install_thread_local_handlers_for_this_scope_dyn(Box::new(primary), Box::new(fallback))
}

/// This installs the primary and fallback thread local handlers for this scope. Must be a
/// dynamic trait object.
#[cfg(feature = "thread-local")]
pub fn install_thread_local_handlers_for_this_scope_dyn(
    primary: Box<dyn ThreadLocalFallibleTryDropStrategy>,
    fallback: Box<dyn ThreadLocalTryDropStrategy>,
) -> (
    primary::thread_local::ScopeGuard,
    fallback::thread_local::ScopeGuard,
) {
    (
        primary::thread_local::scope_dyn(primary),
        fallback::thread_local::scope_dyn(fallback),
    )
}

/// This uninstalls the primary and fallback thread local handlers.
#[cfg(feature = "thread-local")]
pub fn uninstall_for_thread() {
    primary::thread_local::uninstall();
    fallback::thread_local::uninstall();
}