{"id":13529944,"url":"https://github.com/crazy-max/ghaction-github-labeler","last_synced_at":"2025-05-16T05:06:53.478Z","repository":{"id":35826410,"uuid":"216050313","full_name":"crazy-max/ghaction-github-labeler","owner":"crazy-max","description":"GitHub Action to manage labels on GitHub","archived":false,"fork":false,"pushed_at":"2025-05-07T22:35:04.000Z","size":15205,"stargazers_count":150,"open_issues_count":8,"forks_count":17,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-08T11:02:00.419Z","etag":null,"topics":["actions","github-actions","github-labels"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/github-labeler","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/crazy-max.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"crazy-max","custom":"https://www.paypal.me/crazyws"}},"created_at":"2019-10-18T15:07:04.000Z","updated_at":"2025-04-18T15:56:41.000Z","dependencies_parsed_at":"2024-09-05T04:41:38.890Z","dependency_job_id":"20a21880-b736-4492-a76d-1786264307c3","html_url":"https://github.com/crazy-max/ghaction-github-labeler","commit_stats":{"total_commits":325,"total_committers":11,"mean_commits":"29.545454545454547","dds":"0.43999999999999995","last_synced_commit":"8e431bff082f1ca0b0afbf12d9e972168ec11286"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-github-labeler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-github-labeler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-github-labeler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-github-labeler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crazy-max","download_url":"https://codeload.github.com/crazy-max/ghaction-github-labeler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254453646,"owners_count":22073616,"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":["actions","github-actions","github-labels"],"created_at":"2024-08-01T07:00:41.131Z","updated_at":"2025-05-16T05:06:48.470Z","avatar_url":"https://github.com/crazy-max.png","language":"TypeScript","readme":"[![GitHub release](https://img.shields.io/github/release/crazy-max/ghaction-github-labeler.svg?style=flat-square)](https://github.com/crazy-max/ghaction-github-labeler/releases/latest)\n[![GitHub marketplace](https://img.shields.io/badge/marketplace-github--labeler-blue?logo=github\u0026style=flat-square)](https://github.com/marketplace/actions/github-labeler)\n[![Test workflow](https://img.shields.io/github/actions/workflow/status/crazy-max/ghaction-github-labeler/test.yml?branch=master\u0026label=test\u0026logo=github\u0026style=flat-square)](https://github.com/crazy-max/ghaction-github-labeler/actions?workflow=test)\n[![Codecov](https://img.shields.io/codecov/c/github/crazy-max/ghaction-github-labeler?logo=codecov\u0026style=flat-square)](https://codecov.io/gh/crazy-max/ghaction-github-labeler)\n[![Become a sponsor](https://img.shields.io/badge/sponsor-crazy--max-181717.svg?logo=github\u0026style=flat-square)](https://github.com/sponsors/crazy-max)\n[![Paypal Donate](https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal\u0026style=flat-square)](https://www.paypal.me/crazyws)\n\n## About\n\nGitHub Action to manage labels on GitHub (create/rename/update/delete) as code.\n\n![GitHub Labeler](.github/ghaction-github-labeler.png)\n\n___\n\n* [Usage](#usage)\n  * [YAML configuration](#yaml-configuration)\n  * [Workflow](#workflow)\n* [Customizing](#customizing)\n  * [inputs](#inputs)\n* [Contributing](#contributing)\n* [License](#license)\n\n## Usage\n\n### YAML configuration\n\nIn the repository where you want to perform this action, create the YAML file\n`.github/labels.yml` (you can also set a [custom filename](#customizing)) that\nlooks like:\n\n```yaml\n- name: \"bug\"\n  color: \"#d73a4a\"\n  description: \"Something isn't working\"\n- name: \"documentation\"\n  color: \"#0075ca\"\n  description: \"Improvements or additions to documentation\"\n- name: \"duplicate\"\n  color: \"#cfd8d7\"\n  description: \"This issue or pull request already exists\"\n- name: \"enhancement\"\n  color: \"#a22eef\"\n- name: \"wontfix_it\"\n  color: \"#000000\"\n  description: \"This will not be worked on\"\n  from_name: \"wontfix\"\n```\n\n* `name`, `color` and `description` are the main [GitHub label fields](https://developer.github.com/v3/issues/labels/#parameters)\n* `description` can be omit if your want to keep the current one\n* `from_name` allow to rename a label from one currently available on your repository\n\n### Workflow\n\n```yaml\nname: github\n\non:\n  push:\n    branches:\n      - 'main'\n    paths:\n      - '.github/labels.yml'\n      - '.github/workflows/labels.yml'\n  pull_request:\n    paths:\n      - '.github/labels.yml'\n      - '.github/workflows/labels.yml'\n\njobs:\n  labeler:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      issues: write\n    steps:\n      -\n        name: Checkout\n        uses: actions/checkout@v4\n      -\n        name: Run Labeler\n        uses: crazy-max/ghaction-github-labeler@v5\n        with:\n          github-token: ${{ secrets.GITHUB_TOKEN }}\n          yaml-file: .github/labels.yml\n          dry-run: ${{ github.event_name == 'pull_request' }}\n          exclude: |\n            help*\n            *issue\n```\n\nWith this workflow, the YAML configuration above on a [fresh repository](samples/original.yml),\nthis will:\n\n* Skip `bug` (because same `color` and `description`)\n* Skip `documentation` (because same `color` and `description`)\n* Update `duplicate` (`color` is different)\n* Update `enhancement` (`color` is different, keep current `description`)\n* Leave `good first issue` alone (because it matches an `exclude` pattern)\n* Leave `help wanted` alone (because it matches an `exclude` pattern)\n* Delete `invalid`\n* Delete `question`\n* Rename `wontfix` to `wontfix_it` and set `color` and `description`\n\n## Customizing\n\n### inputs\n\nFollowing inputs can be used as `step.with` keys\n\n| Name           | Type   | Description                                                                         |\n|----------------|--------|-------------------------------------------------------------------------------------|\n| `yaml-file`    | String | Path to YAML file containing labels definitions. (default `.github/labels.yml`)     |\n| `skip-delete`  | Bool   | If enabled, labels will not be deleted if not found in YAML file. (default `false`) |\n| `dry-run`      | Bool   | If enabled, changes will not be applied. (default `false`)                          |\n| `exclude`      | List   | Newline delimited list of labels pattern(s)/matcher to exclude                      |\n\n## Contributing\n\nWant to contribute? Awesome! The most basic way to show your support is to star\nthe project, or to raise issues. You can also support this project by [**becoming a sponsor on GitHub**](https://github.com/sponsors/crazy-max)\nor by making a [PayPal donation](https://www.paypal.me/crazyws) to ensure this\njourney continues indefinitely!\n\nThanks again for your support, it is much appreciated! :pray:\n\n## License\n\nMIT. See `LICENSE` for more details.\n","funding_links":["https://github.com/sponsors/crazy-max","https://www.paypal.me/crazyws"],"categories":["Community Resources","TypeScript"],"sub_categories":["GitHub Tools and Management"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazy-max%2Fghaction-github-labeler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrazy-max%2Fghaction-github-labeler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazy-max%2Fghaction-github-labeler/lists"}