org.inferred.testing.behavior

Class TestBuilder

java.lang.Object

org.inferred.testing.behavior.TestBuilder

public class TestBuilder
extends Object

Simple builder API for a test method, suitable for use in BehaviorTester. See the JavaDoc on that class for an example.

Automatically imports Assert.* and Truth.assertThat(T).

Does some ugly things to get meaningful file names and line numbers in the generated source. If you invoke build() directly from your test method, the generated class name and method name should line up with your test. Additionally, if you invoke addLine() directly from your test method, without loops, the line numbers should line up with your test in Eclipse. (Specifically, if you invoke addLine with line numbers that increase monotonically, and do not include extra newlines in your code strings, then the test builder will be able to generate a source file with those lines at the same line numbers.) Sadly, javac does not appear to produce such specific line numbers when faced with a fluent API.

Note that there is no incorrect way to use the class; you will just find compiler error messages and assertion stack traces are more useful when your test code is simple.

Constructor Summary

Constructors

Constructor and Description
TestBuilder()

Method Summary

Methods

Modifier and Type	Method and Description
TestBuilder	addImport(Class<?> cls)
TestBuilder	addImport(String cls)
TestBuilder	addLine(String fmt, Object... args) Appends a formatted line of code to the source.
TestBuilder	addStaticImport(Class<?> cls, String method)
TestBuilder	addStaticImport(String cls, String method)
JavaFileObject	build() Returns a JavaFileObject for the test source added to the builder.

Methods inherited from class java.lang.Object

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

Constructor Detail

TestBuilder

public TestBuilder()

Method Detail

addStaticImport

public TestBuilder addStaticImport(Class<?> cls,
                          String method)

addStaticImport

public TestBuilder addStaticImport(String cls,
                          String method)

addImport

public TestBuilder addImport(Class<?> cls)

addImport

public TestBuilder addImport(String cls)

addLine

public TestBuilder addLine(String fmt,
                  Object... args)

Appends a formatted line of code to the source. Formatting is done by String.format(java.lang.String, java.lang.Object...), except that Class instances use their entity's name unadorned, rather than the usual toString implementation.

build

public JavaFileObject build()

Returns a JavaFileObject for the test source added to the builder.