Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 1.67 KB

README.md

File metadata and controls

37 lines (27 loc) · 1.67 KB
Raw

WaiT For the Command (wtfc)

Build Status

Shell script capable of waiting for command execution exit status for specified timeout.

Works well with POSIX shells:

  • ash, bash, dash, ksh and zsh on Linux, OSX, Busybox as well as git-bash on Windows (see our CI env).

Shells we don't support include:

  • tcsh|csh (due to missing function definition support) and fish.

Usage

Usage: wtfc.sh [OPTION]... [COMMAND]
wtfc (WaiT For The Command) waits for the COMMAND provided as the last argument or via standard input to return within timeout with expected exit status.

Functional arguments:
  -I, --interval=SECONDS       set the check interval to SECONDS (default is 1)
  -S, --status=NUMBER          set the expected COMMAND exit status to NUMBER (default is 0)
  -T, --timeout=SECONDS        set the timeout to SECONDS (0 for no timeout, default is 1)

Logging and info arguments:
  -P, --progress               show progress (default is 0)
  -H, --help                   print this help and exit
  -Q, --quiet                  be quiet
  -V, --version                display the version of wtfc and exit.

Examples:
  ./wtfc.sh -T 1 -S 0 ls /tmp                   Waits for 1 second for 'ls /tmp' to execute with exit status 0
  echo "ls /foo/bar" | ./wtfc.sh -T 2 -S 2      Waits for 2 seconds for 'ls /foo/bar' to execute with exit status 2

Inspiration

Inspired by wait-for-it as well as wait-for-command.