Tsunagu (繋ぐ) — service/daemon IPC framework.

Provides reusable patterns for daemon lifecycle management:

• SocketPath: XDG-compliant Unix socket and PID file path resolution
• DaemonProcess: PID file management, staleness detection, and cleanup
• HealthCheck: standardized health/liveness/readiness responses

Quick Start

use tsunagu::{DaemonProcess, HealthCheck, SocketPath};

// Resolve paths for your app
let sock = SocketPath::for_app("myapp");
let pid = SocketPath::pid_file("myapp");
assert!(sock.to_string_lossy().contains("myapp"));

// Health check response
let hc = HealthCheck::healthy("myapp", "0.1.0");
assert!(hc.is_healthy());

Tsunagu (繋ぐ)

Service/daemon IPC framework for pleme-io applications. Provides reusable patterns for client-daemon communication so every app with a background service shares the same lifecycle management.

Components

Usage

[dependencies]
tsunagu = { git = "https://github.com/pleme-io/tsunagu" }

use tsunagu::{DaemonProcess, SocketPath};

let daemon = DaemonProcess::new("myapp");
if !daemon.is_running() {
    daemon.write_pid()?;
    // start gRPC server on daemon.socket_path()
}

Build

cargo build
cargo test --lib