Enum watchexec::Shell

pub enum Shell {
    None,
    Unix(String),
    Powershell,
}

Shell to use to run commands.

Cmd and Powershell are special-cased because they have different calling conventions. Also Cmd is only available in Windows, while Powershell is also available on unices (provided the end-user has it installed, of course).

See Config.cmd for the semantics of None vs the other options.

Variants

None

Use no shell, and execute the command directly.

Unix(String)

Use the given string as a unix shell invocation.

This means two things:

• the program is invoked with -c followed by the command, and
• the string will be split on space, and the resulting vec used as execvp(3) arguments: first is the shell program, rest are additional arguments (which come before the -c mentioned above). This is a very simplistic approach deliberately: it will not support quoted arguments, for example. Use Shell::None with a custom command vec if you want that.

Powershell

Use Powershell, on Windows or elsewhere.

This is invoked with -Command followed by the command.

This is preferred over Unix("pwsh"), though that will also work on unices due to Powershell supporting the -c short option.

Implementations

impl Shell

pub fn to_command(&self, cmd: &[String]) -> Command

Obtain a Command given the cmd vec from Config.

Behaves as described in the enum documentation.

Panics

• Panics if cmd is empty.
• Panics if the string in the Unix variant is empty or only whitespace.

Trait Implementations

impl Clone for Shell

fn clone(&self) -> Shell

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Shell

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

Formats the value using the given formatter.

impl Default for Shell

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<Shell> for Shell

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Eq for Shell

impl StructuralEq for Shell

impl StructuralPartialEq for Shell