Differences between revisions 4 and 24 (spanning 20 versions)
Revision 4 as of 2010-12-08 14:21:37
Size: 1579
Editor: NilesJohnson
Comment: more details about ticket dependencies
Revision 24 as of 2014-08-21 07:36:04
Size: 3132
Editor: chapoton
Comment: remove old mercurial references
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
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/ . The first builds entire tarballs (e.g. all the development releases) on a wide variety of machines. It can be found at http://build.sagemath.org/sage/ .
Line 9: Line 9:
The second pulls and applies patches from trac and can be found at http://sage.math.washington.edu:21100/ticket/ 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 http://sage.math.washington.edu/home/robertwb/buildbot/bot/ . Eventually this will get moved into Sage where it can be edited using the standard procedures and more widely deployed. The second pulls and applies git branches 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; the latest version of the code lives at https://code.google.com/p/sage-buildbot/ (or at http://github.com/robertwb/sage-patchbot). Eventually this will get moved into Sage where it can be edited using the standard procedures and more widely deployed. See ticket http://trac.sagemath.org/sage_trac/ticket/12486.
Line 11: Line 11:
=== Usage === If you want to run a patchbot on your machine, see this [[buildbot/details|instruction page]].
Line 13: Line 13:
Patch Buildbot will try to determine which attachments for a given Trac ticket to apply. To tell Patch Buildbot explicitly which patches to apply, write something like the following in any comment: === Lists of reports ===
Line 15: Line 15:
    Apply foo.patch, foo2.patch You can see the status of several patches at the same time (replace xxxx by your user name) :
Line 17: Line 17:
This will "reset" the patch list at that point. Any subsequently added patches will
get (semi-intellegently) appended to the list. The list of attachments which will be applied on the next run are listed at the top of the buildbot report page for that ticket (the page you get by clicking on the swirly round icon at the top of the ticket description).
For the patches you participated in, see http://patchbot.sagemath.org/ticket/?participant=xxxx
Line 20: Line 19:
To tell Patch Buildbot about any ticket dependencies, write something like the following in any comment: For the patches you authored, see http://patchbot.sagemath.org/ticket/?author=xxxx
Line 22: Line 21:
    Depends on #1719 === Patch Status ===

The color of the report page icon indicates the status of the patch. See the report page itself for more details. The possible statuses are:

{{http://patchbot.sagemath.org/blob/New}} '''New'''

{{http://patchbot.sagemath.org/blob/Pending}}* '''Pending''' A patchbot is currently running on this patch.

{{http://patchbot.sagemath.org/blob/TestsPassed}} '''!TestsPassed''' Everything is okay, as far as a patchbot can tell.

{{http://patchbot.sagemath.org/blob/ApplyFailed}} '''!ApplyFailed''' The patch could not be applied. This can be caused by conflicts with other patches or dependencies.

{{http://patchbot.sagemath.org/blob/BuildFailed}} '''!BuildFailed''' The patch can be applied, but sage failed to build.

{{http://patchbot.sagemath.org/blob/TestsFailed}} '''!TestsFailed''' One or more tests did not succeed.

{{http://patchbot.sagemath.org/blob/PluginFailed}} '''!PluginFailed''' Documentation, commit messages and trailing whitespaces should be checked.

{{http://patchbot.sagemath.org/blob/PluginOnlyFailed}} '''!PluginOnlyFailed''' Documentation, commit messages and trailing whitespaces should be checked. Tests have not been made.

{{http://patchbot.sagemath.org/blob/PluginOnly}} '''!PluginOnly''' Only Documentation, commit messages and trailing whitespaces have been validated. Tests have not been made.

{{http://patchbot.sagemath.org/blob/NoPatch}} '''!NoPatch''' No patch has been uploaded to Trac so far. The patchbot has nothing to do.

{{http://patchbot.sagemath.org/blob/Spkg}} '''Spkg''' This is not related to a patch but to a spkg. The patchbot is not concerned.
Line 26: Line 49:
Detecting ticket dependencies and which patches to apply are both performed by string searches on each line of the ticket, and are case insensitive.  * You can help by running your own patchbot. See the installation instructions on the top right of any report page, for example http://patchbot.sagemath.org/ticket/7744/

 * To rerun tests (even though the branch was not modified) add the kick parameter, e.g., http://patchbot.sagemath.org/ticket/12345/?kick

Sage has two build bots.

Release Buildbot

The first builds entire tarballs (e.g. all the development releases) on a wide variety of machines. It can be found at http://build.sagemath.org/sage/ .

Patch Buildbot

The second pulls and applies git branches 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; the latest version of the code lives at https://code.google.com/p/sage-buildbot/ (or at http://github.com/robertwb/sage-patchbot). Eventually this will get moved into Sage where it can be edited using the standard procedures and more widely deployed. See ticket http://trac.sagemath.org/sage_trac/ticket/12486.

If you want to run a patchbot on your machine, see this instruction page.

Lists of reports

You can see the status of several patches at the same time (replace xxxx by your user name) :

For the patches you participated in, see http://patchbot.sagemath.org/ticket/?participant=xxxx

For the patches you authored, see http://patchbot.sagemath.org/ticket/?author=xxxx

Patch Status

The color of the report page icon indicates the status of the patch. See the report page itself for more details. The possible statuses are:

http://patchbot.sagemath.org/blob/New New

http://patchbot.sagemath.org/blob/Pending* Pending A patchbot is currently running on this patch.

http://patchbot.sagemath.org/blob/TestsPassed TestsPassed Everything is okay, as far as a patchbot can tell.

http://patchbot.sagemath.org/blob/ApplyFailed ApplyFailed The patch could not be applied. This can be caused by conflicts with other patches or dependencies.

http://patchbot.sagemath.org/blob/BuildFailed BuildFailed The patch can be applied, but sage failed to build.

http://patchbot.sagemath.org/blob/TestsFailed TestsFailed One or more tests did not succeed.

http://patchbot.sagemath.org/blob/PluginFailed PluginFailed Documentation, commit messages and trailing whitespaces should be checked.

http://patchbot.sagemath.org/blob/PluginOnlyFailed PluginOnlyFailed Documentation, commit messages and trailing whitespaces should be checked. Tests have not been made.

http://patchbot.sagemath.org/blob/PluginOnly PluginOnly Only Documentation, commit messages and trailing whitespaces have been validated. Tests have not been made.

http://patchbot.sagemath.org/blob/NoPatch NoPatch No patch has been uploaded to Trac so far. The patchbot has nothing to do.

http://patchbot.sagemath.org/blob/Spkg Spkg This is not related to a patch but to a spkg. The patchbot is not concerned.

Hints and tricks