logcast 0.2.9

# logcast

![rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=rust&logoColor=white)

A helper that sends logs over TCP, for programs without terminal output, such as TUIs.

## Example

![logcast](https://raw.githubusercontent.com/matheus-git/logcast/main/screenshots/logcast.gif)

## Usage

### Integrate with the [log](https://docs.rs/log/latest/log/index.html) crate
See `examples/log.rs` for an example of integration with the [log](https://docs.rs/log/latest/log/index.html) crate.

```rust
// src/main.rs
use logcast::init_on_addr;

init_on_addr("127.0.0.1:8080");
log::info!("The logger seems to work");
```

Example output:

```shell
$ ncat -l --keep-open 8080
INFO:systemd_manager_tui::terminal::components::details -- Test
INFO:systemd_manager_tui::terminal::components::details -- Service { name: "bluetooth.service", description: "Bluetooth service", state: ServiceState { load: "loaded", active: "active", sub: "running", file: "enabled" } }
```

---

Another option is to create your own macro.

### Create macro

```rust
// src/macros.rs
macro_rules! log {
    ($($arg:tt)*) => {{
        crate::LOGGER.log(&format!($($arg)*));
    }};
}
```

###  Make the macro available globally and create the LOGGER

```rust
// src/main.rs
#[macro_use]
mod macros;

use std::sync::LazyLock;
use logcast::Logger;

pub static LOGGER: LazyLock<Logger> = LazyLock::new(|| Logger::new("127.0.0.1:8080"));
```

### Use macro with log!

```rust
// anywhere
log!("Test");
log!("{:?}", service);
```

### Output
To view the logs, open another terminal and run a program that listens for TCP connections, such as ```ncat -l --keep-open 8080```, as shown in the example below.

```shell
└─$ ncat -l --keep-open 8080 
[2025-11-10 20:55:04] Test
[2025-11-10 20:55:04] Service { name: "cron.service", description: "Regular background program processing daemon", state: ServiceState { load: "loaded", active: "active", sub: "running", file: "enabled" } }
```

## 📝 License

This project is open-source under the MIT License.