bleeding-edge-bot/README.md

35 lines
1.3 KiB
Markdown
Raw Normal View History

2016-09-11 17:19:18 -04:00
# lemonbot
2016-10-06 21:42:16 -04:00
Bot used for merging Citra bleeding-edge builds.
At the moment, it uses the GitHub API to find builds to merge.
2016-10-06 21:42:16 -04:00
## Use in Citra bleeding-edge build process
2016-10-06 21:42:16 -04:00
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.
2016-10-06 21:42:16 -04:00
Pull requests to fix issues with the bot are more than welcome.
2016-10-06 21:42:16 -04:00
## What does it do?
2016-10-06 21:42:16 -04:00
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.
2016-10-06 21:42:16 -04:00
The path `self.tracking_path` is used as a working directory for the git merge operations.
2016-10-06 21:42:16 -04:00
The status will be logged via the `logger` object.
The default configuration is to log to *debug.log*, *error.log* and stdout.
2016-10-06 21:42:16 -04:00
## Installation
2016-10-06 21:42:16 -04:00
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.
2016-10-06 21:42:16 -04:00
## License
2016-10-06 21:42:16 -04:00
lemonbot is licensed under the GPLv3 (or any later version). Refer to the license.txt file included.