Skip to content

A bot that automatically merges your pull requests based on configurable conditions.

License

Notifications You must be signed in to change notification settings

fgrutsch/emergence

Repository files navigation

eMERGEnce

Maven Github Actions CI Workflow Codecov License Docker Pulls Scala Steward badge

eMERGEnce is a bot that helps you to get rid of all your emerged pull requests automatically based on configurable conditions.

Note: This is a fork of the origin repository emergence which is not really maintained anymore. Due to leaving the organization I was not allowed to move the repository to my own github account and therefore I had to fork it.

Documentation

The full documentation can be found here.

Quickstart

To install eMERGEnce as an executable you can use coursier's install command. The only thing you have to do is to run:

coursier install --channel https://gist.githubusercontent.com/fgrutsch/f3ea5e1bdb5e43ccaac5b22f5e9514ae/raw/8f1bcda4ac883ff93de38c6512bbf95e07dba727/coursier_channel.json emergence

To get a list of available options run: emergence --help and you should get the following output:

Usage: emergence --config <path> --vcs-type <bitbucket-cloud> --vcs-api-host <uri> --vcs-login <string> --git-ask-pass <path> [--repo-config-name <string>]

eMERGEnce <version>

Options and flags:
    --help
        Display this help text.
    --version, -v
        Print the version number and exit.
    --config <path>
        The path to the eMERGEnce run config file.
    --vcs-type <bitbucket-cloud>
        The type of VCS you want to run eMERGEnce.
    --vcs-api-host <uri>
        The base URI for VCS api calls. e.g. https://api.bitbucket.org/2.0
    --vcs-login <string>
        The username for authenticating VCS API calls.
    --git-ask-pass <path>
        The path to the executable script file that returns your VCS secret for authenticating VCS API calls.
    --repo-config-name <string>
        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):

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 awesome scala-steward project. Go check it out!

Contributors

License

This code is licensed under the Apache 2.0 License.

About

A bot that automatically merges your pull requests based on configurable conditions.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages