{"id":20773875,"url":"https://github.com/simonmittag/pwt","last_synced_at":"2026-04-28T04:02:09.095Z","repository":{"id":103677225,"uuid":"263427812","full_name":"simonmittag/pwt","owner":"simonmittag","description":"pwt (\"port wait\") is a liveness or readyness probe that waits on the client-side until an upstream tcp port becomes available. ","archived":false,"fork":false,"pushed_at":"2023-06-16T02:37:42.000Z","size":1815,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-27T13:14:58.580Z","etag":null,"topics":["availability","availability-checker","availability-monitor","bash","cli","command-line","command-line-tool","command-line-tools","continuous-integration","liveness-probe","network","port","port-wait","ready-or-not-hack","readyness","readyness-probe","testing"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonmittag.png","metadata":{"files":{"readme":"ReadMe.Md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-12T19:08:43.000Z","updated_at":"2023-09-01T08:29:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"e5f040ab-1dca-4156-ab20-2cc320af0919","html_url":"https://github.com/simonmittag/pwt","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/simonmittag/pwt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmittag%2Fpwt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmittag%2Fpwt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmittag%2Fpwt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmittag%2Fpwt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonmittag","download_url":"https://codeload.github.com/simonmittag/pwt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmittag%2Fpwt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32365519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["availability","availability-checker","availability-monitor","bash","cli","command-line","command-line-tool","command-line-tools","continuous-integration","liveness-probe","network","port","port-wait","ready-or-not-hack","readyness","readyness-probe","testing"],"created_at":"2024-11-17T12:27:34.767Z","updated_at":"2026-04-28T04:02:09.042Z","avatar_url":"https://github.com/simonmittag.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](pwt.png)\n\n`pwt` (\"port wait\") is a commandline utility that blocks until a tcp socket, aka port becomes available. Designed to \nreplace the bash sleep command in your CI/CD scripts, this process will exit with `0` once the socket connects, or `-1`\nin the event of a timeout. \n\n[![Circleci Builds](https://circleci.com/gh/simonmittag/pwt.svg?style=shield)](https://circleci.com/gh/simonmittag/pwt)\n[![Github Workflows](https://github.com/simonmittag/mse6/workflows/Go/badge.svg)](https://github.com/simonmittag/pwt/actions)\n[![Github Issues](https://img.shields.io/github/issues/simonmittag/pwt)](https://github.com/simonmittag/pwt/issues)\n[![Github Activity](https://img.shields.io/github/commit-activity/m/simonmittag/pwt)](https://img.shields.io/github/commit-activity/m/simonmittag/pwt)  \n[![CodeClimate Maintainability](https://api.codeclimate.com/v1/badges/70cd59e4dfd2801f8661/maintainability)](https://codeclimate.com/github/simonmittag/pwt/maintainability)\n[![CodeClimate Test Coverage](https://api.codeclimate.com/v1/badges/70cd59e4dfd2801f8661/test_coverage)](https://codeclimate.com/github/simonmittag/pwt/test_coverage)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/simonmittag/pwt)](https://img.shields.io/github/go-mod/go-version/simonmittag/pwt)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Version](https://img.shields.io/badge/version-0.1.7-orange)](https://github.com/simonmittag/pwt/releases/tag/v0.1.6)\n\n## What's New\n### v0.1.7\n* -h -v flags for cli\n* bumped to go 1.20\n\n## Up and running\n### Homebrew\n```\nbrew tap simonmittag/cli \u0026\u0026\n  brew install pwt \u0026\u0026\n  pwt \n```\n\n### Golang\n```bash\ngit clone https://github.com/simonmittag/pwt \u0026\u0026 cd pwt \u0026\u0026 \ngo install github.com/simonmittag/pwt/cmd/pwt \u0026\u0026 \npwt \n```\n\n## Usage\n```\nλ pwt[v0.1.7]\nUsage: pwt [-v]|[-w n] host[:port]\n  -h    print usage instructions\n  -v    print pwt version\n  -w int\n        time wait in seconds (default 10)\n```\n\n## Examples\n\nWait for ipv4 localhost on default port\n```\nλ pwt 127.0.0.1\n  pwt waiting for 127.0.0.1:80 .......... aborted after 10 seconds  \n```\n\nWait for ipv6 localhost on port 8080 for 3 seconds\n```\nλ pwt -w 3 [::1]:8080\n  pwt waiting for [::1]:8080 .. connected in 2 seconds\n```\n\nWait for google on port 443\n```\nλ pwt -w 60 google.com:443\n  pwt waiting for google.com:443 connected in \u003c1 second  \n```\n\n## Contributions\nThe pwt team welcomes all [contributors](https://github.com/simonmittag/pwt/blob/master/CONTRIBUTING.md). Everyone interacting with the project's codebase, issue trackers, chat rooms and mailing lists\nis expected to follow the [code of conduct](https://github.com/simonmittag/pwt/blob/master/CODE_OF_CONDUCT.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonmittag%2Fpwt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonmittag%2Fpwt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonmittag%2Fpwt/lists"}