net.thucydides.core.steps

Class StepEventBus

java.lang.Object

net.thucydides.core.steps.StepEventBus

Direct Known Subclasses:

SilentEventBus

public class StepEventBus
extends java.lang.Object

An event bus for Step-related notifications. Use this to integrate Thucydides listeners with testing tools. You create a listener (e.g. an instance of BaseStepListener, or your own), register it using 'registerListener', and then implement the various methods (testStarted(), stepStarted()). Thucydides will call these events on your listener as they occur. You can register a new Thucydides listener by implementing the StepListener interface and placing your class in the classpath. Thucydides will automatically detect the listener and add it to the registered listeners. It will load custom listeners automatically when a test starts for the first time.

Constructor Summary

Constructors

Constructor and Description
StepEventBus(net.thucydides.core.util.EnvironmentVariables environmentVariables)

Method Summary

Modifier and Type	Method and Description
void	addDescriptionToCurrentTest(java.lang.String description)
void	addIssuesToCurrentStory(java.util.List<java.lang.String> issues)
void	addIssuesToCurrentTest(java.util.List<java.lang.String> issues)
void	addNewExamplesFrom(net.thucydides.core.model.DataTable newTable)
void	addTagsToCurrentStory(java.util.List<net.thucydides.core.model.TestTag> tags)
void	addTagsToCurrentTest(java.util.List<net.thucydides.core.model.TestTag> tags)
boolean	areStepsRunning()
boolean	assumptionViolated()
void	assumptionViolated(java.lang.String message)
boolean	aStepInTheCurrentTestHasFailed()
void	cancelPreviousTest()
void	castActor(java.lang.String name)
void	clear()
static void	clearEventBusFor(java.lang.Object key)
void	clearStepFailures()
boolean	currentTestIsSuspended()
boolean	currentTestOutcomeIsDataDriven()
void	disableSoftAsserts()
void	dropAllListeners()
void	dropListener(net.thucydides.core.steps.StepListener stepListener)
void	enableDryRun()
void	enableSoftAsserts()
static StepEventBus	eventBusFor(java.lang.Object key)
void	exampleFinished()
void	exampleStarted(java.util.Map<java.lang.String,java.lang.String> data)
void	exceptionExpected(java.lang.Class<? extends java.lang.Throwable> expected)
java.lang.String	getAssumptionViolatedMessage()
BaseStepListener	getBaseStepListener()
java.util.Optional<net.thucydides.core.model.TestStep>	getCurrentStep()
net.thucydides.core.util.EnvironmentVariables	getEnvironmentVariables()
static StepEventBus	getEventBus() The event bus used to inform listening classes about when tests and test steps start and finish.
java.util.Optional<net.thucydides.core.model.TestResult>	getForcedResult()
java.lang.String	getTestSource()
boolean	isBaseStepListenerRegistered()
boolean	isCurrentTestDataDriven()
boolean	isDryRun()
boolean	isUniqueSession()
void	lastStepFailed(net.thucydides.core.steps.StepFailure failure)
void	lastTestPassedAfterRetries(int remainingTries, java.util.List<java.lang.String> failureMessages, net.thucydides.core.steps.TestFailureCause testFailureCause)
void	mergePreviousStep()
void	notifyScreenChange()
static void	overrideEventBusWith(StepEventBus stepEventBus)
void	reenableWebdriverCalls()
StepEventBus	registerListener(net.thucydides.core.steps.StepListener listener) Register a listener to receive notification at different points during a test's execution.
void	reset()
java.util.Optional<net.thucydides.core.model.TestResult>	resultSoFar()
void	setAllStepsTo(net.thucydides.core.model.TestResult result) Set all steps in the current test outcome to a given result.
void	setBackgroundDescription(java.lang.String description)
void	setBackgroundTitle(java.lang.String title)
static void	setCurrentBusToEventBusFor(java.lang.Object key)
void	setTestSource(java.lang.String testSource)
void	setUniqueSession(boolean uniqueSession)
void	skippedStepStarted(net.thucydides.core.steps.ExecutedStepDescription executedStepDescription) Record a step that is not scheduled to be executed (e.g.
boolean	softAssertsActive()
void	stepFailed(net.thucydides.core.steps.StepFailure failure)
void	stepFinished()
void	stepIgnored()
void	stepPending()
void	stepPending(java.lang.String message)
void	stepStarted(net.thucydides.core.steps.ExecutedStepDescription stepDescription) Start the execution of a test step.
void	stepStarted(net.thucydides.core.steps.ExecutedStepDescription stepDescription, boolean isPrecondition) Start the execution of a test step.
void	suspendTest()
void	suspendTest(net.thucydides.core.model.TestResult result)
void	takeScreenshot() Forces Thucydides to take a screenshot now.
void	temporarilySuspendWebdriverCalls()
void	testFailed(java.lang.Throwable cause) The test failed, but not during the execution of a step.
void	testFinished()
void	testFinished(net.thucydides.core.model.TestOutcome result)
void	testIgnored()
void	testIsManual() Mark the current test method as pending.
void	testPending() Mark the current test method as pending.
void	testRetried()
void	testRunFinished()
void	testSkipped()
void	testStarted(java.lang.String testName)
void	testStarted(java.lang.String newTestName, java.lang.Class<?> testClass)
void	testStarted(java.lang.String newTestName, net.thucydides.core.model.Story story)
void	testStarted(java.lang.String testName, java.lang.String id)
void	testSuiteFinished()
boolean	testSuiteHasStarted()
void	testSuiteStarted(java.lang.Class<?> testClass)
void	testSuiteStarted(net.thucydides.core.model.Story story)
void	unsuspend() Removes a test suspension
void	updateCurrentStepTitle(java.lang.String stepTitle)
void	updateCurrentStepTitleAsPrecondition(java.lang.String stepTitle)
void	updateOverallResults()
void	useExamplesFrom(net.thucydides.core.model.DataTable table)
void	useScenarioOutline(java.lang.String scenarioOutline)
boolean	webdriverCallsAreSuspended()

Methods inherited from class java.lang.Object

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

Constructor Detail

StepEventBus

@Inject
public StepEventBus(net.thucydides.core.util.EnvironmentVariables environmentVariables)

Method Detail

getEventBus

public static StepEventBus getEventBus()

The event bus used to inform listening classes about when tests and test steps start and finish. There is a separate event bus for each thread.

eventBusFor

public static StepEventBus eventBusFor(java.lang.Object key)

setCurrentBusToEventBusFor

public static void setCurrentBusToEventBusFor(java.lang.Object key)

clearEventBusFor

public static void clearEventBusFor(java.lang.Object key)

getEnvironmentVariables

public net.thucydides.core.util.EnvironmentVariables getEnvironmentVariables()

registerListener

public StepEventBus registerListener(net.thucydides.core.steps.StepListener listener)

Register a listener to receive notification at different points during a test's execution. If you are writing your own listener, you shouldn't need to call this method - just set up your listener implementation as a service (see http://download.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html), place the listener class on the classpath and it will be detected automatically.

isBaseStepListenerRegistered

public boolean isBaseStepListenerRegistered()

getBaseStepListener

public BaseStepListener getBaseStepListener()

testStarted

public void testStarted(java.lang.String testName)

testStarted

public void testStarted(java.lang.String testName,
                        java.lang.String id)

isUniqueSession

public boolean isUniqueSession()

setUniqueSession

public void setUniqueSession(boolean uniqueSession)

testStarted

public void testStarted(java.lang.String newTestName,
                        net.thucydides.core.model.Story story)

testStarted

public void testStarted(java.lang.String newTestName,
                        java.lang.Class<?> testClass)

testSuiteStarted

public void testSuiteStarted(java.lang.Class<?> testClass)

testSuiteStarted

public void testSuiteStarted(net.thucydides.core.model.Story story)

clear

public void clear()

unsuspend

public void unsuspend()

Removes a test suspension

testFinished

public void testFinished()

testFinished

public void testFinished(net.thucydides.core.model.TestOutcome result)

testRetried

public void testRetried()

clearStepFailures

public void clearStepFailures()

aStepInTheCurrentTestHasFailed

public boolean aStepInTheCurrentTestHasFailed()

isCurrentTestDataDriven

public boolean isCurrentTestDataDriven()

stepStarted

public void stepStarted(net.thucydides.core.steps.ExecutedStepDescription stepDescription)

Start the execution of a test step.

stepStarted

public void stepStarted(net.thucydides.core.steps.ExecutedStepDescription stepDescription,
                        boolean isPrecondition)

Start the execution of a test step.

skippedStepStarted

public void skippedStepStarted(net.thucydides.core.steps.ExecutedStepDescription executedStepDescription)

Record a step that is not scheduled to be executed (e.g. a skipped or ignored step).

stepFinished

public void stepFinished()

stepFailed

public void stepFailed(net.thucydides.core.steps.StepFailure failure)

lastStepFailed

public void lastStepFailed(net.thucydides.core.steps.StepFailure failure)

stepIgnored

public void stepIgnored()

stepPending

public void stepPending()

stepPending

public void stepPending(java.lang.String message)

assumptionViolated

public void assumptionViolated(java.lang.String message)

dropListener

public void dropListener(net.thucydides.core.steps.StepListener stepListener)

dropAllListeners

public void dropAllListeners()

webdriverCallsAreSuspended

public boolean webdriverCallsAreSuspended()

reenableWebdriverCalls

public void reenableWebdriverCalls()

temporarilySuspendWebdriverCalls

public void temporarilySuspendWebdriverCalls()

testFailed

public void testFailed(java.lang.Throwable cause)

The test failed, but not during the execution of a step.

Parameters:

cause - the underlying cause of the failure.

testPending

public void testPending()

Mark the current test method as pending. The test will stil be executed to record the steps, but any webdriver calls will be skipped.

testIsManual

public void testIsManual()

Mark the current test method as pending. The test will stil be executed to record the steps, but any webdriver calls will be skipped.

suspendTest

public void suspendTest()

suspendTest

public void suspendTest(net.thucydides.core.model.TestResult result)

useScenarioOutline

public void useScenarioOutline(java.lang.String scenarioOutline)

currentTestIsSuspended

public boolean currentTestIsSuspended()

assumptionViolated

public boolean assumptionViolated()

testIgnored

public void testIgnored()

testSkipped

public void testSkipped()

areStepsRunning

public boolean areStepsRunning()

notifyScreenChange

public void notifyScreenChange()

testSuiteFinished

public void testSuiteFinished()

testRunFinished

public void testRunFinished()

updateCurrentStepTitle

public void updateCurrentStepTitle(java.lang.String stepTitle)

updateCurrentStepTitleAsPrecondition

public void updateCurrentStepTitleAsPrecondition(java.lang.String stepTitle)

addIssuesToCurrentStory

public void addIssuesToCurrentStory(java.util.List<java.lang.String> issues)

addIssuesToCurrentTest

public void addIssuesToCurrentTest(java.util.List<java.lang.String> issues)

addTagsToCurrentTest

public void addTagsToCurrentTest(java.util.List<net.thucydides.core.model.TestTag> tags)

addTagsToCurrentStory

public void addTagsToCurrentStory(java.util.List<net.thucydides.core.model.TestTag> tags)

addDescriptionToCurrentTest

public void addDescriptionToCurrentTest(java.lang.String description)

setBackgroundTitle

public void setBackgroundTitle(java.lang.String title)

setBackgroundDescription

public void setBackgroundDescription(java.lang.String description)

useExamplesFrom

public void useExamplesFrom(net.thucydides.core.model.DataTable table)

addNewExamplesFrom

public void addNewExamplesFrom(net.thucydides.core.model.DataTable newTable)

exampleStarted

public void exampleStarted(java.util.Map<java.lang.String,java.lang.String> data)

exampleFinished

public void exampleFinished()

currentTestOutcomeIsDataDriven

public boolean currentTestOutcomeIsDataDriven()

takeScreenshot

public void takeScreenshot()

Forces Thucydides to take a screenshot now.

testSuiteHasStarted

public boolean testSuiteHasStarted()

getAssumptionViolatedMessage

public java.lang.String getAssumptionViolatedMessage()

getCurrentStep

public java.util.Optional<net.thucydides.core.model.TestStep> getCurrentStep()

setAllStepsTo

public void setAllStepsTo(net.thucydides.core.model.TestResult result)

Set all steps in the current test outcome to a given result. Used to set all steps to PENDING or SKIPPED, for example.

Parameters:

result -

getForcedResult

public java.util.Optional<net.thucydides.core.model.TestResult> getForcedResult()

isDryRun

public boolean isDryRun()

enableDryRun

public void enableDryRun()

exceptionExpected

public void exceptionExpected(java.lang.Class<? extends java.lang.Throwable> expected)

resultSoFar

public java.util.Optional<net.thucydides.core.model.TestResult> resultSoFar()

mergePreviousStep

public void mergePreviousStep()

updateOverallResults

public void updateOverallResults()

reset

public void reset()

disableSoftAsserts

public void disableSoftAsserts()

enableSoftAsserts

public void enableSoftAsserts()

softAssertsActive

public boolean softAssertsActive()

getTestSource

public java.lang.String getTestSource()

setTestSource

public void setTestSource(java.lang.String testSource)

cancelPreviousTest

public void cancelPreviousTest()

lastTestPassedAfterRetries

public void lastTestPassedAfterRetries(int remainingTries,
                                       java.util.List<java.lang.String> failureMessages,
                                       net.thucydides.core.steps.TestFailureCause testFailureCause)

overrideEventBusWith

public static void overrideEventBusWith(StepEventBus stepEventBus)

castActor

public void castActor(java.lang.String name)