{"id":15023195,"url":"https://github.com/open-telemetry/assign-reviewers-action","last_synced_at":"2025-10-19T17:31:30.430Z","repository":{"id":43179555,"uuid":"395367466","full_name":"open-telemetry/assign-reviewers-action","owner":"open-telemetry","description":"GitHub action to assign reviewers/approvers/etc based on configuration","archived":false,"fork":false,"pushed_at":"2023-11-14T20:08:33.000Z","size":431,"stargazers_count":7,"open_issues_count":0,"forks_count":6,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-01-29T13:02:10.594Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-telemetry.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":"2021-08-12T15:40:02.000Z","updated_at":"2023-06-14T22:34:48.000Z","dependencies_parsed_at":"2024-09-18T09:12:51.713Z","dependency_job_id":"bca15b40-8676-48de-b5d1-cdcf406a36b3","html_url":"https://github.com/open-telemetry/assign-reviewers-action","commit_stats":{"total_commits":5,"total_committers":3,"mean_commits":"1.6666666666666667","dds":0.4,"last_synced_commit":"11896323b27a99ee581cb4ad8414e23ff7e3c9fb"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fassign-reviewers-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fassign-reviewers-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fassign-reviewers-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fassign-reviewers-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-telemetry","download_url":"https://codeload.github.com/open-telemetry/assign-reviewers-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237181541,"owners_count":19268054,"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-09-24T19:58:49.451Z","updated_at":"2025-10-19T17:31:30.423Z","avatar_url":"https://github.com/open-telemetry.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Assign Reviewers Action\n\nAutomatically add configured github users as assignees and approvers to pull requests.\n\nThis works very similarly to CODEOWNERS, however with CODEOWNERS all owners must have write access to the repository.\nMany open source projects wish to assign some level of ownership of individual components, but are hesitant to grant write access to those owners.\nThis action only requires that assignees and reviewers be collaborators on the repository or members of the organization, but does NOT require they have write access.\n\n## Getting Started\n\nFirst, create a configuration file.\nBy default, the action will look in `.github/assign_reviewers.yml`.\n\n```yaml\n# .github/assign_reviewers.yml\n\n# Each component identified by its path prefix has a list of users\ncomponents:\n  # User assignment applies recursively to any file in a directory\n  src/:\n    - user1 # user1 owns all files in src/\n\n  # User assignment can be configured as a space-separated string\n  src/index.ts: user2 user3\n  \n  # or a list\n  src/list-users.ts:\n    - user3\n    - user4\n\n  # User assignment can be configured based on a file extension\n  \"*.md\":\n    - user5\n\n# Optionally ignore some PR authors to reduce spam for assignees and reviewers\nignored-authors:\n  - dependabot\n  - renovate-bot\n```\n\nNext, create your github action yml.\n\n```yaml\nname: 'Assign Reviewers'\non:\n  # pull_request_target is suggested for projects where pull requests will be\n  # made from forked repositories. If pull_request is used in these cases,\n  # the github token will not have sufficient permission to update the PR.\n  pull_request_target:\n\njobs:\n  assign:\n    runs-on: ubuntu-latest\n    name: Assign Reviewers\n    steps:\n      - uses: open-telemetry/assign-reviewers-action@main\n        with:\n          # default: .github/assign_reviewers.yml\n          config-file: .github/assign_reviewers.yml\n          # default: ${{ github.token }}\n          repo-token: ${{ github.token }} \n          # default: true\n          assign-users: \"true\"\n          # default: true\n          request-user-reviews: \"true\"\n```\n\n## Configuration\n\n### `config-file`\n\n**default**: `.github/assign_reviewers.yml`\n\nPath to configuration file.\n\n### `repo-token`\n\n**default**: `${{ github.token }}`\n\nGitHub personal access token.\nMust have permission to read and write pull requests.\nThe default `github.token` is typically sufficient.\n\n### `assign-users`\n\n**default**: `true`\n\nDetermines if the configured users for a component should be added to the pull request as assignees.\n\n### `request-user-reviews`\n\n**default**: `true`\n\nDetermines if pull request reviews should be requested from configured users for a component.\n\n## Why not use CODEOWNERS?\n\nIf all of your contributors have write access to your repo, CODEOWNERS is a great solution.\nIf, like many open source projects, you would like to assign some level of ownership of a single component of your repository, but you don't want to grant those users write access to the repo, this action can help.\n\n## Maintainers\n\n- [Daniel Dyla](https://github.com/dyladan), Dynatrace\n- [Trask Stalnaker](https://github.com/trask), Microsoft\n\nFor more information about the maintainer role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fassign-reviewers-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-telemetry%2Fassign-reviewers-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fassign-reviewers-action/lists"}