[Buildbot-commits] buildbot/docs buildbot.texinfo,1.109,1.110
Brian Warner
warner at users.sourceforge.net
Wed Aug 1 20:31:29 UTC 2007
- Previous message (by thread): [Buildbot-commits] buildbot/buildbot/test test_changes.py, 1.11, 1.12 test_config.py, 1.45, 1.46 test_control.py, 1.16, 1.17 test_dependencies.py, 1.7, 1.8 test_locks.py, 1.9, 1.10 test_properties.py, 1.9, 1.10 test_run.py, 1.45, 1.46 test_slaves.py, 1.10, 1.11 test_status.py, 1.42, 1.43 test_steps.py, 1.41, 1.42 test_vc.py, 1.75, 1.76 test_web.py, 1.45, 1.46
- Next message (by thread): [Buildbot-commits] buildbot ChangeLog,1.882,1.883
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Update of /cvsroot/buildbot/buildbot/docs
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv23570/docs
Modified Files:
buildbot.texinfo
Log Message:
[project @ replace c['sources'] with c['change_source']]
Original author: warner at lothar.com
Date: 2007-07-28 20:03:12+00:00
Index: buildbot.texinfo
===================================================================
RCS file: /cvsroot/buildbot/buildbot/docs/buildbot.texinfo,v
retrieving revision 1.109
retrieving revision 1.110
diff -u -d -r1.109 -r1.110
--- buildbot.texinfo 28 Jul 2007 16:48:34 -0000 1.109
+++ buildbot.texinfo 1 Aug 2007 20:31:27 -0000 1.110
@@ -1999,18 +1999,27 @@
@section Listing Change Sources and Schedulers
@bcindex c['sources']
-The @code{c['sources']} key is a list of ChangeSource
-instances at footnote{To be precise, it is a list of objects which all
-implement the @code{buildbot.interfaces.IChangeSource} Interface}.
-This defines how the buildmaster learns about source code changes.
-More information about what goes here is available in @xref{Getting
-Source Code Changes}.
+ at bcindex c['change_source']
+
+The @code{c['change_source']} key is the ChangeSource
+instance at footnote{To be precise, it is an object or a list of objects
+which all implement the @code{buildbot.interfaces.IChangeSource}
+Interface. It is unusual to have multiple ChangeSources, so this key
+accepts either a single ChangeSource or a sequence of them.} that
+defines how the buildmaster learns about source code changes. More
+information about what goes here is available in @xref{Getting Source
+Code Changes}.
@example
-import buildbot.changes.pb
-c['sources'] = [buildbot.changes.pb.PBChangeSource()]
+from buildbot.changes.pb import PBChangeSource
+c['change_source'] = PBChangeSource()
@end example
+(note: in buildbot-0.7.5 and earlier, this key was named
+ at code{c['sources']}, and required a list. @code{c['sources']} is
+deprecated as of buildbot-0.7.6 and is scheduled to be removed in a
+future release).
+
@bcindex c['schedulers']
@code{c['schedulers']} is a list of Scheduler instances, each of which
causes builds to be started on a particular set of Builders. The two
@@ -2601,16 +2610,21 @@
@section Choosing ChangeSources
The @code{master.cfg} configuration file has a dictionary key named
- at code{BuildmasterConfig['sources']}, which holds a list of
- at code{IChangeSource} objects. The config file will typically create an
-object from one of the classes described below and stuff it into the
-list.
+ at code{BuildmasterConfig['change_source']}, which holds the active
+ at code{IChangeSource} object. The config file will typically create an
+object from one of the classes described below and stuff it into this
+key.
+
+Each buildmaster typically has just a single ChangeSource, since it is
+only watching a single source tree. But if, for some reason, you need
+multiple sources, just set @code{c['change_source']} to a list of
+ChangeSources.. it will accept that too.
@example
s = FreshCVSSourceNewcred(host="host", port=4519,
user="alice", passwd="secret",
prefix="Twisted")
-BuildmasterConfig['sources'] = [s]
+BuildmasterConfig['change_source'] = [s]
@end example
Each source tree has a nominal @code{top}. Each Change has a list of
@@ -2682,9 +2696,9 @@
Then add a clause like this to your buildmaster's @file{master.cfg}:
@example
-BuildmasterConfig['sources'] = [FreshCVSSource("cvs.example.com", 4519,
- "foo", "bar",
- prefix="glib/")]
+BuildmasterConfig['change_source'] = FreshCVSSource("cvs.example.com", 4519,
+ "foo", "bar",
+ prefix="glib/")
@end example
where "cvs.example.com" is the host that is running the FreshCVS daemon, and
@@ -2725,13 +2739,12 @@
ChangeSource variant for each parsing function.
Once you've chosen a maildir location and a parsing function, create
-the change source and put it in the @code{c['sources']} list. Since
-buildmasters usually only have a single change source,
- at code{c['sources']} can also be a single instance:
+the change source and put it in @code{c['change_source']}:
@example
from buildbot.changes.mail import SyncmailMaildirSource
-c['sources'] = SyncmailMaildirSource("~/maildir-buildbot", prefix="/trunk/")
+c['change_source'] = SyncmailMaildirSource("~/maildir-buildbot",
+ prefix="/trunk/")
@end example
@menu
@@ -2879,7 +2892,7 @@
@example
from buildbot.changes.mail import FCMaildirSource
-c['sources'] = FCMaildirSource("~/maildir-buildbot")
+c['change_source'] = FCMaildirSource("~/maildir-buildbot")
@end example
@node SyncmailMaildirSource, BonsaiMaildirSource, FCMaildirSource, Parsing Email Change Messages
@@ -2894,7 +2907,7 @@
@example
from buildbot.changes.mail import SyncmailMaildirSource
-c['sources'] = SyncmailMaildirSource("~/maildir-buildbot")
+c['change_source'] = SyncmailMaildirSource("~/maildir-buildbot")
@end example
@node BonsaiMaildirSource, SVNCommitEmailMaildirSource, SyncmailMaildirSource, Parsing Email Change Messages
@@ -2909,7 +2922,7 @@
@example
from buildbot.changes.mail import BonsaiMaildirSource
-c['sources'] = BonsaiMaildirSource("~/maildir-buildbot")
+c['change_source'] = BonsaiMaildirSource("~/maildir-buildbot")
@end example
@node SVNCommitEmailMaildirSource, , BonsaiMaildirSource, Parsing Email Change Messages
@@ -2926,7 +2939,7 @@
@example
from buildbot.changes.mail import SVNCommitEmailMaildirSource
-c['sources'] = SVNCommitEmailMaildirSource("~/maildir-buildbot")
+c['change_source'] = SVNCommitEmailMaildirSource("~/maildir-buildbot")
@end example
@@ -3045,10 +3058,10 @@
@example
import buildbot.changes.p4poller
-c['sources'].append(p4poller.P4Source(
- p4base='//depot/project/',
- split_file=lambda branchfile: branchfile.split('/',1)
-))
+s = p4poller.P4Source(p4base='//depot/project/',
+ split_file=lambda branchfile: branchfile.split('/',1),
+ )
+c['change_source'] = s
@end example
@node BonsaiPoller, SVNPoller, P4Source, Getting Source Code Changes
@@ -3188,8 +3201,7 @@
@example
from buildbot.changes.svnpoller import SVNPoller
-s = SVNPoller("svn://svn.twistedmatrix.com/svn/Twisted/trunk")
-c['sources'].append(ss)
+c['change_source'] = SVNPoller("svn://svn.twistedmatrix.com/svn/Twisted/trunk")
@end example
In this case, every Change that our @code{SVNPoller} produces will
@@ -3242,9 +3254,8 @@
@example
from buildbot.changes.svnpoller import SVNPoller, split_file_branches
-s = SVNPoller("svn://svn.twistedmatrix.com/svn/Twisted",
- split_file=split_file_branches)
-c['sources'].append(ss)
+c['change_source'] = SVNPoller("svn://svn.twistedmatrix.com/svn/Twisted",
+ split_file=split_file_branches)
@end example
Changes for all sorts of branches (with names like ``branches/1.5.x'',
@@ -3283,8 +3294,7 @@
@example
from buildbot.changes.svnpoller import SVNPoller
-s = SVNPoller("http://divmod.org/svn/Divmod/trunk/Nevow")
-c['sources'].append(ss)
+c['change_source'] = SVNPoller("http://divmod.org/svn/Divmod/trunk/Nevow")
@end example
But what happens when we want to track multiple Nevow branches? We
@@ -3297,9 +3307,8 @@
@example
from buildbot.changes.svnpoller import SVNPoller
-s = SVNPoller("http://divmod.org/svn/Divmod",
- split_file=my_file_splitter)
-c['sources'].append(ss)
+c['change_source'] = SVNPoller("http://divmod.org/svn/Divmod",
+ split_file=my_file_splitter)
@end example
The @code{my_file_splitter} function will be called with
@@ -3821,7 +3830,7 @@
from buildbot.process import source, factory
from buildbot.steps import source, shell
-c['sources'] = [PBChangeSource()]
+c['change_source'] = PBChangeSource()
s1 = AnyBranchScheduler('main',
['trunk', 'features/newthing', 'features/otherthing'],
10*60, ['test-i386', 'test-ppc'])
@@ -6534,8 +6543,8 @@
This command is used to tell the buildmaster about source changes. It
is intended to be used from within a commit script, installed on the
VC server. It requires that you have a PBChangeSource
-(@pxref{PBChangeSource}) running in the buildmaster (by being included
-in the @code{c['sources']} list).
+(@pxref{PBChangeSource}) running in the buildmaster (by being set in
+ at code{c['change_source']}).
@example
@@ -6800,7 +6809,7 @@
@unnumbered Index of master.cfg keys
This is a list of all of the significant keys in master.cfg . Recall
-that master.cfg is effectively a small python program one
+that master.cfg is effectively a small python program with exactly one
responsibility: create a dictionary named @code{BuildmasterConfig}.
The keys of this dictionary are listed here. The beginning of the
master.cfg file typically starts with something like:
@@ -6809,8 +6818,8 @@
BuildmasterConfig = c = @{@}
@end example
-Therefore a config key of @code{sources} will usually appear in
-master.cfg as @code{c['sources']}.
+Therefore a config key of @code{change_source} will usually appear in
+master.cfg as @code{c['change_source']}.
@printindex bc
- Previous message (by thread): [Buildbot-commits] buildbot/buildbot/test test_changes.py, 1.11, 1.12 test_config.py, 1.45, 1.46 test_control.py, 1.16, 1.17 test_dependencies.py, 1.7, 1.8 test_locks.py, 1.9, 1.10 test_properties.py, 1.9, 1.10 test_run.py, 1.45, 1.46 test_slaves.py, 1.10, 1.11 test_status.py, 1.42, 1.43 test_steps.py, 1.41, 1.42 test_vc.py, 1.75, 1.76 test_web.py, 1.45, 1.46
- Next message (by thread): [Buildbot-commits] buildbot ChangeLog,1.882,1.883
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
More information about the Commits
mailing list