apple-log 0.5.1

Safe Rust bindings for Apple's os / OSLog APIs on macOS
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

use core::ffi::c_void;
use std::ptr::NonNull;

use crate::ffi;
use crate::os_log_store::{OSLogEntryCommon, OSLogEntryFromProcess, OSLogEntryWithPayload};

/// The severity of an `OSLogEntryLog`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum OSLogEntryLogLevel {
    Undefined,
    Debug,
    Info,
    Notice,
    Error,
    Fault,
}

impl OSLogEntryLogLevel {
    pub(crate) const fn from_raw(raw: i32) -> Self {
        match raw {
            1 => Self::Debug,
            2 => Self::Info,
            3 => Self::Notice,
            4 => Self::Error,
            5 => Self::Fault,
            _ => Self::Undefined,
        }
    }
}

/// Snapshot of an `OSLogEntryLog` returned from `OSLogStore`.
pub struct OSLogEntryLog {
    ptr: NonNull<c_void>,
}

impl OSLogEntryLog {
    pub(crate) const fn from_raw(ptr: NonNull<c_void>) -> Self {
        Self { ptr }
    }

    #[must_use]
    pub fn level(&self) -> OSLogEntryLogLevel {
        OSLogEntryLogLevel::from_raw(unsafe { ffi::apple_log_os_log_entry_level(self.ptr.as_ptr()) })
    }
}

impl OSLogEntryCommon for OSLogEntryLog {
    fn raw_entry_ptr(&self) -> *mut c_void {
        self.ptr.as_ptr()
    }
}

impl OSLogEntryFromProcess for OSLogEntryLog {}
impl OSLogEntryWithPayload for OSLogEntryLog {}

impl Drop for OSLogEntryLog {
    fn drop(&mut self) {
        unsafe { ffi::apple_log_os_log_entry_release(self.ptr.as_ptr()) };
    }
}