logcast

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

Example

Usage

Add logcast and once_cell

cargo add logcast once_cell

Create Macro

This code defines a global, thread-safe TCP logger using a singleton (LOGGER) initialized lazily with once_cell::sync::Lazy.

// src/macros/log/mod.rs
use logcast::Logger;
use once_cell::sync::Lazy;

pub static LOGGER: Lazy<Logger> = Lazy::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.