This is a GitHub Action that uses git-fame to generate and update GitHub's CODEOWNERS file based on the git fame of individual files.
GitHub's CODEOWNERS feature doesn't provide any method for keeping the code owners list updated automatically. This action solves this by determining code owners based on the git fame of each file. Authors don't have to be asked for their addition based on subjective criteria anymore.
The distribution input defines the minimum percentage of code lines that are required for a contributor to being considered a code owner. Set it to any integer without the percent character to override the default.
By default, this action checks all files in the root, but groups recursive files into their parent directories.
Set this input to any non-zero value (e.g. true) to enable full coverage of all recursive files.
This defines the path to the CODEOWNERS file.
The default uses the path to the .github directory.
A GitHub token has to be set if inputs.username is enabled.
This is necessary because the GitHub API has a rate limit.
The default token has sufficient permissions for the API.
By default, this action uses the email addresses of users.
Set this input to any non-zero value (e.g. true) to derive the GitHub usernames and use them instead.
This is a typical example for a pull request workflow.
It should suffice to trigger it on few event types of pull request events only.
That also gives the author the possibility to remove themselves from the owners list optionally.
Make sure to use fetch-depth: 0 because otherwise, no git fame will be detected due to the lack of history.
name: codeowners
on:
pull_request_target:
paths-ignore:
- '**/CODEOWNERS'
- 'LICENSE'
branches:
- master
types:
- ready_for_review
- review_request_removed
- reopened
- labeled
jobs:
update:
runs-on: ubuntu-latest
# only apply on unmerged pull requests
if: github.event.pull_request.merged_by == ''
steps:
- name: checkout code
uses: actions/[email protected]
with:
# this only makes sure that forks are built as well
repository: ${{ github.event.pull_request.head.repo.full_name }}
ref: ${{ github.head_ref }}
# the fetch depth 0 (=all) is important
fetch-depth: 0
# the token is necessary for checks to rerun after auto commit
token: ${{ secrets.PAT }}
- name: update code owners
uses: gofunky/[email protected]
with:
distribution: 25
username: true
- uses: mszostok/[email protected]
id: validation
if: ${{ steps.committed.outputs.changes_detected == 'true' }}
with:
checks: files,owners,duppatterns
# the token is required only if the `owners` check is enabled
github_access_token: ${{ secrets.PAT }}
- name: commit changed files
id: committed
if: ${{ steps.committed.outputs.changes_detected == 'true' }}
uses: stefanzweifel/[email protected]
with:
commit_message: 'chore(meta): update code owners'
file_pattern: .github/CODEOWNERS
- uses: christianvuerings/[email protected]
if: ${{ steps.committed.outputs.changes_detected == 'true' }}
with:
labels: owned
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}