Struct Open 

pub struct Open<Msg> { /* private fields */ }

Starts a program beside the application: the desktop’s own opener for an address or a path, or a program named outright. The screen stays where it is and nothing is drawn again.

The answer is optional. With Open::answer a message says whether the program was started; whether the desktop then really showed the thing is not something a terminal can know, so OpenOutcome::Opened says the opener was handed the target and no more.

use qframe::prelude::*;
use qframe::runtime::{Open, OpenOutcome};

enum Msg {
    SignIn(String),
    Opened(OpenOutcome),
}

fn update(msg: Msg) -> Command<Msg> {
    match msg {
        // The address goes to whatever browser this person uses; the screen never blinks.
        Msg::SignIn(address) => Command::open_with(Open::new(address).answer(Msg::Opened)),
        Msg::Opened(_) => Command::none(),
    }
}

Implementations

impl<Msg: Send + 'static> Open<Msg>

pub fn new(target: impl Into<OsString>) -> Self

Opens target — an address, a file or a folder — with the opener of this desktop: xdg-open, open on macOS, start on Windows.

pub fn program(program: impl Into<OsString>) -> Self

Starts program itself instead of the desktop’s opener, the same way: quietly, beside the application, with nothing drawn again.

pub fn arg(self, arg: impl Into<OsString>) -> Self

Adds one argument.

pub fn args(self, args: impl IntoIterator<Item = impl Into<OsString>>) -> Self

Adds several arguments, in order.

pub fn dir(self, dir: impl Into<PathBuf>) -> Self

Starts the program in dir instead of the application’s working directory.

pub fn env(self, key: impl Into<OsString>, value: impl Into<OsString>) -> Self

Sets an environment variable for the program. The rest of the environment is inherited.

pub fn answer( self, on_open: impl FnOnce(OpenOutcome) -> Msg + Send + 'static, ) -> Self

Delivers on_open(outcome) once the program has been started, or could not be.

Without it nothing is delivered: an application that has nothing to say about the opening asks for no message.