README.md

rust-for-it

About

rust-for-it is a lookalike of (the perfectly fine) Python wait-for-it written in Rust 1.69+.

It supports waiting for multiple services concurrently by default, and has a test coverage of >90%. If you do find bugs, please file a report. Thank you!

Build and run

$ cargo run -- --help

… or …

$ cargo build
$ export PATH="${PWD}/target/debug:${PATH}"
$ rust-for-it --help

Examples

$ rust-for-it -t 2 -s [::1]:631 -s localhost:631 -s 127.0.0.1:631 -- echo 'CUPS is very available'
[*] Waiting 2 seconds for localhost:631...
[*] Waiting 2 seconds for [::1]:631...
[+] [::1]:631 is available after 0 seconds.
[*] Waiting 2 seconds for 127.0.0.1:631...
[+] 127.0.0.1:631 is available after 0 seconds.
[+] localhost:631 is available after 0 seconds.
CUPS is very available

Usage

$ rust-for-it --help
Wait for one or more services to be available before executing a command.

Usage: rust-for-it [OPTIONS] [command]...

Arguments:
  [command]...  Command to run after waiting;
                includes command arguments, resolved against ${PATH}

Options:
  -q, --quiet                     Do not output any status messages
  -S, --strict                    Only execute <command> if all services are found available [default: always executes]
  -t, --timeout <seconds>         Timeout in seconds, 0 for no timeout [default: 15]
  -s, --service [<host:port>...]  Service to test via the TCP protocol; can be passed multiple times
  -h, --help                      Print help
  -V, --version                   Print version

Alternatives

Go

• github.com/alioygur/wait-for
• github.com/hartwork/go-wait-for-it
• github.com/maxcnunes/waitforit
• github.com/mjeri/go-wait-for-it

Python

• github.com/clarketm/wait-for-it — package wait-for-it on PyPI
• github.com/David-Lor/python-wait4it — package wait4it on PyPI

Rust

• github.com/Etenil/wait-for-rust
• github.com/hartwork/rust-for-it — the one you are looking at
• github.com/ktitaro/wait-for — package wait_for on crates.io
• github.com/magiclen/wait-service — package wait-service on crates.io
• github.com/shenek/wait-for-them — package wait-for-them on crates.io

Shell

• github.com/eficode/wait-for — POSIX shell
• github.com/vishnubob/wait-for-it — Bash, package wait-for-it in Debian