randoop.execution

Class TestEnvironment

java.lang.Object

randoop.execution.TestEnvironment

public class TestEnvironment
extends java.lang.Object

Provides the environment for running JUnit tests.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.LinkedHashMap<java.nio.file.Path,java.lang.String>	agentMap A map from javaagent jar path to argument string.
private java.lang.String	replaceCallAgentArgs The argument string for the replacecall agent.
private java.nio.file.Path	replaceCallAgentPath The path for the replacecall agent.
private java.lang.String	testClasspath The classpath for the tests.
private long	timeoutMillis The process timeout in milliseconds.

Constructor Summary

Constructors

Constructor and Description
TestEnvironment(java.lang.String testClasspath) Creates a test environment with the given classpath and an empty agent map.

Method Summary

Modifier and Type	Method and Description
void	addAgent(java.nio.file.Path agentPath, java.lang.String agentArgumentString) Adds the path for a javaagent jar file to the agent map.
private java.util.List<java.lang.String>	commandPrefix() Constructs the command to run JUnit tests in this environment, minus the name of the test class.
private java.lang.String	getJavaagentOption(java.nio.file.Path agentPath, java.lang.String args)
RunCommand.Status	runTest(java.lang.String testClassName, java.nio.file.Path workingDirectory) Runs the named JUnit test class in this environment.
void	setReplaceCallAgent(java.nio.file.Path agentPath, java.lang.String agentArgs) Sets the path and arguments for the replace call agent.
void	setTimeoutMillis(long timeoutMillis) Set the test execution timeout.

Methods inherited from class java.lang.Object

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

Field Detail

timeoutMillis

private long timeoutMillis

The process timeout in milliseconds. Defaults to 20 minutes.

testClasspath

private final java.lang.String testClasspath

The classpath for the tests.

agentMap

private final java.util.LinkedHashMap<java.nio.file.Path,java.lang.String> agentMap

A map from javaagent jar path to argument string.

replaceCallAgentPath

private java.nio.file.Path replaceCallAgentPath

The path for the replacecall agent.

replaceCallAgentArgs

private java.lang.String replaceCallAgentArgs

The argument string for the replacecall agent.

Constructor Detail

TestEnvironment

public TestEnvironment(java.lang.String testClasspath)

Creates a test environment with the given classpath and an empty agent map.

Parameters:

testClasspath - the class path for running the tests

Method Detail

addAgent

public void addAgent(java.nio.file.Path agentPath,
                     java.lang.String agentArgumentString)

Adds the path for a javaagent jar file to the agent map. These agents will be included in the command in the order they are added.

Parameters:

agentPath - the path to the Javaagent jar file

agentArgumentString - the argument string for the agent

setReplaceCallAgent

public void setReplaceCallAgent(java.nio.file.Path agentPath,
                                java.lang.String agentArgs)

Sets the path and arguments for the replace call agent. This agent has to be placed on the boot classpath.

Parameters:

agentPath - the path for the replacecall agent

agentArgs - the arguments for running the agent

setTimeoutMillis

public void setTimeoutMillis(long timeoutMillis)

Set the test execution timeout.

Parameters:

timeoutMillis - the time in milliseconds that a test is allowed to run before being terminated

runTest

public RunCommand.Status runTest(java.lang.String testClassName,
                                 java.nio.file.Path workingDirectory)
                          throws RunCommand.CommandException

Runs the named JUnit test class in this environment.

Parameters:

testClassName - the fully-qualified JUnit test class name

workingDirectory - the working directory for executing the test

Returns:

the RunCommand.Status object for the execution of the test class

Throws:

RunCommand.CommandException - if there is an error running the test command

commandPrefix

private java.util.List<java.lang.String> commandPrefix()

Constructs the command to run JUnit tests in this environment, minus the name of the test class. Adding the test class name is sufficient to build a runnable command.

Returns:

the base command to run JUnit tests in this environment, without a test class name

getJavaagentOption

private java.lang.String getJavaagentOption(java.nio.file.Path agentPath,
                                            java.lang.String args)