{"id":20517957,"url":"https://github.com/vansante/github-pr-labeler","last_synced_at":"2025-04-14T00:55:09.080Z","repository":{"id":51343079,"uuid":"197361318","full_name":"vansante/github-pr-labeler","owner":"vansante","description":"🤖 Probot app that listens to new/changes to Pull Requests and issues labels to them based on a config file in the repository.","archived":false,"fork":false,"pushed_at":"2021-05-14T08:21:14.000Z","size":30,"stargazers_count":10,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-27T15:01:40.386Z","etag":null,"topics":["github-app","labeling","labeling-tool","probot","probot-app","pull-request"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/vansante.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}},"created_at":"2019-07-17T09:45:39.000Z","updated_at":"2024-02-07T15:44:19.000Z","dependencies_parsed_at":"2022-09-08T12:00:41.971Z","dependency_job_id":null,"html_url":"https://github.com/vansante/github-pr-labeler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vansante%2Fgithub-pr-labeler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vansante%2Fgithub-pr-labeler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vansante%2Fgithub-pr-labeler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vansante%2Fgithub-pr-labeler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vansante","download_url":"https://codeload.github.com/vansante/github-pr-labeler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804783,"owners_count":21164131,"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":["github-app","labeling","labeling-tool","probot","probot-app","pull-request"],"created_at":"2024-11-15T21:37:58.903Z","updated_at":"2025-04-14T00:55:09.034Z","avatar_url":"https://github.com/vansante.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PR-Labeler\n\n\u003e A GitHub App built with [Probot](https://github.com/probot/probot) that labels pull requests automatically\n\n## Configuration\n\nSee [config-sample](pr-labeler.sample.yml) for an example of a configuration yaml file that can be placed\nin your repository in the path `.github/pr-labeler.yml`.\n\n### Simple on/off labels\n\nThere are a number of possible on/off flags that when triggered allow setting a single label.\n\nThese are:\n- `has-milestone-label`: The label under the value will be applied when there is a milestone attached\n    to this PR.\n- `has-comments-label`: The label under the value will be applied when there are comments on this PR.\n- `has-review-comments-label`: The label under the value will be applied when there are review comments\n    on this PR.\n- `is-mergeable-label`: The label under the value will be applied when there are no checks stopping this\n    PR from being merged.\n- `is-draft-label`: The label under the value will be applied when the PR is a draft.\n\n### Labels to apply for certain paths\n\nUnder the `path-labels` key you can store labels that should be applied when certain paths are touched in a PR.\nThe path values allow wildcards and partial paths.\n\nFor example:\n```yaml\npath-labels:\n  frontend: [\"*.js\", \"*.css\", \"*.html\"]\n  backend: [\"/app/*\"]\n```\nThis config will apply the frontend label when `.js`, `.css` or `.html` files are added/changed/removed,\nand will apply the backend label when the same happens to any file in `/app`.\n\n### Labels to apply for branches targeted\n\nThe `target-branch-labels` key allows you to apply a label for a target branch.\n\nFor example:\n```yaml\ntarget-branch-labels:\n  experimental: [\"experiments\"]\n```\nThis config will apply the experiments label when a PR targets the experimental branch. Multiple branches\nare possible for one branch.\n\n### Labels to apply for words in PR title\n\nThe `title-keyword-labels` allows you to apply a label when a certain word is found in the PR title.\n\nFor example:\n```yaml\ntitle-keyword-labels:\n  in-progress: [\"WiP\"]\n```\nThis config applies the in-progress label whenever it encounters `WiP` anywhere in the PR title.\n\n### Labels to apply for words in PR description\n\nThe `description-keyword-labels` allows you to the same, but then for the PR description.\n\n### Labels to apply for line change counts\n\nThe `line-changes-labels` key allows you to give an array of possible conditions for the amount, which\nif all apply, apply the label.\n\nPossible conditions are:\n- `greater-than`: The count must be greater than the given number.\n- `greater-than-equal`: The count must be greater than or equal to the given number.\n- `less-than`: The count must be smaller than the given number.\n- `less-than-equal`: The count must be smaller than or equal to the given number.\n\nFor example:\n```yaml\nline-changes-labels:\n  - greater-than: 300\n    less-than-equal: 1000\n    label: medium\n  - greater-than: 1000\n    label: large\n```\n\nThe label `medium` will be applied if the amount of line changes in the PR is in the range of 301 to 1000.\nThe label `large` will be applied if the amount of line changes in the PR is 1001 to infinity.\n\n### Labels to apply for line addition counts\n\nThe `line-addition-labels` will do the same thing as line changes, but instead only look at the\nlines added.\n\n### Labels to apply for line deletion counts\n\nThe `line-deletion-labels` will do the same thing as line changes, but instead only look at the\nlines deleted.\n\n### Labels to apply for commit counts\n\nThe `commit-count-labels` will do the same thing as line changes, but instead it looks at the amount\nof commits that are in the PR.\n\n### Labels to apply for authors\n\nThe `author-labels` allows you to apply a label when certain developers open a PR.\n\nFor example:\n```yaml\nauthor-labels:\n  master-of-code: [\"coder1\"]\n```\nThe master-of-code label is applied when coder1 opens a PR.\n\n### Settings\n\nSome settings are configurable under the `settings` key:\n\n- `process-closed-prs`: Boolean. Should the robot do anything with PRs that are closed? Default false.\n- `process-merged-prs`: Boolean. Should the robot do anything with PRs that are merged? Default false.\n- `remove-labels`: Boolean. Should the robot also remove labels when their triggers are no longer true? Default false.\n- `remove-keyword-labels`: Boolean. Should the robot also remove labels triggered by magic keywords when they are no longer found? Default false.\n\n## Setup\n\n```sh\n# Install dependencies\nnpm install\n\n# Run the bot\nnpm start\n```\n\n## Contributing\n\nIf you have suggestions for how PR-Labeler could be improved, or want to report a bug, open an issue! We'd love all and any contributions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvansante%2Fgithub-pr-labeler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvansante%2Fgithub-pr-labeler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvansante%2Fgithub-pr-labeler/lists"}