Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nikku/merge-me
A GitHub app that merges your pull requests once all required checks pass.
https://github.com/nikku/merge-me
bot github github-app probot probot-app
Last synced: about 2 months ago
JSON representation
A GitHub app that merges your pull requests once all required checks pass.
- Host: GitHub
- URL: https://github.com/nikku/merge-me
- Owner: nikku
- License: mit
- Created: 2018-09-28T21:50:36.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-22T16:34:41.000Z (8 months ago)
- Last Synced: 2024-07-27T07:33:28.453Z (about 2 months ago)
- Topics: bot, github, github-app, probot, probot-app
- Language: JavaScript
- Homepage: https://github.com/apps/merge-me
- Size: 1.04 MB
- Stars: 22
- Watchers: 5
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# merge-me
[](https://github.com/nikku/merge-me/actions/workflows/CI.yml)
[](https://codecov.io/gh/nikku/merge-me)
A GitHub app, built with [Probot](https://probot.github.io), that merges your pull requests once all required checks pass.
## Installation
[Install the app](https://github.com/apps/merge-me) from the GitHub apps directory.
Alternatively, [run it yourself](#setup-and-run) or [integrate it with an existing Probot](#integrate-with-an-existing-probot).
## Features
* Requires zero configuration
* Enforces [branch protection rules](https://help.github.com/articles/about-protected-branches/), if configured
* Applies [sensible defaults](#merge-rules) in the absence of branch protection
* Accounts for [review teams](#reviewteams), if configured
* Merges using the _rebase_ (default) or _merge_ method
## Merge Rules
Without [branch protection](https://help.github.com/articles/about-protected-branches/), the app ensures a pull request meets the following conditions before merging:
* Pull request is not a draft
* At least one status check exists
* All status checks are `completed`
* All status checks have the outcome `successful` or `neutral`
* At least one review approval exists
* No review requests changes
Rules and merge method may be tuned with [additional configuration](#configuration).
## Configuration
You configure the merge behavior by placing a `.github/merge-me.yml` file into your repository.
#### `minApprovals=1`
This property specifies the number of approvals required to merge a PR. Defaults to `1`, will always be at least `1` for external contributions.
##### Example
```yml
minApprovals: 2
```
#### `mergeMethod=rebase`
This property specifies whether to use `rebase` (default) or `merge` as the merge method.
##### Example
```yml
mergeMethod: 'merge'
```
#### `reviewTeams`
This property lists teams to account for when checking for approvals. Taking teams into account during the merge check requires the `members` app permission and is enabled for organizational repositories only.
If `reviewTeams` is specified, the app checks for approvals for each team involved in the PR. It deduces the effective teams to account for via the team memberships of existing and requested reviewers. The app merges a PR only if all effective review teams have the configured amount of `minApprovals`.
##### Example
```yml
reviewTeams:
- design
- development
```
## Related
This app works nicely with others:
* [WIP](https://github.com/apps/wip) - prevents merging of branches that you tag as _work in progress_
* [delete-merged-branch](https://github.com/apps/delete-merged-branch) - deletes the feature branch once merged
Combine these apps as needed for an excellent merge flow.
## Setup and Run
```sh
# install dependencies
npm install
# run the app
LOG_LEVEL=debug npm start
# test the app
LOG_LEVEL=debug npm test
```
## Integrate with an Existing Probot
You can [combine this app with others](https://probot.github.io/docs/deployment/#combining-apps).
```json
{
"name": "my-probot-app",
"private": true,
"dependencies": {
"@nikku/merge-me": "^0.11.0",
"probot-settings": "probot/settings"
},
"scripts": {
"start": "probot run"
},
"probot": {
"apps": ["@nikku/merge-me", "probot-settings"]
}
}
```
## Alternatives
Consider [probot-auto-merge](https://github.com/bobvanderlinden/probot-auto-merge) if you need an app with more configuration options. It includes many of the features provided by [related apps](#related), too.
## License
[MIT](LICENSE)