Skip to content

Latest commit

 

History

History
112 lines (75 loc) · 3.7 KB

README.md

File metadata and controls

112 lines (75 loc) · 3.7 KB
Raw

Gitea Pull Request Backporter

This is a script that does various maintenance chores for go-gitea/gitea.

Behavior

Backport creation

First, the script will fetch Gitea's current development versions from GitHub's API.

The script will look for pull requests that have the label backport/v{gitea_version} but do not have the label backport/done. It will clone your fork of gitea. It will then attempt to cherry-pick the pull request merged commit into the release branch. If the cherry-pick is successful, it will push the branch to the remote and create a pull request with the labels from the original pull request.

Label maintenance

The script will also look for merged pull requests that have the labels reviewed/wait-merge or reviewed/prioritize-merge and remove them.

It will also search for pull requests that target release branches and remove any backport/* labels from them.

It will also make sure any pull requests that have ## :warning: BREAKING in their description have the pr/breaking label.

Merge queue synchronization

The script will also look for pull requests that have the label reviewed/wait-merge and are still open. It will merge the upstream changes into the pull request head branch. If a merge conflict occurs, it will remove the pull request from the merge queue.

Milestone maintenance

When a pull request is created, the script will assign it a milestone based on its target branch (except pull requests targeting main, we'll assign those on merge). The script makes sure that unmerged closed pull requests are not included in any milestone.

LGTM

The script will maintain each pull request's LGTM count. It will add the appropriate label (one of lgtm/need 2, lgtm/need 1, lgtm/done, or lgtm/blocked) based on the number of approvals (or change requests) the pull request has. It will also set the commit status to success if the pull request has 2 or more approvals without changes requested (pending if not or failure if changes are requested).

Comments

The script will also comment if a pull request is opened with non-English translation files changed, directing the user to the crowdin project.

Locks

The script will also lock issues and pull requests that have been closed for 3 months. If the issue was commented on in the last two weeks, a comment will be posted suggesting opening a new issue to continue the discussion.

Feedback

The script will close issues with the label issue/needs-feedback if a month has passed since they were updated.

Maintainer commands

The script can execute some actions like updating a PR's branch if requested by a maintainer through a giteabot/* label.

Last call

The script will close PRs with the label pr/last-call if two weeks have passed since they were updated. If one week has passed since they were updated, it will remind the TOC to review the PR.

Usage

Set the following environment variables:

BACKPORTER_GITHUB_TOKEN= # A GitHub personal access token with permissions to add labels to the go-gitea/gitea repo
BACKPORTER_GITHUB_SECRET= # The secret that is used to sign the webhook payload (set in GitHub's webhook settings)
BACKPORTER_GITEA_FORK= # The fork of go-gitea/gitea to push the backport branch to (e.g. yardenshoham/gitea)

Then run:

deno run --allow-net --allow-env --allow-run --allow-sys src/webhook.ts

This will spin up a web server on port 8000. You can then set up a GitHub webhook on /trigger to run this bot.

Development

  • make fmt runs the formatter
  • make lint runs the linter and checks formatting and types
  • make test runs the tests

Contributing

Contributions are welcome!

License

MIT