Struct Open 

pub struct Open { /* private fields */ }

A running QCode, as the other QCodes and the service see it: a shared lock on the lock file, held for as long as this value lives.

Any number of QCodes hold one at once. Taking it waits only while the service is stopping containers, so a QCode starting then waits for that instead of starting a container the service is about to stop.

Implementations

impl Open

pub fn hold(places: Places) -> Result<Self>

Takes the shared lock at places, making its folder first.

Errors

When the folder or the file cannot be made or locked, and io::ErrorKind::Unsupported on Windows.

pub fn close( self, on_close: &dyn Fn() -> OnClose, engines: &mut Engines<'_>, ) -> Result<Option<Reaped>>

Closes this QCode: lets go of its lock and, when no other QCode holds one, does the service’s work itself — stops the listed containers if on_close says to and empties the list. Answers what came of it, or None when another QCode is still open or the service is already at work.

The setting is asked for only once this is the last QCode, so a choice made in another QCode a moment ago counts. The exclusive lock is asked for without waiting and held for the stopping only: a QCode starting meanwhile waits for it.

Errors

When the lock file cannot be opened, or what stays listed cannot be written.

Trait Implementations

impl Debug for Open

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

Formats the value using the given formatter.