Package buildbot :: Package steps :: Module shell :: Class WarningCountingShellCommand
[frames] | no frames]

Class WarningCountingShellCommand

source code

   process.buildstep.BuildStep --+        
                                 |        
process.buildstep.LoggingBuildStep --+    
                                     |    
                          ShellCommand --+
                                         |
                                        WarningCountingShellCommand
Known Subclasses:

Instance Methods
 
__init__(self, workdir=None, warningPattern=None, warningExtractor=None, directoryEnterPattern=None, directoryLeavePattern=None, suppressionFile=None, **kwargs) source code
 
setDefaultWorkdir(self, workdir) source code
 
addSuppression(self, suppressionList)
This method can be used to add patters of warnings that should not be counted.
source code
 
warnExtractWholeLine(self, line, match)
Extract warning text as the whole line.
source code
 
warnExtractFromRegexpGroups(self, line, match)
Extract file name, line number, and warning text as groups (1,2,3) of warningPattern match.
source code
 
maybeAddWarning(self, warnings, line, match) source code
 
start(self)
Begin the step.
source code
 
uploadDone(self, dummy) source code
 
createSummary(self, log)
Match log lines against warningPattern.
source code
 
evaluateCommand(self, cmd)
Decide whether the command was SUCCESS, WARNINGS, or FAILURE.
source code

Inherited from ShellCommand: checkForOldSlaveAndLogfiles, describe, setCommand, setStepStatus, setupEnvironment

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

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

Class Variables
  warnCount = 0
  warningPattern = '.*warning[: ].*'
  directoryEnterPattern = 'make.*: Entering directory ["`\'](.*)...
  directoryLeavePattern = 'make.*: Leaving directory'
  suppressionFile = None
hash(x)
  commentEmptyLineRe = re.compile(r'^\s*(#.*)?$')
  suppressionLineRe = re.compile(r'^\s*(.+?)\s*:\s*(.+?)\s*(?::\...

Inherited from ShellCommand: description, descriptionDone, flunkOnFailure, name

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

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

Instance Variables

Inherited from ShellCommand: command, lazylogfiles, logfiles

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

Method Details

__init__(self, workdir=None, warningPattern=None, warningExtractor=None, directoryEnterPattern=None, directoryLeavePattern=None, suppressionFile=None, **kwargs)
(Constructor)

source code 
Overrides: process.buildstep.BuildStep.__init__

setDefaultWorkdir(self, workdir)

source code 
Overrides: process.buildstep.BuildStep.setDefaultWorkdir

addSuppression(self, suppressionList)

source code 

This method can be used to add patters of warnings that should not be counted.

It takes a single argument, a list of patterns.

Each pattern is a 4-tuple (FILE-RE, WARN-RE, START, END).

FILE-RE is a regular expression (string or compiled regexp), or None. If None, the pattern matches all files, else only files matching the regexp. If directoryEnterPattern is specified in the class constructor, matching is against the full path name, eg. src/main.c.

WARN-RE is similarly a regular expression matched against the text of the warning, or None to match all warnings.

START and END form an inclusive line number range to match against. If START is None, there is no lower bound, similarly if END is none there is no upper bound.

warnExtractWholeLine(self, line, match)

source code 

Extract warning text as the whole line. No file names or line numbers.

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)

createSummary(self, log)

source code 

Match log lines against warningPattern.

Warnings are collected into another log for this step, and the build-wide 'warnings-count' is updated.

Overrides: process.buildstep.LoggingBuildStep.createSummary

evaluateCommand(self, cmd)

source code 

Decide whether the command was SUCCESS, WARNINGS, or FAILURE. Override this to, say, declare WARNINGS if there is any stderr activity, or to say that rc!=0 is not actually an error.

Overrides: process.buildstep.LoggingBuildStep.evaluateCommand
(inherited documentation)

Class Variable Details

directoryEnterPattern

Value:
'make.*: Entering directory ["`\'](.*)[\'`"]'

suppressionLineRe

Value:
re.compile(r'^\s*(.+?)\s*:\s*(.+?)\s*(?::\s*([0-9]+)(?:-([0-9]+))?\s*)\
?$')