https://github.com/firstbirdtech/emergence
A bot that automatically merges your pull requests based on configurable conditions.
https://github.com/firstbirdtech/emergence
bitbucket-cloud bot git merge scala
Last synced: 6 months ago
JSON representation
A bot that automatically merges your pull requests based on configurable conditions.
- Host: GitHub
- URL: https://github.com/firstbirdtech/emergence
- Owner: firstbirdtech
- License: apache-2.0
- Created: 2020-11-28T15:07:10.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-12-17T00:37:21.000Z (7 months ago)
- Last Synced: 2025-12-20T14:39:38.121Z (6 months ago)
- Topics: bitbucket-cloud, bot, git, merge, scala
- Language: Scala
- Homepage: https://firstbirdtech.github.io/emergence/
- Size: 723 KB
- Stars: 1
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
*This project is no longer maintained in this repository, please check [this fork](https://github.com/fgrutsch/emergence) for future maintenance and development instead.*
# eMERGEnce
[](https://search.maven.org/search?q=g:%22com.firstbird.emergence%22%20AND%20a:%22core_2.13%22)
[](https://github.com/firstbirdtech/emergence/workflows/CI/badge.svg)
[](https://codecov.io/gh/firstbirdtech/emergence)
[](https://img.shields.io/docker/pulls/firstbird/emergence.svg)
[](https://opensource.org/licenses/Apache-2.0)
eMERGEnce is a bot that helps you to get rid of all your emerged pull requests automatically based on configurable conditions.
## Documentation
The full documentation can be found [here](https://emergence.fgrutsch.com).
## Quickstart
To install eMERGEnce as an executable you can use coursier's [install](https://get-coursier.io/docs/cli-install) command. The only thing you have to do is to run:
`coursier install --channel http://coursier.fgrutsch.com emergence`
To get a list of available options run: `emergence --help` and you should get the following output:
```
Usage: emergence --config --vcs-type --vcs-api-host --vcs-login --git-ask-pass [--repo-config-name ]
eMERGEnce
Options and flags:
--help
Display this help text.
--version, -v
Print the version number and exit.
--config
The path to the eMERGEnce run config file.
--vcs-type
The type of VCS you want to run eMERGEnce.
--vcs-api-host
The base URI for VCS api calls. e.g. https://api.bitbucket.org/2.0
--vcs-login
The username for authenticating VCS API calls.
--git-ask-pass
The path to the executable script file that returns your VCS secret for authenticating VCS API calls.
--repo-config-name
The name/path of the eMERGEnce config file inside the repository. Default: .emergence.yml
```
An example command might look like this (depending on the selected VCS type):
```bash
emergence \
--config "/opt/emergence/run-config.yml" \
--vcs-type "bitbucket-cloud" \
--vcs-api-host "https://api.bitbucket.org/2.0" \
--vcs-login ${BITBUCKET_USERNAME} \
--git-ask-pass "/opt/emergence/git-ask-pass.sh"
```
For full documentation and how to run it via docker please check the link above.
## Credits
The code of this project is heavily inspired and based on [fthomas's](https://github.com/fthomas) awesome [scala-steward](https://github.com/scala-steward-org/scala-steward) project. Go check it out!
## Contributors
* [Fabian Grutsch](https://github.com/fgrutsch)
## License
This code is licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0.txt).