{"id":28386186,"url":"https://github.com/bitnami/wait-for-port","last_synced_at":"2025-06-26T13:32:02.609Z","repository":{"id":39996251,"uuid":"149101065","full_name":"bitnami/wait-for-port","owner":"bitnami","description":"CLI tool for waiting until a TCP port reaches the desired state","archived":false,"fork":false,"pushed_at":"2025-06-17T12:03:36.000Z","size":161,"stargazers_count":56,"open_issues_count":0,"forks_count":12,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-06-17T12:36:19.049Z","etag":null,"topics":["port"],"latest_commit_sha":null,"homepage":"https://bitnami.com","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/bitnami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-09-17T09:27:28.000Z","updated_at":"2025-06-17T11:59:54.000Z","dependencies_parsed_at":"2024-01-23T14:14:12.332Z","dependency_job_id":"5e757217-9011-469c-83ae-212d6fd12396","html_url":"https://github.com/bitnami/wait-for-port","commit_stats":{"total_commits":41,"total_committers":8,"mean_commits":5.125,"dds":0.7073170731707317,"last_synced_commit":"7685cb8855fca6c2eb08a2cf4aae66e6d2906950"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/bitnami/wait-for-port","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitnami%2Fwait-for-port","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitnami%2Fwait-for-port/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitnami%2Fwait-for-port/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitnami%2Fwait-for-port/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitnami","download_url":"https://codeload.github.com/bitnami/wait-for-port/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitnami%2Fwait-for-port/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262076732,"owners_count":23255060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["port"],"created_at":"2025-05-30T13:11:30.377Z","updated_at":"2025-06-26T13:32:02.554Z","avatar_url":"https://github.com/bitnami.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"[![Go Report Card](https://goreportcard.com/badge/github.com/bitnami/wait-for-port)](https://goreportcard.com/report/github.com/bitnami/wait-for-port)\n[![CI](https://github.com/bitnami/wait-for-port/actions/workflows/main.yml/badge.svg)](https://github.com/bitnami/wait-for-port/actions/workflows/main.yml)\n\n# wait-for-port\n\nThis tool allows waiting for a port to enter into the requested state (free or in use), with a customizable timeout\n\n# Basic usage\n\n```console\n$ wait-for-port --help\nUsage:\n  wait-for-port [OPTIONS] port\n\nApplication Options:\n  -h, --host=HOST             Host where to check for the port\n  -s, --state=[inuse|free]    State to wait for (default: inuse)\n  -t, --timeout=SECONDS       Timeout in seconds to wait for the port (default: 30)\n\nHelp Options:\n  -h, --help                  Show this help message\n```\n\n# Examples\n\n## Wait for a port to be in use\n\n```console\n$ wait-for-port --state=inuse 12345\n$ echo $?\n0\n```\n\nOr in a remote server:\n\n```console\n$ wait-for-port --host=myhost.example.com --state=inuse 12345\n$ echo $?\n0\n```\n\n## Wait for a port to be free\n\n```console\n$ wait-for-port --state=free 12345\n$ echo $?\n0\n```\n\nOr in a remote server:\n\n```console\n$ wait-for-port --host=myhost.example.com --state=free 12345\n$ echo $?\n0\n```\n\n## The tool times out before the port goes into the required state\n\nIf the port does not go into the required state under the provided timeout time, the process will return a non-zero exit code\nso it is easily recognizable from a parent process:\n\n```console\n$ wait-for-port --timeout=10 --state=inuse 13456\ntimeout reached before the port went into state \"inuse\"\n$ echo $?\n1\n```\n\n```console\n$ wait-for-port --timeout=10 --state=free 8080\ntimeout reached before the port went into state \"free\"\n$ echo $?\n1\n```\n\n## License\n\nCopyright \u0026copy; 2025 Broadcom. The term \"Broadcom\" refers to Broadcom Inc. and/or its subsidiaries.\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License.\n\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitnami%2Fwait-for-port","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitnami%2Fwait-for-port","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitnami%2Fwait-for-port/lists"}