JUnit Pioneer

A melting pot for all kinds of extensions to JUnit 5, particular to its Jupiter API.

Check out junit-pioneer.org, particularly the documentation section.

A Pioneer's Mission

JUnit Pioneer provides extensions for JUnit 5 and its Jupiter API. It does not limit itself to proven ideas with wide application but is purposely open to experiments. It aims to spin off successful and cohesive portions into sibling projects or back into the JUnit 5 code base.

To enable easy exchange of code with JUnit 5, JUnit Pioneer copies most of its infrastructure, from code style to build tool and configuration to continuous integration.

Getting on Board

There were no releases to Maven Central, yet, but every successful build on master releases a snapshot to Sonatype's snapshot repository.

Coordinates:

• group ID: org.junit-pioneer
• artifact ID: junit-pioneer
• version 0.1-SNAPSHOT

For Maven:

<dependency>
	<groupId>org.junit-pioneer</groupId>
	<artifactId>junit-pioneer</artifactId>
	<version>0.1-SNAPSHOT</version>
</dependency>

For Gradle:

testCompile group: 'org.junit-pioneer', name: 'junit-pioneer', version: '0.1-SNAPSHOT'

Contributing

We welcome contributions of all shapes and forms! 🌞

• If you have an idea for an extension, open an issue and let's discuss.
• If you want to help but don't know how, have a look at the existing issues, particularly unassigned ones and those marked as up for grabs.

Before contributing, please read the contribution guide.

Project Structure

Dependencies

To not add to user's JAR hell, JUnit Pioneer is not taking on any runtime dependencies besides JUnit 5. For our own infrastructure, we rely on the following compile and test dependencies:

• JSR-305 (for static analysis)
• AssertJ (for our tests)
• Mockito (for our tests)

Code Style

There shall be no null - use Optional instead.:

• design code to avoid optionality wherever feasibly possible
• in all remaining cases, prefer Optional over null.