Struct RecordingControls 

pub struct RecordingControls { /* private fields */ }

A ControlFactory that registers nothing and remembers everything.

Public rather than #[cfg(test)] on purpose. f3 builds three commands on ServiceOperations and has to be able to test them without a service manager, and a double that lived behind #[cfg(test)] here would be invisible from another crate — which would leave f3 either untested or writing a second double that drifts from this one.

It is not a simulator. It stores what it was asked to register and reports it back, which is exactly enough to exercise the logic that sits above a service manager: the lock refusal, the record, the stale-path detection, the start-mode switch, and the promise that uninstall deletes nothing else.

Implementations

impl RecordingControls

pub fn new() -> Self

A factory holding no registrations.

pub fn calls(&self) -> Vec<String>

Every call made through this factory, in order, as "<operation> <name> (<mode>)".

pub fn registrations(&self) -> Vec<(StartMode, String, Registration)>

Every registration currently held, with the domain it is in.

pub fn definition(&self, name: &str) -> Option<ServiceDefinition>

The definition applied for a registration, if it is held.

pub fn edit(&self, name: &str, edit: impl FnOnce(&mut Registration))

Edits a held registration, as something outside this product would.

This is how the divergence and start-type problems are made reachable from a test: sc config, launchctl and systemctl can all change a registration after installation, and a status command that could not be shown detecting that would be a status command nobody had tested against the case it exists for.

Does nothing when no registration of that name is held.

Trait Implementations

impl Clone for RecordingControls

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ControlFactory for RecordingControls

fn control( &self, mode: StartMode, ) -> Result<Box<dyn ServiceControl>, ServiceError>

The control for one start-mode domain.

fn installed_definition(&self, _path: &Path) -> Option<String>

The text of an installed definition file, for drift detection. None when there is none to read. The default reads nothing, so a double never reports the real host’s unit as its own.

impl Debug for RecordingControls

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

Formats the value using the given formatter.

impl Default for RecordingControls

fn default() -> Self

Returns the “default value” for a type.