kodegen_daemon 0.0.4

KODEGEN.ᴀɪ background daemon service
Documentation 
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

# kodegen Daemon

A high-performance Unix daemon library with crossbeam-based service management.

## Features

- **Zero-allocation hot paths**: Uses crossbeam channels and fixed-size enums
- **True Unix daemon**: Double-fork daemonization with systemd auto-detection  
- **Service management**: Supervise processes with automatic restart and health monitoring
- **System integration**: Self-installation with systemd/launchd support
- **Async compatible**: Can manage async applications while using sync internals

## Quick Start

### As a Library

Add to your `Cargo.toml`:

```toml
[dependencies]
kodegen-daemon = "0.1"
```

Use in your application:

```rust
use kodegen_daemon::{ServiceConfig, ServiceDefinition, ServiceManager, daemonise};
use std::path::Path;

fn main() -> anyhow::Result<()> {
    // Daemonize the process
    let pid_file = Path::new("/var/run/mydaemon.pid");
    daemonise(&pid_file)?;

    // Create service configuration
    let mut config = ServiceConfig::default();
    config.services.push(ServiceDefinition {
        name: "my-service".to_string(),
        command: "/usr/bin/my-app --daemon".to_string(),
        auto_restart: true,
        ..Default::default()
    });

    // Start daemon manager
    let manager = ServiceManager::new(&config)?;
    manager.run()?; // Runs until SIGTERM/SIGINT
    Ok(())
}
```

### As a Standalone Daemon

Build and install:

```bash
cargo build --release
sudo ./target/release/kodegend install
```

Configure services in `/etc/kodegend/services/`:

```toml
# /etc/kodegend/services/my-app.toml
name = "my-app"
command = "/usr/local/bin/my-app --serve"
auto_restart = true
user = "www-data"
restart_delay_s = 5

[health_check]
check_type = "http"
target = "http://localhost:8080/health"
interval_secs = 30
```

Start the daemon:

```bash
sudo systemctl start kodegend
```

## Architecture

- **ServiceManager**: Central event loop using crossbeam channels
- **ServiceWorker**: Individual service supervisor threads  
- **IPC**: Wait-free message passing with `Cmd`/`Evt` enums
- **Daemon**: Unix daemonization with systemd detection
- **Installer**: Self-installation with system integration

## System Requirements

- Unix-like OS (Linux, macOS)
- systemd (Linux) or launchd (macOS) for system integration
- Root privileges for installation

## License

Apache-2.0