tracing-ohos 0.1.0

Tracing layer to log to OpenHarmony's HiLog
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

//! # tracing-ohos
//!
//! Composable tracing layer which logs to logcat using the [OpenHarmony NDK]'s
//! `OH_LOG_Print` function. The provided tag will be capped at 23 bytes.
//! Logging events resulting in messages longer than 4000 bytes will result in
//! multiple log lines in logcat. This avoids running into logcat's truncation
//! behaviour.
//!
//! This crate is mainly based on the [tracing-android] crate.
//!
//! License: MIT OR Apache-2.0
//!
//! [OpenHarmony NDK]: https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V5/hilog-guidelines-ndk-V5#available-apis
//! [tracing-android]: https://crates.io/crates/tracing-android
//! # Example
//! Constructs a [`layer::Layer`] with the given `tag`.
//! ```no_run
//!  use tracing_subscriber::layer::SubscriberExt;
//!  use tracing_subscriber::util::SubscriberInitExt;
//!
//!  let ohrs_writer_layer = tracing_ohos::layer(0x0000, "homogrape")?;
//!
//!  tracing_subscriber::registry()
//!     .with(ohrs_writer_layer)
//!     .with(filter)
//!     .init();
//! ```


pub mod ohos;
pub mod layer;

pub use layer::Layer;
pub use ohos::OHOSWriter;

/// Constructs a [`layer::Layer`] with the given `tag`.
/// ```no_run
///  use tracing_subscriber::layer::SubscriberExt;
///  use tracing_subscriber::util::SubscriberInitExt;
///
///  let ohrs_writer_layer = tracing_ohos::layer(0x0000, "homogrape")?;
///
///  tracing_subscriber::registry()
///     .with(ohrs_writer_layer)
///     .with(filter)
///     .init();
/// ```
pub fn layer(domain: u16, tag: &str) -> std::io::Result<layer::Layer> {
    layer::Layer::new(domain, tag)
}