Spawn Functions

The high level api to launch shell commands consists of four functions, well, actually two functions and two coroutines. They all accept the two keyword arguments $cwd and $fds, which we will get back to. The ones named with the word "blind" are non-blocking. That is, they launch the process and don't wait for it to return.

1. shell_command

Coroutine shell command launcher, waits for process to finish, and yields its exit status.

One positional argument, "command", is a full command line. Must be properly shell-escaped.

2. shell_command_with_argument

Variant of shell_command which takes a second position parameter, "arg", which will be substituted into the command wherever there is a "{}".

3. shell_command_blind

Normal function shell command launcher. Launches command and returns without waiting for process to complete.

One positional argument, command line to run.

If neither of the keyword arguments $cwd or $fds is given, then the call is made without using conkeror-spawn-helper.

4. shell_command_with_argument_blind

Variant of shell_command_blind which takes a second positional parameter, "arg", which will be substituted into the command wherever there is a "{}".