QuickStart

justify-quickstart

This QuickStart guide explores using Justify  modules with a set of sample JUnit tests imported into Eclipse. If you elect to use Justify for your own project see the download page.

Step 1 – JDK and IDE (Eclipse) Installation

Download and install the current Java 8 SE Development Kit .

Download the current version of Eclipse – “Eclipse IDE for Java EE Developers” – from here.  Extract the download to an installation directory similar to the following:

PC: C:\eclipse\neon
Mac: /Applications/eclipse/neon

Step 2 – Launch Eclipse

Launch Eclipse and open a (suggested) work space as follows:

PC: C:\project\justify-module
Mac: /project/justify-module

Step 3 –  PerspectivesRequired for Instructor Guided Training

  • Close the “Welcome” page if applicable
  • Ensure the “Java” perspective is active from Window / Open Perspective / [Other…] / Java

Step 4 – Install Plugins

Note: If you connect through a proxy server you may need to modify Windows / Preferences / General / Network Connections.

Install the following Eclipse plugins from Help / Eclipse Marketplace… using the “Find:” filter.  (You can wait to restart Eclipse until all plugins are installed.)

  • Build Gradle Integration
    • Filter Entry: Buildship
  • EclEmma Java Code Coverage
    • Filter Entry: EclEmma

Step 5 – Organize ViewsRequired for Instructor Guided Training

These Java Perspective Views may be opened from Window / Show View / Other…

  • Console
  • JUnit
  • Package Explorer
  • Problems
  • Gradle Tasks

Step 6 – Download the QuickStart Project

Download the QuickStart project from here [selecting the ‘download’ button] and unzip to the applicable Eclipse workspace folder resulting in:

PC: C:\project\justify-module\justify-quickstart
Mac: /project/justify-module/justify-quickstart

Step 7 – Import using Gradle

Right-click in the Package Explorer view and select Import… — typing “Gradle” in the filter followed by selecting “Gradle Project” and pressing Next and Next again.

Browse to the “justify-quickstart” folder as the “Project root directory” and Next.

Use the “Gradle wrapper”. If the “Java home directory” appears as an Advanced option point to the downloaded JDK. If you point to a JRE the Gradle script will fail.

C:\Program Files\Java\jdk1.8.0_121

Select Next and Finish.

It may take a few minutes for Gradle to initialize the environment; view the lower right-hand corner for activity. Note: You may want to Project / Clean… / Clean all projects.

Step 8 – Run JUnit Tests

Highlight any of the “src/test/java” folders and right-click to “Run As” “JUnit Test”.  If properly configured all tests run GREEN

Step 9 – Explore!

Explore the QuickStart JUnit tests to see how Justify accelerates test creation with “Rules” for configuration and technology specific “Assertions” for verification.