lxmd 0.1.0

LXMF propagation daemon
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

# lxmd - LXMF Propagation Daemon

`lxmd` is a propagation daemon for the LXMF (LoRa eXtended Messaging Format) protocol.

## Logging

By default, `lxmd` initializes `env_logger` with configurable log levels.

### Log Levels

The log level can be controlled via:
- The `loglevel` configuration file setting (0-7)
- Command-line flags: `--verbose` and `--quiet`

| Level | Description |
|-------|-------------|
| 0-1   | Error only |
| 2-3   | Warning and above |
| 4     | Info and above (default) |
| 5-6   | Debug and above |
| 7     | Trace (most verbose) |

### Using a Custom Logger

To use your own logger implementation, disable the default logger initialization:

```toml
[dependencies]
lxmd = { version = "x.y", default-features = false, features = [] }
```

Then initialize your logger before calling lxmd functions:

```rust
// Example: Android logcat
android_logger::init_once(android_logger::Config::default().with_tag("lxmd"));

// Example: Custom logger
struct MyLogger;
impl log::Log for MyLogger { ... }
log::set_logger(&MyLogger).unwrap();
log::set_max_level(log::LevelFilter::Info);
```

### Platform-Specific Loggers

#### Android

For Android platforms, you can use the built-in Android logger feature:

```toml
[dependencies]
lxmd = { version = "x.y", default-features = false, features = ["android-logger"] }
```

This automatically uses `android_logger` for logcat integration when running on Android.

## Features

- `init-logger` (default): Initialize `env_logger` on startup
- `android-logger`: Use Android's logcat for logging (Android only)