Expand description
Process and service spawner abstraction.
Provides unified interfaces for spawning:
- Raw processes via
ProcessSpawner(Standalone or Systemd backends) - RPC services via
ServiceSpawner(Tokio, Thread, or Subprocess modes)
§Architecture
ProcessSpawner (raw process management)
├── StandaloneBackend (tokio::process::Command)
│ └── .kill_on_drop(false): adopted daemons outlive the launcher
│
└── SystemdBackend (systemd-run)
└── Transient units in hyprstream-workers.slice
ServiceSpawner (RequestService hosting)
├── Tokio mode (tokio::spawn)
├── Thread mode (std::thread + runtime)
└── Subprocess mode (ProcessSpawner)§Usage
ⓘ
use hyprstream_rpc::service::spawner::{ProcessSpawner, ProcessConfig};
// Auto-detect best backend (systemd if available)
let spawner = ProcessSpawner::new();
// Spawn a daemon
let config = ProcessConfig::new("nydusd", "/usr/bin/nydusd")
.args(["--config", "/etc/nydusd.json"])
.working_dir("/var/run/hyprstream");
let process = spawner.spawn(config).await?;
println!("Spawned: {:?}", process.id());
// Later, stop the daemon
spawner.stop(&process).await?;Structs§
- Dual
Spawnable - Wrapper that runs two Spawnables: primary on calling thread, secondary on a sub-thread.
- Inproc
Manager - In-process service manager
- Process
Config - Configuration for spawning a daemon process.
- Process
Spawner - Unified process spawner.
- Service
Spawner - Unified service spawner.
- Spawned
Process - Represents a spawned process.
- Spawned
Service - Handle for a spawned service.
- Standalone
Backend - Standalone process spawner backend.
- Systemd
Backend - Systemd spawner backend using transient units.
- Unified
Service Config - Spawnable wrapper that runs a RequestService with explicit QUIC configuration.
Enums§
- Process
Backend - Backend type for process spawning.
- Process
Kind - Type of spawned process.
- Process
Readiness - Readiness policy for a spawned child process (#1585).
- Service
Kind - Kind of spawned service (determines cleanup behavior).
- Service
Mode - Mode for spawning services.
Traits§
- Spawnable
- Trait for services that can be spawned by ServiceSpawner.
- Spawner
Backend - Trait for process spawning backends.