seriybg / junit-easy-tools Goto Github PK

View Code? Open in Web Editor NEW

2.0 3.0 0.0 114 KB

JUnit 4 extensions

License: MIT License

Java 100.00%

junit junit4 junit-runner property-based-testing

junit-easy-tools's Introduction

junit-easy-tools

Extensions for JUnit4

@DataProducer

Provides lazy calculated parameters inserted to test method.

Example

Simple example

The value of stringProducer will be calculated and injected to the testMethod(String string)

@DataProducer
public static Supplier<String> stringProducer = () -> RandomStringProvider.get();

@Test
public void testMethod(String string) {
   ...
}

Example with iterations

The testMethod(String string) will run three times (@ProducedValues(iterations = 3)). Each run the value of stringProducer will be recalculated, so the new value will be provided.

@DataProducer
public static Supplier<String> stringProducer = () -> RandomStringProvider.get();

@Test
@ProducedValues(iterations = 3)
public void testMethod(String string) {
   ...
}

Named @DataProducer

To testMethod(@ProducedValue(producer = "calculated") String string) will be injected values from calculatedProducer. If no name is specified for @DataProducer, the field name will be considered as @DataProducer name.

@DataProducer
public static Supplier<String> randomProducer = () -> RandomStringProvider.get();

@DataProducer(name = "calculated")
public static Supplier<String> calculatedProducer = () -> CalculatedStringProvider.get();

@Test
public void testMethod(@ProducedValue(producer = "calculated") String string) {
   ...
}

Multiple @DataProducer of the same type

Method test(String s) will be executed twice. The first time value from random @DataProducer will be injected. The second time value from queue @DataProducer will be injected.

@DataProducer
public static Supplier<String> random = () -> RandomStringProvider.get();

@DataProducer
public static Supplier<String> queue = () -> StringQueue.next();
 
@Test
public void test(String s) {
    ...
}

Multiple @DataProducer of the same type and iterations

Method test(String s) will be executed six times. Three iterations with each @DataProducer.

@DataProducer
public static Supplier<String> random = () -> RandomStringProvider.get();

@DataProducer
public static Supplier<String> queue = () -> StringQueue.next();

@Test
@ProducedValues(iterations = 3)
public void test(String s) {
    ...
}

junit-easy-tools's People

Contributors

Stargazers

Watchers

junit-easy-tools's Issues

Update mockito version to the latest one

https://www.versioneye.com/user/projects/58bbf75f2ff683004468cc9f?utm_medium=email&utm_source=project_notifications

Add the possibility to specify @DataProducer for each parameter by name

Add Travis CI build job

Support of @DataProducer methods that returns collection of certain type

Should support:

@DataProducer
public static List<String> dataProducer() {
...
}

for test method:

@Test
public void test(String s) {
...
}

Add feature to repeat tests that runs with JUnitDataProducer

Some annotation on the test method should make the test repeat it's execution as many time as is set it annotation parameter. Value injected to the test should be recalculate each time.
Example:

@Test
@Repeat(3)
public void testMethod(int i){
   ...
}

Add mutation test coverage

http://pitest.org/quickstart/maven/

Handle null as a parameter for @ProducerValues/@ProducerValue

Like a JUnit @theory, there should be a parameter in annotation that tells if null are acceptable

Support multiple @TestFactory method

Add static code ananlysis

Check out Qulice

Bug with iterating tests run when more that one DataProducers satisfy the type

Looks like if we have two data producers of the same type, when using iteration over the tests method, only one DataProducer is used

the following code fails

    private static final Queue<String> valuesWithNulls = new LinkedList<>();

    @DataProducer
    public static Supplier<String> producerWithNulls = valuesWithNulls::poll;

    @DataProducer
    public static Supplier<String> onlyNullSupplier = () -> null;

    @Before
    public void fillValues() throws Exception {
        valuesWithNulls.add("firstString");
        valuesWithNulls.add(null);
        valuesWithNulls.add("thirdOne");
        valuesWithNulls.add(null);
    }

    @Test
    @ProducedValues(nullsAccepted = false, iterations = 4)
    public void shouldNotAcceptNulls(String value) throws Exception {
        assertThat(value).isNotNull();
    }

Rename Test classes to following the convention: [ClassName][Description]Test

Add @TestFactory feature

TestNG-like @factory feature

Support @TestFactory to return multiple values

Array
Collection
Stream

Fix codacy issues

Add varargs support for @DataProducer

Create JavaDoc

Using: http://www.javadoc.io/

Extend documentation

Multiple @DataProducer of the same type:

@DataProducer
public static Supplier<String> first = () -> "first";

@DataProducer
public static Supplier<String> second = () -> "second";

@Test
//@ProducerValues(iterations = 2) -> in this case test method will be executed 4 time (2 times for each supplier)
public void test(String s) {
    //Will be executed twice with both provided value from first and second suppliers
}

@DataProducer
public static IntSupplier s1 = () -> 42;

@DataProducer
public static IntSupplier s2 = () -> 27;

public void testM(int i) {
}

testM should run 2 times with values from both producers inserted.