A ready-to-use bootstrap Java project backed by gradle, TestNG, Mockito, FEST-Assert 2 and Cobertura for Eclipse and IntelliJ IDEA, with support for Jenkins CI.
- Gradle version 1.9 -- build tool
- TestNG version 6.8.x -- unit testing framework
- Mockito version 1.9.x -- mocking framework
- FEST-Assert 2 version 2.0M10 -- fluent interface for assertions that allows you to write assertions that read more like natural language (unfortunately Java lacks something like the awesome ScalaTest framework)
- Cobertura plugin for Gradle -- allows Gradle to generate Cobertura compatible test reports (mostly used for integrating test results with Jenkins)
Packages only used for showcasing the functionality:
- Google Guava -- solely used to show how compile-time dependencies are configured in Gradle
The latest dependency information is always available in build.gradle.
We have two complimentary goals:
- You should be able to use Eclipse as the IDE of choice to work with the code (e.g. run the build and tests locally on your machine).
- You should be able to integrate the code with the Jenkins continuous integration server (e.g. to let it run the build and tests for your team and publish the test results).
The first goal covers your personal workflow as a software engineer with the code. The second goal covers integrating the code with the your engineering team as a whole.
- Download the bootstrap project as described below.
- Configure IntelliJ IDEA or Eclipse (optional).
- Configure Jenkins CI server (optional).
- Hack away!
You have the following two options to start your own project with the bootstrap project.
If you don't have a GitHub account, the simplest way is to just clone (i.e. checkout) the original bootstrap project. The only requirement is a local installation of git on your machine.
$ git clone git://github.com/miguno/gradle-testng-mockito-bootstrap.git
Now you can start hacking away!
$ cd gradle-testng-mockito-bootstrap
# ...start coding...
If you do have a GitHub account, I recommend that you fork the bootstrap project. Then start writing your own code against your personal fork.
First, open the bootstrap project on GitHub and fork it. Then clone (i.e. checkout) your personal fork.
$ git clone git@github.com:YOURUSERNAME/gradle-testng-mockito-bootstrap.git
Note: Make sure to replace YOURUSERNAME
in the git URL above with the name of your GitHub user account.
Now you can start hacking away!
$ cd gradle-testng-mockito-bootstrap
# ...start coding...
The bootstrap project ships with only two classes:
- BobRoss.java -- A simple class that implements a few features that we can write unit tests for. We pretend to be the late painting instructor Bob Ross who, well, is painting a picture with us.
- BobRossTest.java -- This class tests the former class. It illustrates the use of TestNG, Mockito and FEST-Assert 2 to write these unit tests. Don't pay too much attention to the semantics of the actual tests, we're just showcasing here.
The bootstrap project is a normal gradle project. Have a look at the
gradle documentation what this allows you to do. I will only list the most
important commands here. If you want to see what gradle tasks are available out of the box in the bootstrap project,
run gradle tasks
.
# General commands
$ ./gradlew clean # deletes the build directory
$ ./gradlew test # runs the unit tests (and compile before if needed)
$ ./gradlew build # assembles and tests this project
$ ./gradlew cobertura # generates code coverage report
# Eclipse related
$ ./gradlew cleanEclipse # cleans all Eclipse files
$ ./gradlew eclipse # generates all Eclipse files
# IntelliJ IDEA related
$ ./gradlew cleanIdea # cleans all IntelliJ files
$ ./gradlew idea # generates all IntelliJ files
By default, executing the commands above will create output in the following locations:
build/
-- this sub-directory is used by Gradlebuild/reports/cobertura/coverage.xml
-- Cobertura test coverage report in XML format- Jenkins: Add a post-build action Publish Cobertura Coverage Report with "Cobertura xml report pattern" set to
**/build/reports/cobertura/coverage.xml
.
- Jenkins: Add a post-build action Publish Cobertura Coverage Report with "Cobertura xml report pattern" set to
build/reports/tests/index.html
-- TestNG Results in HTML formatbuild/test-results/*.xml
-- TestNG Results in JUnit XML format- Jenkins: Add a post-build action Publish JUnit test result report with "Test report XMLs" set to
**/build/test-results/*.xml
.
- Jenkins: Add a post-build action Publish JUnit test result report with "Test report XMLs" set to
bin/
-- this sub-directory is used by Eclipse
Feel free to browse the directory tree to find additional files that you might need.
See Bootstrapping a Java project with Gradle, TestNG, Mockito and Cobertura for Eclipse and Jenkins for more information including screenshots.
If you come up with any improvements, feel free send me a pull request.