bleeding-edge-bot/README.md
James Rowe 05ddf3be75 Merge pull request #11 from JayFoxRox/sync-master
Sync master branch on PUSH_REPO
2016-11-25 12:33:56 -07:00

36 lines
1.4 KiB
Markdown

# lemonbot
Bot used for merging Citra bleeding-edge builds.
At the moment, it uses the GitHub API to find builds to merge.
Pull requests to fix issues with the bot are more than welcome.
## 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.
## What does it do?
After doing the self-update, the bot will clone the latest `MAIN_REPO` and resync `PUSH_REPO`/master.
After that, each of the `PULL_REPOS` is visited.
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.