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

//! Types and traits on what to do when the global, thread local, or shim drop strategies is
//! uninitialized.
mod private {
    pub trait Sealed {}
}

#[cfg(any(feature = "ds-write", feature = "ds-panic"))]
mod use_default {
    use super::*;

    /// Use the default drop strategy if uninitialized
    #[cfg_attr(
        feature = "derives",
        derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)
    )]
    pub enum UseDefaultOnUninit {}

    impl OnUninit for UseDefaultOnUninit {
        type ExtraData = ();
    }
    impl private::Sealed for UseDefaultOnUninit {}
}

use core::sync::atomic::AtomicBool;
#[cfg(any(feature = "ds-write", feature = "ds-panic"))]
pub use use_default::*;

/// What to do when the global, thread local, or shim drop strategies is uninitialized.
pub trait OnUninit: private::Sealed {
    /// Any extra data that this type may neee.
    type ExtraData;
}

/// Just error on the drop strategy if uninitialized.
#[cfg_attr(
    feature = "derives",
    derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)
)]
pub enum ErrorOnUninit {}

impl OnUninit for ErrorOnUninit {
    type ExtraData = ();
}
impl private::Sealed for ErrorOnUninit {}

/// Panic on the drop strategy if uninitialized.
#[cfg_attr(
    feature = "derives",
    derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)
)]
pub enum PanicOnUninit {}

impl OnUninit for PanicOnUninit {
    type ExtraData = ();
}
impl private::Sealed for PanicOnUninit {}

/// Does nothing if uninitialized.
#[cfg_attr(
    feature = "derives",
    derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)
)]
pub enum DoNothingOnUninit {}

impl OnUninit for DoNothingOnUninit {
    type ExtraData = ();
}
impl private::Sealed for DoNothingOnUninit {}

/// Sets an internal flag if uninitialized.
#[cfg_attr(
    feature = "derives",
    derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)
)]
pub enum FlagOnUninit {}

impl OnUninit for FlagOnUninit {
    type ExtraData = AtomicBool;
}
impl private::Sealed for FlagOnUninit {}