org.checkerframework.framework.test

Class TestConfigurationBuilder

java.lang.Object

org.checkerframework.framework.test.TestConfigurationBuilder

public class TestConfigurationBuilder
extends java.lang.Object

Used to create an instance of TestConfiguration, TestConfigurationBuilder follows the standard builder pattern. That is, it returns itself after every call so you can string together configuration methods as follows:

new TestConfigurationBuilder() .addOption("-Awarns") .addSourceFile("src1.java") .addDiagnosticFile("src1.out")

See Also:

TestConfiguration

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TESTS_OUTPUTDIR

Constructor Summary

Constructors

Constructor and Description
TestConfigurationBuilder() Note: There are static helper methods named buildConfiguration and buildConfigurationBuilder that can be used to create the most common types of configurations
TestConfigurationBuilder(TestConfiguration initialConfig) Create a builder that has all of the optoins in initialConfig

Method Summary

Modifier and Type	Method and Description
TestConfigurationBuilder	addDiagnosticFile(java.io.File diagnostics)
TestConfigurationBuilder	addDiagnosticFiles(java.lang.Iterable<java.io.File> diagnostics)
TestConfigurationBuilder	adddToPathOption(java.lang.String key, java.lang.String toAppend)
TestConfigurationBuilder	addOption(java.lang.String option)
TestConfigurationBuilder	addOption(java.lang.String option, java.lang.String value)
TestConfigurationBuilder	addOptionIfValueNonEmpty(java.lang.String option, java.lang.String value)
TestConfigurationBuilder	addOptions(java.lang.Iterable<java.lang.String> newOptions)
TestConfigurationBuilder	addOptions(java.util.Map<java.lang.String,java.lang.String> options)
TestConfigurationBuilder	addProcessor(java.lang.String processor)
TestConfigurationBuilder	addProcessors(java.lang.Iterable<java.lang.String> processors)
TestConfigurationBuilder	addSourceFile(java.io.File sourceFile)
TestConfigurationBuilder	addSourceFiles(java.lang.Iterable<java.io.File> sourceFiles)
TestConfiguration	build() Creates a TestConfiguration using the settings in this builder.
static TestConfiguration	buildDefaultConfiguration(java.lang.String testSourcePath, java.io.File testFile, java.lang.String checkerName, java.util.List<java.lang.String> options, boolean shouldEmitDebugInfo) This is the default configuration used by Checker Framework JUnit tests.
static TestConfiguration	buildDefaultConfiguration(java.lang.String testSourcePath, java.lang.Iterable<java.io.File> testSourceFiles, java.lang.Iterable<java.lang.String> processors, java.util.List<java.lang.String> options, boolean shouldEmitDebugInfo) This is the default configuration used by Checker Framework JUnit tests.
TestConfigurationBuilder	dontEmitDebugInfo()
TestConfigurationBuilder	emitDebugInfo()
java.util.List<java.lang.String>	flatOptions()
static java.lang.String	getDefaultClassPath()
static TestConfigurationBuilder	getDefaultConfigurationBuilder(java.lang.String testSourcePath, java.io.File outputClassDirectory, java.lang.String classPath, java.lang.Iterable<java.io.File> testSourceFiles, java.lang.Iterable<java.lang.String> processors, java.util.List<java.lang.String> options, boolean shouldEmitDebugInfo) This creates a builder for the default configuration used by Checker Framework JUnit tests.
static java.lang.String	getJdkJarPathFromProperty() Uses the system property "JDK_JAR" to find the annotated JDK
static java.io.File	getOutputDirFromProperty()
TestConfigurationBuilder	setDiagnosticFiles(java.util.List<java.io.File> diagnosticFiles)
TestConfigurationBuilder	setOptions(java.util.Map<java.lang.String,java.lang.String> options)
TestConfigurationBuilder	setProcessors(java.lang.Iterable<java.lang.String> processors)
TestConfigurationBuilder	setShouldEmitDebugInfo(boolean shouldEmitDebugInfo)
TestConfigurationBuilder	setSourceFiles(java.util.List<java.io.File> sourceFiles)
java.lang.String	toString()
java.util.List<java.lang.String>	validate(boolean requireProcessors) Ensures that the minimum requirements for running a test are met.
TestConfiguration	validateThenBuild(boolean requireProcessors) Creates a TestConfiguration using the settings in this builder.

Methods inherited from class java.lang.Object

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

Field Detail

TESTS_OUTPUTDIR

public static final java.lang.String TESTS_OUTPUTDIR

See Also:

Constant Field Values

Constructor Detail

TestConfigurationBuilder

public TestConfigurationBuilder()

Note: There are static helper methods named buildConfiguration and buildConfigurationBuilder that can be used to create the most common types of configurations

TestConfigurationBuilder

public TestConfigurationBuilder(TestConfiguration initialConfig)

Create a builder that has all of the optoins in initialConfig

Method Detail

getDefaultConfigurationBuilder

public static TestConfigurationBuilder getDefaultConfigurationBuilder(java.lang.String testSourcePath,
                                                                      java.io.File outputClassDirectory,
                                                                      java.lang.String classPath,
                                                                      java.lang.Iterable<java.io.File> testSourceFiles,
                                                                      java.lang.Iterable<java.lang.String> processors,
                                                                      java.util.List<java.lang.String> options,
                                                                      boolean shouldEmitDebugInfo)

This creates a builder for the default configuration used by Checker Framework JUnit tests.

Parameters:

testSourcePath - the path to the Checker test file sources, usually this is the directory of Checker's tests

outputClassDirectory - the directory to place classes compiled for testing

classPath - the classpath to use for compilation

testSourceFiles - the Java files that compose the test

processors - the checkers or other annotation processors to run over the testSourceFiles

options - the options to the compiler/processors

shouldEmitDebugInfo - whether or not debug information should be emitted

Returns:

the builder that will create an immutable test configuration

buildDefaultConfiguration

public static TestConfiguration buildDefaultConfiguration(java.lang.String testSourcePath,
                                                          java.lang.Iterable<java.io.File> testSourceFiles,
                                                          java.lang.Iterable<java.lang.String> processors,
                                                          java.util.List<java.lang.String> options,
                                                          boolean shouldEmitDebugInfo)

This is the default configuration used by Checker Framework JUnit tests.

Parameters:

testSourcePath - the path to the Checker test file sources, usually this is the directory of Checker's tests

testSourceFiles - the Java files that compose the test

processors - the checkers or other annotation processors to run over the testSourceFiles

options - the options to the compiler/processors

shouldEmitDebugInfo - whether or not debug information should be emitted

Returns:

a TestConfiguration with input parameters added plus the normal default options, compiler, and file manager used by Checker Framework tests

buildDefaultConfiguration

public static TestConfiguration buildDefaultConfiguration(java.lang.String testSourcePath,
                                                          java.io.File testFile,
                                                          java.lang.String checkerName,
                                                          java.util.List<java.lang.String> options,
                                                          boolean shouldEmitDebugInfo)

This is the default configuration used by Checker Framework JUnit tests.

Parameters:

testSourcePath - the path to the Checker test file sources, usually this is the directory of Checker's tests

testFile - a single test java file to compile

checkerName - a single Checker to include in the processors field

options - the options to the compiler/processors

shouldEmitDebugInfo - whether or not debug information should be emitted

Returns:

a TestConfiguration with input parameters added plus the normal default options, compiler, and file manager used by Checker Framework tests

validate

public java.util.List<java.lang.String> validate(boolean requireProcessors)

Ensures that the minimum requirements for running a test are met. These requirements are:

• There is at least one source file
• There is at least one processor (if requireProcessors has been set to true)
• There is an output directory specified for class files
• There is no -processor option in the optionMap (it should be added by addProcessor instead)

Parameters:

requireProcessors - whether or not to require that there is at least one processor

Returns:

a list of errors found while validating this configuration

adddToPathOption

public TestConfigurationBuilder adddToPathOption(java.lang.String key,
                                                 java.lang.String toAppend)

addDiagnosticFile

public TestConfigurationBuilder addDiagnosticFile(java.io.File diagnostics)

addDiagnosticFiles

public TestConfigurationBuilder addDiagnosticFiles(java.lang.Iterable<java.io.File> diagnostics)

setDiagnosticFiles

public TestConfigurationBuilder setDiagnosticFiles(java.util.List<java.io.File> diagnosticFiles)

addSourceFile

public TestConfigurationBuilder addSourceFile(java.io.File sourceFile)

addSourceFiles

public TestConfigurationBuilder addSourceFiles(java.lang.Iterable<java.io.File> sourceFiles)

setSourceFiles

public TestConfigurationBuilder setSourceFiles(java.util.List<java.io.File> sourceFiles)

setOptions

public TestConfigurationBuilder setOptions(java.util.Map<java.lang.String,java.lang.String> options)

addOption

public TestConfigurationBuilder addOption(java.lang.String option)

addOption

public TestConfigurationBuilder addOption(java.lang.String option,
                                          java.lang.String value)

addOptionIfValueNonEmpty

public TestConfigurationBuilder addOptionIfValueNonEmpty(java.lang.String option,
                                                         java.lang.String value)

addOptions

public TestConfigurationBuilder addOptions(java.util.Map<java.lang.String,java.lang.String> options)

addOptions

public TestConfigurationBuilder addOptions(java.lang.Iterable<java.lang.String> newOptions)

setProcessors

public TestConfigurationBuilder setProcessors(java.lang.Iterable<java.lang.String> processors)

addProcessor

public TestConfigurationBuilder addProcessor(java.lang.String processor)

addProcessors

public TestConfigurationBuilder addProcessors(java.lang.Iterable<java.lang.String> processors)

emitDebugInfo

public TestConfigurationBuilder emitDebugInfo()

dontEmitDebugInfo

public TestConfigurationBuilder dontEmitDebugInfo()

setShouldEmitDebugInfo

public TestConfigurationBuilder setShouldEmitDebugInfo(boolean shouldEmitDebugInfo)

build

public TestConfiguration build()

Creates a TestConfiguration using the settings in this builder. The settings are NOT validated first

validateThenBuild

public TestConfiguration validateThenBuild(boolean requireProcessors)

Creates a TestConfiguration using the settings in this builder. The settings are first validated and a runtime exception is thrown if any errors are found

Parameters:

requireProcessors - whether or not there should be at least 1 processor specified, see method validate

flatOptions

public java.util.List<java.lang.String> flatOptions()

Returns:

the set of Javac options as a flat list

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getOutputDirFromProperty

public static java.io.File getOutputDirFromProperty()

getDefaultClassPath

public static java.lang.String getDefaultClassPath()

getJdkJarPathFromProperty

public static java.lang.String getJdkJarPathFromProperty()

Uses the system property "JDK_JAR" to find the annotated JDK