bleeding-edge-bot/README.md
2016-11-25 14:00:54 +01:00

35 lines
1.3 KiB
Markdown

# lemonbot
Bot used for merging Citra bleeding-edge builds.
At the moment, it uses the GitHub API to find builds to merge.
## Use in Citra bleeding-edge build process
The actual bot is ran on a server administrated by Flame Sage.
It is ran on a daily cron-job and updates from this repo before trying to merge builds.
Pull requests to fix issues with the bot are more than welcome.
## What does it do?
After doing the self-update, the bot will visit each of the listed `PULL_REPOS`.
It will look for PRs on GitHub labelled with `LABEL_TO_FETCH` and merge those onto the `MAIN_REPO`/master branch.
If a PR fails to merge it will be ignored.
Once everything has been merged the bot will push the resulting files to the `PUSH_REPO`/`self.branch_name` branch.
The path `self.tracking_path` is used as a working directory for the git merge operations.
The status will be logged via the `logger` object.
The default configuration is to log to *debug.log*, *error.log* and stdout.
## Installation
Clone this repo and configure lemonbot by modifying the configuration in *tag_build.py*.
You can then run the script.
Note that the script depends on being part of a git repo.
The script uses `git pull origin master` to update itself.
## License
lemonbot is licensed under the GPLv3 (or any later version). Refer to the license.txt file included.