mirror of
https://github.com/Luzifer/waitfor.git
synced 2024-12-21 02:41:20 +00:00
44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
|
[](https://goreportcard.com/report/github.com/Luzifer/waitfor)
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
# Luzifer / waitfor
|
||
|
|
|
||
|
|
`waitfor` is a small utility to check the exit code of an command to be used within a shell command.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ waitfor --help
|
||
|
|
Usage of waitfor:
|
||
|
|
-i, --check-interval duration How long to wait after an unsuccessful check (default 1s)
|
||
|
|
-c, --command-timeout duration Stop the command execution after this time
|
||
|
|
--log-level string Log level (debug, info, warn, error, fatal) (default "info")
|
||
|
|
-s, --shell string Shell to execute with the given command (must accept -c flag) (default "/bin/bash")
|
||
|
|
--version Prints current version and exits
|
||
|
|
-w, --wait-timeout duration Stop waiting for the command after this time
|
||
|
|
```
|
||
|
|
|
||
|
|
When a `wait-timeout` is specified and the check command did not exit with status code 0 before the timeout is reached `waitfor` will exit with status 1. This ensures a shell command connected with `&&` is not executed afterwards.
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
- Wait for the VPN connection to be available before executing a command using it
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ waitfor 'ip a | grep 10.123.0' && echo "VPN connected"
|
||
|
|
```
|
||
|
|
|
||
|
|
- Ensure you are online before executing a curl command
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ waitfor -- ping -c 1 8.8.8.8 && curl ...
|
||
|
|
```
|
||
|
|
|
||
|
|
- Wait at most 5m for a file to appear before accessing it
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ waitfor -w 5m -- ls myfile && cat myfile
|
||
|
|
```
|