12 releases
0.1.12 | Apr 12, 2023 |
---|---|
0.1.11 | Dec 24, 2022 |
0.1.8 | Sep 20, 2022 |
0.1.7 | Jul 8, 2022 |
0.1.2 | Apr 30, 2021 |
#61 in Concurrency
47 downloads per month
14KB
257 lines
parallel-sh
parallel-sh
was heavily inspired by Rust Parallel (parallel) parallelizing 'otherwise non-parallel command-line tasks.' But instead of trying to recreate the full functionality of GNU Parallel parallel-sh
will simply execute (lines of) commands in the platform's preferred shell ('sh -c' on Unix systems, and 'powershell.exe -c' on Windows) in separate threads.
What to expect:
- Output (stdout and stderr) of each child process is stored and printed only after the child exits.
- There is some simple logging and some runtime metric (via -v, -vv or -vvv) available.
- The whole crate is tiny, <300 lines of code (w/ ~25% command line argument parsing), and can quickly be modified to meet more complex requirements.
What is not part of parallel-sh
:
- There are no replacement strings (e.g. '{}') or input tokens. Commands will be executed as provided by argument, file or via stdin.
- Command sources will not be 'linked'. Arguments will be processed by preference:
- If ARGS are found,
--file
option and stdin are ignored. - If
--file
is provided anything on stdin is ignored. - Only when there are no command arguments and no '--file' option is found, any lines on stdin are treated as commands to execute.
- If ARGS are found,
- There is no '--pipe'. Stdin is not inherited from the parent and any attempt by the child processes to read from the stdin stream will result in the stream immediately closing.
If you need any of these to be part of your parallelizing tool please check GNU Parallel or Rust Parallel.
Most of the effects of these features can be achieved by processing the commands before passing them to parallel-sh
.
Options
parallel-sh 0.1.1
Execute commands in parallel
USAGE:
parallel-sh [FLAGS] [OPTIONS] [clijobs]...
FLAGS:
--dry-run Perform a trial run, only print what would be done (with -vv)
--halt-on-error Stop execution if an error occurs in any thread
-h, --help Prints help information
-q, --quiet Do not print `parallel-sh` warnings
-v, --verbose Sets the level of verbosity
-V, --version Prints version information
OPTIONS:
-f, --file <FILE> Read commands from file (one command per line)
-l, --log <FILE> Log output to file
-j, --jobs <THREADS> Number of parallel executions
ARGS:
<clijobs>...
Preference
-
Pass commands as arguments:
parallel-sh "sleep 2 && echo first" "sleep 1 && echo second"
-
Pass a file with one command (-line) per line:
parallel-sh -f /tmp/commands $ cat /tmp/commands sleep 2 && echo first sleep 1 && echo second
-
Pass commands via stdin:
echo -e 'sleep 2 && echo first\nsleep 1 && echo second' |parallel-sh
Dependencies
~2.2–3MB
~55K SLoC