{"id":20415443,"url":"https://github.com/riot-os/check-labels-action","last_synced_at":"2025-04-12T17:06:39.464Z","repository":{"id":151046952,"uuid":"290280193","full_name":"RIOT-OS/check-labels-action","owner":"RIOT-OS","description":"Action that checks the labels of a Pull Request and will succeed or fail based on the configuration.","archived":false,"fork":false,"pushed_at":"2024-06-05T08:12:25.000Z","size":27,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-26T11:21:26.725Z","etag":null,"topics":["checker","github","github-actions","github-labels","labels"],"latest_commit_sha":null,"homepage":"","language":"Python","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/RIOT-OS.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":"2020-08-25T17:30:40.000Z","updated_at":"2024-06-05T08:09:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"958abeb7-ed5a-430e-bc24-bbbebba6779b","html_url":"https://github.com/RIOT-OS/check-labels-action","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RIOT-OS%2Fcheck-labels-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RIOT-OS%2Fcheck-labels-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RIOT-OS%2Fcheck-labels-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RIOT-OS%2Fcheck-labels-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RIOT-OS","download_url":"https://codeload.github.com/RIOT-OS/check-labels-action/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248602302,"owners_count":21131615,"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":["checker","github","github-actions","github-labels","labels"],"created_at":"2024-11-15T06:16:10.240Z","updated_at":"2025-04-12T17:06:39.425Z","avatar_url":"https://github.com/RIOT-OS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Check Labels Action\n===================\n\nThis action checks the labels of a Pull Request and will succeed or fail based\non the configuration.\n\nInputs\n------\n\n### `access_token`\nAn optional [personal access token], required for private repositories and to\ndecrease rate limiting.\n\n[personal access token]: https://github.com/settings/tokens\n\n### `set_labels`\nComma-separated list of labels required to be set. Optional. Globing syntax is\npossible for the label name, as defined in [fnmatch].\n\n### `unset_labels`\nComma-separated list of labels required not to be set. Optional. Globing syntax\nis possible for the label name, as defined in [fnmatch].\n\n### `cond_labels`\nComma-separated list of (label,condition) tuples for labels introducing a\ncondition. Optional. Globing syntax is possible for the label name, as defined\nin [fnmatch].\n\n### `missing_approvals_label`\nName of a label that this action will set/unset according to the state of\nrequired approvals. The label will be set if approvals are missing, and unset\nif there are sufficient approvals.\n\n#### Supported conditions\n- `review.approvals\u003ex`: If the label is set in the Pull Request it requires more\n  than `x` approving reviews for the action to succeed\n\n[fnmatch]: https://docs.python.org/3/library/fnmatch.html\n\n# Examples\n\nWe recommend the following workflow triggers:\n\n```yml\non:\n  pull_request:\n    types: [opened, reopened, labeled, unlabeled]\n  pull_request_review:\n    types: [submitted, dismissed]\n```\n\nThe action will fail if \"REQUIRE\" and \"MANDATORY\" are not set, if any label\nstarting with \"INVALID\" is set, or if \"NEEDS \u003e1 ACK\" is set, but the PR only has\none or no approval:\n\n```yml\nuses: RIOT-OS/check-labels-action@v1.0.0\nwith:\n    access_token: '${{ secrets.GITHUB_ACCESS_TOKEN }}'\n    set_labels: 'REQUIRE, MANDATORY'\n    unset_labels: 'INVALID*'\n    cond_labels: '(NEEDS \u003e1 ACK,review.approvals \u003e 1)'\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friot-os%2Fcheck-labels-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friot-os%2Fcheck-labels-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friot-os%2Fcheck-labels-action/lists"}