Skip to main content

Module spawner

Module spawner 

Source
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§

DualSpawnable
Wrapper that runs two Spawnables: primary on calling thread, secondary on a sub-thread.
InprocManager
In-process service manager
ProcessConfig
Configuration for spawning a daemon process.
ProcessSpawner
Unified process spawner.
ServiceSpawner
Unified service spawner.
SpawnedProcess
Represents a spawned process.
SpawnedService
Handle for a spawned service.
StandaloneBackend
Standalone process spawner backend.
SystemdBackend
Systemd spawner backend using transient units.
UnifiedServiceConfig
Spawnable wrapper that runs a RequestService with explicit QUIC configuration.

Enums§

ProcessBackend
Backend type for process spawning.
ProcessKind
Type of spawned process.
ProcessReadiness
Readiness policy for a spawned child process (#1585).
ServiceKind
Kind of spawned service (determines cleanup behavior).
ServiceMode
Mode for spawning services.

Traits§

Spawnable
Trait for services that can be spawned by ServiceSpawner.
SpawnerBackend
Trait for process spawning backends.