Package buildbot :: Package steps :: Module trigger :: Class Trigger
[frames] | no frames]

Class Trigger

source code

   process.buildstep.BuildStep --+    
                                 |    
process.buildstep.LoggingBuildStep --+
                                     |
                                    Trigger

I trigger a scheduler.Triggerable, to use one or more Builders as if they were a single buildstep (like a subroutine call).

Instance Methods
 
__init__(self, schedulerNames=[], updateSourceStamp=True, waitForFinish=False, set_properties={}, copy_properties=[], **kwargs)
Trigger the given schedulers when this step is executed.
source code
 
interrupt(self, reason)
Halt the command, either because the user has decided to cancel the build ('reason' is a string), or because the slave has disconnected ('reason' is a ConnectionLost Failure).
source code
 
start(self)
Begin the step.
source code

Inherited from process.buildstep.LoggingBuildStep: addLogFile, checkDisconnect, commandComplete, createSummary, evaluateCommand, getText, getText2, maybeGetText2, setStatus, setupLogfiles, startCommand

Inherited from process.buildstep.BuildStep: acquireLocks, addCompleteLog, addFactoryArguments, addHTMLLog, addLog, addLogObserver, addURL, describe, failed, finished, getLog, getProperty, getSlaveName, getStepFactory, releaseLocks, runCommand, setBuild, setBuildSlave, setDefaultWorkdir, setProgress, setProperty, setStepStatus, setupProgress, slaveVersion, slaveVersionIsOlderThan, startStep

Class Variables
  name = 'trigger'
  flunkOnFailure = True

Inherited from process.buildstep.LoggingBuildStep: cmd, logfiles, parms, progressMetrics

Inherited from process.buildstep.BuildStep: alwaysRun, doStepIf, flunkOnWarnings, haltOnFailure, locks, useProgress, warnOnFailure, warnOnWarnings

Instance Variables

Inherited from process.buildstep.BuildStep: build, progress, step_status

Method Details

__init__(self, schedulerNames=[], updateSourceStamp=True, waitForFinish=False, set_properties={}, copy_properties=[], **kwargs)
(Constructor)

source code 

Trigger the given schedulers when this step is executed.

Parameters:
  • schedulerNames - A list of scheduler names that should be triggered. Schedulers can be specified using WithProperties, if desired.
  • updateSourceStamp - If True (the default), I will try to give the schedulers an absolute SourceStamp for their builds, so that a HEAD build will use the same revision even if more changes have occurred since my build's update step was run. If False, I will use the original SourceStamp unmodified.
  • waitForFinish - If False (the default), this step will finish as soon as I've started the triggered schedulers. If True, I will wait until all of the triggered schedulers have finished their builds.
  • set_properties - A dictionary of properties to set for any builds resulting from this trigger. These properties will override properties set in the Triggered scheduler's constructor.
  • copy_properties - a list of property names to copy verbatim into any builds resulting from this trigger.
Overrides: process.buildstep.BuildStep.__init__

interrupt(self, reason)

source code 

Halt the command, either because the user has decided to cancel the build ('reason' is a string), or because the slave has disconnected ('reason' is a ConnectionLost Failure). Any further local processing should be skipped, and the Step completed with an error status. The results text should say something useful like ['step', 'interrupted'] or ['remote', 'lost']

Overrides: process.buildstep.BuildStep.interrupt
(inherited documentation)

start(self)

source code 

Begin the step. Override this method and add code to do local processing, fire off remote commands, etc.

To spawn a command in the buildslave, create a RemoteCommand instance and run it with self.runCommand:

 c = RemoteCommandFoo(args)
 d = self.runCommand(c)
 d.addCallback(self.fooDone).addErrback(self.failed)

As the step runs, it should send status information to the BuildStepStatus:

 self.step_status.setText(['compile', 'failed'])
 self.step_status.setText2(['4', 'warnings'])

To have some code parse stdio (or other log stream) in realtime, add a LogObserver subclass. This observer can use self.step.setProgress() to provide better progress notification to the step.:

 self.addLogObserver('stdio', MyLogObserver())

To add a LogFile, use self.addLog. Make sure it gets closed when it finishes. When giving a Logfile to a RemoteShellCommand, just ask it to close the log when the command completes:

 log = self.addLog('output')
 cmd = RemoteShellCommand(args)
 cmd.useLog(log, closeWhenFinished=True)

You can also create complete Logfiles with generated text in a single step:

 self.addCompleteLog('warnings', text)

When the step is done, it should call self.finished(result). 'result' will be provided to the buildbot.process.base.Build, and should be one of the constants defined above: SUCCESS, WARNINGS, FAILURE, or SKIPPED.

If the step encounters an exception, it should call self.failed(why). 'why' should be a Failure object. This automatically fails the whole build with an exception. It is a good idea to add self.failed as an errback to any Deferreds you might obtain.

If the step decides it does not need to be run, start() can return the constant SKIPPED. This fires the callback immediately: it is not necessary to call .finished yourself. This can also indicate to the status-reporting mechanism that this step should not be displayed.

A step can be configured to only run under certain conditions. To do this, set the step's doStepIf to a boolean value, or to a function that returns a boolean value. If the value or function result is False, then the step will return SKIPPED without doing anything, otherwise the step will be executed normally. If you set doStepIf to a function, that function should accept one parameter, which will be the Step object itself.

Overrides: process.buildstep.BuildStep.start
(inherited documentation)