Enum Supervisor 

pub enum Supervisor {
    Launchd,
    Systemd,
}

The service manager this machine runs.

Variants

Launchd

macOS, per-user LaunchAgent.

Systemd

Linux, systemd --user.

Implementations

impl Supervisor

pub fn detect() -> Option<Supervisor>

What this machine has, if it has one.

By operating system rather than by probing for the binary: a mac without launchctl is a broken mac, and guessing systemd there would produce a unit file nothing will ever read.

pub fn unit_path(self, home: &Path) -> PathBuf

Where the unit file belongs under home.

pub fn render( self, exe: &Path, state: &Path, port: u16, extra: &[String], ) -> String

The unit file’s contents.

extra is forwarded to the daemon after --, the same spelling a person would type, so a supervised node and a hand-started one are the same command with the same arguments.

pub fn argv( self, exe: &Path, state: &Path, port: u16, extra: &[String], ) -> Vec<String>

The command the unit runs, as argv.

Shared by both renderings so the two supervisors cannot come to disagree about what a supervised node is.

pub fn commands(self, action: Action, home: &Path) -> Vec<Vec<String>>

The commands that load, stop and remove the unit, in order.

Returned as data rather than run here so a test can assert on what would be run without a service manager being involved, and so the caller can print them when it refuses.

impl Supervisor

pub fn backup_argv(self, exe: &Path, state: &Path, dest: &Path) -> Vec<String>

The command the timer runs, as argv: choir backup take.

pub fn backup_units(self, home: &Path) -> Vec<PathBuf>

The files a scheduled backup is, under home: one plist, or a service and the timer that fires it.

pub fn render_backup( self, exe: &Path, state: &Path, dest: &Path, every_secs: u64, ) -> Vec<String>

The contents of each of Self::backup_units, in the same order.

The log is backup.log beside the node’s own, so the record of every run is where choir node logs already looks.

pub fn backup_commands(self, action: Action, home: &Path) -> Vec<Vec<String>>

The commands that load or remove the timer, in order.

Stop is Uninstall here: a timer has no “for this boot”.

Trait Implementations

impl Clone for Supervisor

fn clone(&self) -> Supervisor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Supervisor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Supervisor

fn eq(&self, other: &Supervisor) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Supervisor

impl Eq for Supervisor

impl StructuralPartialEq for Supervisor