Sage has two build bots.
Release Buildbot
The first builds entire tarballs (e.g. all the alphas) on a wide variety of machines, and can be found at http://build.sagemath.org/sage/ .
Patch Buildbot
The second pulls and applies patches from Trac and can be found at http://patchbot.sagemath.org/ or from links on the individual Trac tickets. This is still very much a work in progress, but the latest version of the code lives at https://code.google.com/p/sage-buildbot/ . Eventually this will get moved into Sage where it can be edited using the standard procedures and more widely deployed.
Usage
The Patch Buildbot will automatically select patches (from the ticket attachments) to apply. Every Trac ticket has a Patch Buildbot report page, which is accessed by the swirly, round icon at the top of the ticket description. The report page lists the patches the buildbot chose. To override this choice, use the following directive in a ticket comment:
- Apply foo.patch, foo2.patch
Any subsequently added patches will be (semi-intellegently) appended to the list. To tell Patch Buildbot about any ticket dependencies, populate the dependencies field with the ticket numbers and/or minimum Sage version.
Only the devel repository has branches, so the buildbot is unable to apply and try out patches to extcode/scripts/etc.
Patch Status
Patches can have the following status:
- New (grey)
ApplyFailed (red) The patch could not be applied. This can be caused by conflicts with other patches or dependencies.
BuildFailed (red)
TestsFailed (yellow) Some tests did not succeed. They can be found in the report of the bot.
PluginFailed (blue) Documentation and commit messages should be checked, see the bot report.
TestsPassed (green) Everything is ok, as far as the bot can tell.
- Pending (grey) The bot is currently running on this patch.
NoPatch (purple) No patch has been uploaded to trac so far. The bot has nothing to do.
- Spkg (purple) This is not related to a patch but to a spkg package. The bot is not concerned.
Hints and tricks
- Detecting which patches to apply are both performed by string searches on each line of the ticket, and are case insensitive.
- The patch list directive does not work in ticket descriptions.