mars-xlog 0.1.0-preview.2

Pure Rust xlog library with async/sync appenders, compression, encryption, and tracing integration.
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

# mars-xlog

`mars-xlog` is the public Rust API for this repository's xlog implementation.

It provides:

- async and sync appenders
- zlib and zstd compression
- optional public-key encryption
- global appender helpers
- `tracing-subscriber` integration behind the `tracing` feature

This crate is the intended entry point for Rust users.

## MSRV

`mars-xlog` currently targets Rust 1.85 or newer.

## Quick start

```rust
use mars_xlog::{AppenderMode, CompressMode, LogLevel, Xlog, XlogConfig};

fn main() -> anyhow::Result<()> {
    let cfg = XlogConfig::new("/tmp/xlog", "demo")
        .mode(AppenderMode::Async)
        .compress_mode(CompressMode::Zlib)
        .compress_level(6);

    let logger = Xlog::init(cfg, LogLevel::Info)?;
    logger.log(LogLevel::Info, Some("demo"), "hello from rust");
    logger.flush(true);
    Ok(())
}
```

## Feature flags

- `macros`: enables the `xlog!` family of call-site macros
- `tracing`: enables `XlogLayer` for `tracing-subscriber`
- `metrics`: emits runtime metrics via the `metrics` crate (requires a recorder)
- `metrics-prometheus`: enables the Prometheus recorder for bench/example usage

## Scope

This crate is the release-facing Rust surface.
Legacy C++ parity and benchmark support stay in the repository, but are not part
of the intended default Rust integration path.

## License

MIT. See the repository root `LICENSE` and `NOTICE`.