{"id":23613691,"url":"https://github.com/freckle/await-statuses-action","last_synced_at":"2025-11-06T09:30:34.701Z","repository":{"id":154521754,"uuid":"621815414","full_name":"freckle/await-statuses-action","owner":"freckle","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-24T00:09:39.000Z","size":955,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-24T04:38:38.567Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/freckle.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-31T12:54:44.000Z","updated_at":"2024-10-24T00:09:42.000Z","dependencies_parsed_at":"2023-10-24T01:49:44.851Z","dependency_job_id":"0c28b4cc-f0d6-49ae-baf5-fcb04902cbfa","html_url":"https://github.com/freckle/await-statuses-action","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":"freckle/typescript-action-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freckle%2Fawait-statuses-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freckle%2Fawait-statuses-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freckle%2Fawait-statuses-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freckle%2Fawait-statuses-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freckle","download_url":"https://codeload.github.com/freckle/await-statuses-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239491352,"owners_count":19647811,"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":[],"created_at":"2024-12-27T17:18:48.172Z","updated_at":"2025-11-06T09:30:34.630Z","avatar_url":"https://github.com/freckle.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Await Statuses Action\n\nAwait statuses on a ref. Succeed only when all succeed. Fail when any fail.\n\n## Usage\n\nRun this step until three statuses have succeeded on the current ref:\n\n```yaml\n- uses: freckle/await-statuses-action@v1\n  with:\n    statuses: |\n      test-this\n      build-that\n      other / thing (that)\n```\n\n## Inputs and Outputs\n\n- **ref**: the reference (branch or SHA) to poll statuses on\n- **statuses**: status names to wait for, as a newline-separated string\n- **poll-seconds**: number of seconds between polls\n- **poll-limit**: maximum number of polls before giving up\n- **github-token**: token to use\n\nSee [action.yml](./action.yml) for a complete list of inputs and outputs.\n\n## Optional Statuses\n\nElements in the `statuses` list may optionally be suffixed by any number of\nspaces and a `?`. This makes it acceptable if they never appear, but will still\nconsider it a failure if they do appear as failed. This can be useful for matrix\njobs whose statuses never appear in certain skipped scenarios, but we still want\nto account for them if they fail.\n\nChanging our usage example to:\n\n```yaml\n- uses: freckle/await-statuses-action@v1\n  with:\n    statuses: |\n      test-this\n      build-that\n      other / thing (that) ?\n```\n\nThis will result in us proceeding even if `other / thing (that)` never shows up,\nbut if it ever shows up as failed, we will still fail immediately.\n\n## Caveats\n\nThis action works by querying the GitHub API for check-suites and their\ncheck-runs. Statuses set directly on commits, and which only appear in the\n`/commits/status` API, will not be visible to this action. That's simply because\nthe check-suite statuses are all _we_ need at the moment. Patches welcome.\n\n## Versioning\n\nVersioned tags will exist, such as `v1.0.0` and `v2.1.1`. Branches will exist\nfor each major version, such as `v1` or `v2` and contain the newest version in\nthat series.\n\n### Release Process\n\nGiven a latest version of v1.0.1,\n\nIs this a new major version?\n\nIf yes,\n\n```console\ngit checkout main\ngit pull\ngit checkout -b v2\ngit tag -s -m v2.0.0 v2.0.0\ngit push --follow-tags\n```\n\nOtherwise,\n\n```console\ngit checkout main\ngit pull\ngit checkout v1\ngit merge --ff-only -\ngit tag -s -m v1.0.2 v1.0.2    # or v1.1.0\ngit push --follow-tags\n```\n\n---\n\n[LICENSE](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreckle%2Fawait-statuses-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreckle%2Fawait-statuses-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreckle%2Fawait-statuses-action/lists"}