Package buildbot :: Package status :: Module builder :: Class BuildStepStatus
[frames] | no frames]

Class BuildStepStatus

source code

twisted.persisted.styles.Versioned --+
                                     |
                                    BuildStepStatus

I represent a collection of output status for a buildbot.process.step.BuildStep.

Statistics contain any information gleaned from a step that is not in the form of a logfile. As an example, steps that run tests might gather statistics about the number of passed, failed, or skipped tests.

Instance Methods
 
__init__(self, parent, step_number) source code
 
getName(self)
Returns a short string with the name of this step.
source code
 
getBuild(self) source code
 
getTimes(self) source code
 
getExpectations(self)
Returns a list of tuples (name, current, target).
source code
 
getLogs(self) source code
 
getURLs(self) source code
 
isStarted(self) source code
 
isSkipped(self) source code
 
isFinished(self) source code
 
waitUntilFinished(self) source code
 
getETA(self) source code
 
getText(self)
Returns a list of strings which describe the step.
source code
tuple of int, list of strings
getResults(self)
Return a tuple describing the results of the step.
source code
 
hasStatistic(self, name)
Return true if this step has a value for the given statistic.
source code
 
getStatistic(self, name, default=None)
Return the given statistic, if present
source code
 
subscribe(self, receiver, updateInterval=10) source code
 
sendETAUpdate(self, receiver, updateInterval) source code
 
unsubscribe(self, receiver) source code
 
setName(self, stepname) source code
 
setColor(self, color) source code
 
setProgress(self, stepprogress) source code
 
stepStarted(self) source code
 
addLog(self, name) source code
 
addHTMLLog(self, name, html) source code
 
logFinished(self, log) source code
 
addURL(self, name, url) source code
 
setText(self, text) source code
 
setText2(self, text) source code
 
setStatistic(self, name, value)
Set the given statistic.
source code
 
setSkipped(self, skipped) source code
 
stepFinished(self, results) source code
 
checkLogfiles(self) source code
 
isWaitingForLocks(self) source code
 
setWaitingForLocks(self, waiting) source code
 
__getstate__(self)
Get state, adding a version number to it on its way out.
source code
 
__setstate__(self, d) source code
 
upgradeToVersion1(self) source code
 
upgradeToVersion2(self) source code
 
upgradeToVersion3(self) source code
 
asDict(self) source code

Inherited from twisted.persisted.styles.Versioned: __providedBy__, versionUpgrade

Class Variables
  persistenceVersion = 3
  started = None
hash(x)
  finished = None
hash(x)
buildbot.status.progress.StepProgress progress = None
tracks ETA for the step
list of strings text = []
list of short texts that describe the command and its status
  results = (None, [])
list of strings text2 = []
list of short texts added to the overall build description
  watchers = []
  updates = {}
  finishedWatchers = []
  step_number = None
hash(x)
  __implemented__ = <implementedBy buildbot.status.builder.Build...
  __provides__ = <zope.interface.declarations.ClassProvides obje...

Inherited from twisted.persisted.styles.Versioned: persistenceForgets

Instance Variables
dict statistics = {}
results from running this step
dict of string -> buildbot.status.builder.LogFile logs
logs of steps
Method Details

getName(self)

source code 

Returns a short string with the name of this step. This string may have spaces in it.

getText(self)

source code 

Returns a list of strings which describe the step. These are intended to be displayed in a narrow column. If more space is available, the caller should join them together with spaces before presenting them to the user.

getResults(self)

source code 

Return a tuple describing the results of the step. 'result' is one of the constants in buildbot.status.builder: SUCCESS, WARNINGS, FAILURE, or SKIPPED. 'strings' is an optional list of strings that the step wants to append to the overall build's results. These strings are usually more terse than the ones returned by getText(): in particular, successful Steps do not usually contribute any text to the overall build.

Returns: tuple of int, list of strings
(result, strings)

setStatistic(self, name, value)

source code 

Set the given statistic. Usually called by subclasses.

__getstate__(self)

source code 

Get state, adding a version number to it on its way out.

Overrides: twisted.persisted.styles.Versioned.__getstate__
(inherited documentation)

__setstate__(self, d)

source code 
Overrides: twisted.persisted.styles.Versioned.__setstate__

Class Variable Details

__implemented__

Value:
<implementedBy buildbot.status.builder.BuildStepStatus>

__provides__

Value:
<zope.interface.declarations.ClassProvides object at 0x29f4590>