[Python-checkins] devguide: Add documentation about custom builders

antoine.pitrou python-checkins at python.org
Tue Sep 6 17:06:33 CEST 2011

changeset:   449:92424edd4270
user:        Antoine Pitrou <solipsis at pitrou.net>
date:        Tue Sep 06 17:03:51 2011 +0200
  Add documentation about custom builders

  buildbots.rst |  31 +++++++++++++++++++++++++++++++
  1 files changed, 31 insertions(+), 0 deletions(-)

diff --git a/buildbots.rst b/buildbots.rst
--- a/buildbots.rst
+++ b/buildbots.rst
@@ -175,3 +175,34 @@
 better if it can be diagnosed and suppressed by fixing the test's implementation,
 or by making its parameters - such as a timeout - more robust.
+Custom builders
+When working on a long-lived feature branch, or on a bugfix branch which
+enables issue-specific debugging, you will probably want to test your
+work on one or several buildbots.  Since your work is hosted in a distinct
+repository, you can't trigger builds on the regular builders.  Instead,
+you have to use one of the `custom builders
+When creating ("forcing") a build on a custom builder, you have to provide
+at least two parameters:
+* The repository path, relative to http://hg.python.org. For example,
+  ``sandbox/myfixes`` if ``http://hg.python.org/sandbox/myfixes`` is the
+  full path to the repository.
+* The Mercurial id of the changeset you want to build.  To make things less
+  tedious, we suggest you do your changes in a separate named branch: you can
+  then supply the branch name instead of a specific changeset id.
+If you are interested in the results of a specific test file only, we
+recommend you change (temporarily, of course) the contents of the
+``buildbottest`` clause in ``Makefile.pre.in``; or, for Windows builders,
+the ``Tools/buildbot/test.bat`` and ``Tools/buildbot/test-amd64.bat``
+.. note::
+   For security reasons, it is impossible to build repositories from outside
+   the http://hg.python.org realm.

Repository URL: http://hg.python.org/devguide

More information about the Python-checkins mailing list