Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hartwork/go-wait-for-it
:beaver: Wait for service(s) to be available before executing a command.
https://github.com/hartwork/go-wait-for-it
agpl command-line-tool concurrent cross-platform go golang network tcp wait-for-it
Last synced: 17 days ago
JSON representation
:beaver: Wait for service(s) to be available before executing a command.
- Host: GitHub
- URL: https://github.com/hartwork/go-wait-for-it
- Owner: hartwork
- Created: 2020-11-05T18:40:34.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-15T23:41:03.000Z (4 months ago)
- Last Synced: 2024-07-16T03:24:02.162Z (4 months ago)
- Topics: agpl, command-line-tool, concurrent, cross-platform, go, golang, network, tcp, wait-for-it
- Language: Go
- Homepage:
- Size: 186 KB
- Stars: 9
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# go-wait-for-it
## About
**wait-for-it** is a lookalike of
(the perfectly fine)
Python [wait-for-it](https://github.com/clarketm/wait-for-it)
written in Go 1.20+.
It supports waiting for multiple services concurrently by default,
and has a test coverage of 100%.
If you do find bugs, [please file a report](https://github.com/hartwork/go-wait-for-it/issues).
Thank you!
## Install and run
```console
$ go install github.com/hartwork/go-wait-for-it/v2/cmd/wait-for-it@latest
$ export PATH="${PATH}:$(go env GOPATH)/bin"
$ wait-for-it --version
wait-for-it 2.0.0
```
## Build and run
```console
$ ( cd v2 && go build ./cmd/wait-for-it )
$ ./v2/wait-for-it --version
wait-for-it 2.0.0
```
## Examples
```console
$ wait-for-it -t 2 -s :631 -s [::1]:631 -s localhost:631 -s 127.0.0.1:631 -- echo 'CUPS is very available'
[*] Trying to connect to :631...
[*] Trying to connect to [::1]:631...
[*] Trying to connect to localhost:631...
[*] Trying to connect to 127.0.0.1:631...
[+] Connected to [::1]:631 after 5.458196ms.
[+] Connected to 127.0.0.1:631 after 201.653µs.
[+] Connected to :631 after 158.548µs.
[+] Connected to localhost:631 after 381.536µs.
[*] Running command: echo CUPS is very available
CUPS is very available
[+] Command succeeded.
```
## Usage
```console
$ wait-for-it --help
Wait for service(s) to be available before executing a command.
Usage:
wait-for-it [flags] [-s|--service [HOST]:PORT]... [--] [COMMAND [ARG ..]]
Flags:
-h, --help help for wait-for-it
-q, --quiet do not output any status messages
-s, --service strings services to test (format '[HOST]:PORT')
-t, --timeout uint timeout in seconds, 0 for no timeout (default 15)
-v, --version version for wait-for-it
wait-for-it is software libre, licensed under the AGPL v3 or later license.
Please report bugs at https://github.com/hartwork/go-wait-for-it/issues. Thank you!
```
## Alternatives
### Go
- [`github.com/alioygur/wait-for`](https://github.com/alioygur/wait-for)
- [`github.com/hartwork/go-wait-for-it`](https://github.com/hartwork/go-wait-for-it) — the one you are looking at
- [`github.com/maxcnunes/waitforit`](https://github.com/maxcnunes/waitforit)
- [`github.com/mjeri/go-wait-for-it`](https://github.com/mjeri/go-wait-for-it)
### Python
- [`github.com/clarketm/wait-for-it`](https://github.com/clarketm/wait-for-it)
— package `wait-for-it` [on PyPI](https://pypi.org/project/wait-for-it/)
- [`github.com/David-Lor/python-wait4it`](https://github.com/David-Lor/python-wait4it/)
— package `wait4it` [on PyPI](https://pypi.org/project/wait4it/)
### Rust
- [`github.com/Etenil/wait-for-rust`](https://github.com/Etenil/wait-for-rust)
- [`github.com/hartwork/rust-for-it`](https://github.com/hartwork/rust-for-it)
- [`github.com/ktitaro/wait-for`](https://github.com/ktitaro/wait-for)
— package `wait_for` [on crates.io](https://crates.io/crates/wait_for)
- [`github.com/magiclen/wait-service`](https://github.com/magiclen/wait-service)
— package `wait-service` on [crates.io](https://crates.io/crates/wait-service)
- [`github.com/shenek/wait-for-them`](https://github.com/shenek/wait-for-them)
— package `wait-for-them` [on crates.io](https://crates.io/crates/wait-for-them)
### Shell
- [`github.com/eficode/wait-for`](https://github.com/eficode/wait-for)
— POSIX shell
- [`github.com/vishnubob/wait-for-it`](https://github.com/vishnubob/wait-for-it)
— Bash, package `wait-for-it` [in Debian](https://packages.debian.org/unstable/wait-for-it)