{"id":16551734,"url":"https://github.com/stavrospanakakis/is_ready","last_synced_at":"2025-06-25T14:33:42.324Z","repository":{"id":236507445,"uuid":"658428371","full_name":"Stavrospanakakis/is_ready","owner":"Stavrospanakakis","description":"Wait for multiple services to become available with zero dependencies","archived":false,"fork":false,"pushed_at":"2024-12-09T10:02:17.000Z","size":63,"stargazers_count":137,"open_issues_count":6,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-25T09:07:01.837Z","etag":null,"topics":["automation","cli","docker","rust","script","wait","wait-for","wait-for-it"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Stavrospanakakis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2023-06-25T18:00:00.000Z","updated_at":"2025-05-16T21:45:15.000Z","dependencies_parsed_at":"2024-06-19T11:22:46.883Z","dependency_job_id":"bb6d0bbc-4a47-4e92-aa14-306a04671350","html_url":"https://github.com/Stavrospanakakis/is_ready","commit_stats":{"total_commits":24,"total_committers":4,"mean_commits":6.0,"dds":"0.41666666666666663","last_synced_commit":"4ff5d7def790bef08ba48dc946b3790af1433ac8"},"previous_names":["stavrospanakakis/is_ready"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Stavrospanakakis/is_ready","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stavrospanakakis%2Fis_ready","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stavrospanakakis%2Fis_ready/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stavrospanakakis%2Fis_ready/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stavrospanakakis%2Fis_ready/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Stavrospanakakis","download_url":"https://codeload.github.com/Stavrospanakakis/is_ready/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stavrospanakakis%2Fis_ready/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261892119,"owners_count":23225860,"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":["automation","cli","docker","rust","script","wait","wait-for","wait-for-it"],"created_at":"2024-10-11T19:43:01.848Z","updated_at":"2025-06-25T14:33:42.296Z","avatar_url":"https://github.com/Stavrospanakakis.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# is_ready\n\n`is_ready` is a self-contained program designed to wait until multiple addresses become \naccessible. Its purpose is to coordinate the startup of interconnected services, such as \nDocker containers that rely on one another. This tool does not rely on any external \ndependencies and can be executed as a standalone binary.\n\n## Table of Contents\n- [Why](#why)\n- [Examples](#examples)\n- [Installation \u0026 Usage](#installation--usage)\n  - [Use inside Docker](#use-inside-docker)\n  - [Use as a Docker container](#use-as-a-docker-container)\n- [License](#license)\n\n## Why\nThere are alternative solutions like \n[`wait-for-it`](https://github.com/vishnubob/wait-for-it) and [`wait-for`](https://github.com/eficode/wait-for). The key differentiating factor of `is_ready` compared to \nalternative solutions is its ability to wait for the availability of multiple addresses, \nnot only one. Finally, unlike other options, `is_ready` stands out as a self-contained binary, eliminating the need for any external dependencies.\n\n## Examples\n```bash\n$ is_ready --help\n\nUsage: is_ready [OPTIONS] --addr \u003cADDRESS\u003e -- \u003cCOMMAND\u003e...\n\nArguments:\n  \u003cCOMMAND\u003e...\n\nOptions:\n  -t, --timeout \u003cTIMEOUT\u003e  [default: 30]\n  -a, --addr \u003cADDRESS\u003e\n  -q, --quiet              Suppress output\n  -h, --help               Print help\n  -V, --version            Print version\n\n\n$ is_ready \\\n    --timeout 10 \\\n    --addr github.com:80 \\\n    --addr google.com:80 \\\n    -- echo \"The addresses are available\"\n\nConnected to google.com:80 successfully\nConnected to github.com:80 successfully\nThe addresses are available\n```\n\n## Installation \u0026 Usage\n\n`is_ready` is optimized for running in a Docker container, and it is ideal to wait for the availability of other services such as databases, caches, or other services.\n\n### Use inside Docker\nExample using the Docker Image:\n\n```Dockerfile\n# Set the version you want to download\nARG IS_READY_VERSION=1.0.2\nFROM ghcr.io/stavrospanakakis/is_ready:$IS_READY_VERSION AS is_ready\n\nFROM alpine:3.19\n\nRUN apk add --no-cache curl\n\n# Download the binary\nCOPY --from=is_ready /is_ready /usr/local/bin/is_ready\n\n...\n...\n```\n\nExample using `curl`:\n```Dockerfile\nFROM alpine:3.19\n\nRUN apk add --no-cache curl\n\n# Set the version you want to download\nENV IS_READY_VERSION=v1.0.2\n\n# Download the binary\nRUN curl -L https://github.com/Stavrospanakakis/is_ready/releases/download/${IS_READY_VERSION}/is_ready_${IS_READY_VERSION}_x86_64-unknown-linux-musl.tar.gz | tar xzf - -C /usr/local/bin\n\n...\n...\n```\n\nExample Docker Compose:\n```yaml\nversion: '3'\nservices:\n  mysql:\n    image: mysql:8.0\n  \n  app:\n    build: .\n    command: is_ready --timeout 10 --addr mysql:3306 -- echo \"MySQL is ready\"\n```\n\n\n### Use as a Docker container\n`is_ready` can be also used as a Docker container using the \n[`ghcr.io/stavrospanakakis/is_ready`](https://github.com/Stavrospanakakis/is_ready/pkgs/container/is_ready) image from GitHub Container Registry.\n\n```\n$ VERSION=1.0.2\n$ docker run --rm ghcr.io/stavrospanakakis/is_ready:$VERSION --version\nis_ready 1.0.2\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstavrospanakakis%2Fis_ready","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstavrospanakakis%2Fis_ready","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstavrospanakakis%2Fis_ready/lists"}