[Python-checkins] devguide: Add documentation about custom builders
python-checkins at python.org
Tue Sep 6 17:06:33 CEST 2011
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
@@ -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.
+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``
+ 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