logcast

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

Example

Usage

See "log" example for example with integration with log crate

Add logcast

cargo add logcast

Create Macro

This code defines a global, thread-safe TCP logger using a singleton (LOGGER) initialized lazily.

// src/macros/log/mod.rs
use logcast::Logger;
use std::sync::LazyLock;

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

#[macro_export]
macro_rules! log {
    ($($arg:tt)*) => {{
        $crate::LOGGER.log(&format!($($arg)*));
    }};
}

Import LOGGER

Import LOGGER in main.rs to allow the macro to access it from any module.

// src/main.rs
use macros::log::LOGGER;

Import macro

use crate::log;

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.

└─$ 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.