hudson.plugins.robot

Class RobotPublisher

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Publisher

hudson.tasks.Recorder

hudson.plugins.robot.RobotPublisher

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.matrix.MatrixAggregatable, hudson.model.Describable<hudson.tasks.Publisher>, hudson.tasks.BuildStep, Serializable

public class RobotPublisher
extends hudson.tasks.Recorder
implements Serializable, hudson.matrix.MatrixAggregatable

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RobotPublisher.DescriptorImpl Descriptor for the publisher

Nested classes/interfaces inherited from class hudson.tasks.Publisher

hudson.tasks.Publisher.DescriptorExtensionListImpl

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

hudson.tasks.BuildStep.PublisherList

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DEFAULT_REPORT_FILE
protected static String	FILE_ARCHIVE_DIR

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
RobotPublisher(String outputPath, String outputFileName, boolean disableArchiveOutput, String reportFileName, String logFileName, double passThreshold, double unstableThreshold, boolean onlyCritical, String otherFiles) Create new publisher for Robot Framework results

Method Summary

Methods

Modifier and Type	Method and Description
static void	copyFilesToBuildDir(hudson.model.AbstractBuild<?,?> build, String inputPath, String filemaskToCopy) Copy files with given filemasks from input path relative to build into specific build file archive dir
hudson.matrix.MatrixAggregator	createAggregator(hudson.matrix.MatrixBuild build, hudson.Launcher launcher, hudson.model.BuildListener listener)
protected hudson.model.Result	getBuildResult(hudson.model.AbstractBuild<?,?> build, RobotResult result) Determines the build result based on set thresholds.
boolean	getDisableArchiveOutput()
String	getLogFileName() Gets the name of log html file.
boolean	getOnlyCritical() Gets if only critical tests should be accounted for the thresholds.
String	getOtherFiles() Gets the comma separated list of other filemasks to copy into build dir
String	getOutputFileName() Gets the name of output xml file.
String	getOutputPath() Gets the output path of Robot files
double	getPassThreshold() Gets the test pass percentage threshold for successful builds.
Collection<hudson.model.Action>	getProjectActions(hudson.model.AbstractProject<?,?> project)
String	getReportFileName() Gets the name of report html file.
hudson.tasks.BuildStepMonitor	getRequiredMonitorService()
static String	getSuffix(String filename) Return file suffix from string.
double	getUnstableThreshold() Gets the test pass percentage threshold for unstable builds.
protected RobotResult	parse(String expandedTestResults, String outputPath, hudson.model.AbstractBuild<?,?> build, hudson.Launcher launcher, hudson.model.BuildListener listener)
boolean	perform(hudson.model.AbstractBuild<?,?> build, hudson.Launcher launcher, hudson.model.BuildListener listener)
static String	trimSuffix(String filename) Return filename without file suffix.

Methods inherited from class hudson.tasks.Recorder

getDescriptor

Methods inherited from class hudson.tasks.Publisher

all, getProjectAction, needsToRunAfterFinalized, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, perform, prebuild

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface hudson.tasks.BuildStep

getProjectAction, prebuild

Field Detail

DEFAULT_REPORT_FILE

protected static final String DEFAULT_REPORT_FILE

See Also:

Constant Field Values

FILE_ARCHIVE_DIR

protected static final String FILE_ARCHIVE_DIR

See Also:

Constant Field Values

Constructor Detail

RobotPublisher

@DataBoundConstructor
public RobotPublisher(String outputPath,
                                   String outputFileName,
                                   boolean disableArchiveOutput,
                                   String reportFileName,
                                   String logFileName,
                                   double passThreshold,
                                   double unstableThreshold,
                                   boolean onlyCritical,
                                   String otherFiles)

Create new publisher for Robot Framework results

Parameters:

outputPath - Path to Robot Framework's output files

outputFileName - Name of Robot output xml

disableArchiveOutput - Disable Archiving output xml file to server

reportFileName - Name of Robot report html

logFileName - Name of Robot log html

passThreshold - Threshold of test pass percentage for successful builds

unstableThreshold - Threhold of test pass percentage for unstable builds

onlyCritical - True if only critical tests are included in pass percentage

Method Detail

getOutputPath

public String getOutputPath()

Gets the output path of Robot files

Returns:

getOutputFileName

public String getOutputFileName()

Gets the name of output xml file. Reverts to default if empty or whitespace.

Returns:

getDisableArchiveOutput

public boolean getDisableArchiveOutput()

getReportFileName

public String getReportFileName()

Gets the name of report html file. Reverts to default if empty or whitespace.

Returns:

getLogFileName

public String getLogFileName()

Gets the name of log html file. Reverts to default if empty or whitespace.

Returns:

getPassThreshold

public double getPassThreshold()

Gets the test pass percentage threshold for successful builds.

Returns:

getUnstableThreshold

public double getUnstableThreshold()

Gets the test pass percentage threshold for unstable builds.

Returns:

getOnlyCritical

public boolean getOnlyCritical()

Gets if only critical tests should be accounted for the thresholds.

Returns:

getOtherFiles

public String getOtherFiles()

Gets the comma separated list of other filemasks to copy into build dir

Returns:

List of files as string

getProjectActions

public Collection<hudson.model.Action> getProjectActions(hudson.model.AbstractProject<?,?> project)

Specified by:

getProjectActions in interface hudson.tasks.BuildStep

Overrides:

getProjectActions in class hudson.tasks.BuildStepCompatibilityLayer

parse

protected RobotResult parse(String expandedTestResults,
                String outputPath,
                hudson.model.AbstractBuild<?,?> build,
                hudson.Launcher launcher,
                hudson.model.BuildListener listener)
                     throws IOException,
                            InterruptedException

Throws:

IOException

InterruptedException

perform

public boolean perform(hudson.model.AbstractBuild<?,?> build,
              hudson.Launcher launcher,
              hudson.model.BuildListener listener)
                throws InterruptedException,
                       IOException

Specified by:

perform in interface hudson.tasks.BuildStep

Overrides:

perform in class hudson.tasks.BuildStepCompatibilityLayer

Throws:

InterruptedException

IOException

copyFilesToBuildDir

public static void copyFilesToBuildDir(hudson.model.AbstractBuild<?,?> build,
                       String inputPath,
                       String filemaskToCopy)
                                throws IOException,
                                       InterruptedException

Copy files with given filemasks from input path relative to build into specific build file archive dir

Parameters:

build -

inputPath - Base path for copy. Relative to build workspace.

filemaskToCopy - List of Ant GLOB style filemasks to copy from dirs specified at inputPathMask

Throws:

IOException

InterruptedException

trimSuffix

public static String trimSuffix(String filename)

Return filename without file suffix.

Parameters:

filename -

Returns:

filename as string

getSuffix

public static String getSuffix(String filename)

Return file suffix from string.

Parameters:

filename -

Returns:

file suffix as string

getBuildResult

protected hudson.model.Result getBuildResult(hudson.model.AbstractBuild<?,?> build,
                                 RobotResult result)

Determines the build result based on set thresholds. If build is already failed before the tests it won't be changed to successful.

Parameters:

build - Build to be evaluated

result - Results associated to build

Returns:

Result of build

getRequiredMonitorService

public hudson.tasks.BuildStepMonitor getRequiredMonitorService()

Specified by:

getRequiredMonitorService in interface hudson.tasks.BuildStep

createAggregator

public hudson.matrix.MatrixAggregator createAggregator(hudson.matrix.MatrixBuild build,
                                              hudson.Launcher launcher,
                                              hudson.model.BuildListener listener)

Specified by:

createAggregator in interface hudson.matrix.MatrixAggregatable