QuickStart

justify-quickstart

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

Step 1 – JDK and IDE (Eclipse) Installation

a. Download and install the current Java 8 SE Development Kit .

b. 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\oxygen
Mac: /Applications/eclipse/oxygen

Step 2 – Launch Eclipse

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

PC: C:\project\quickstart
Mac: /project/quickstart

Step 3 – Proxy Server

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

Step 4 –  PerspectivesRequired for Instructor Guided Training

  • Deselect the “Always show Welcome at start up”
  • Close the “Welcome” page
  • In the upper-right corner, right-click and “close” the Java EE “Perspective”
  • Ensure the “Java” perspective is active from Window / Perspective / Open Perspective / [Other…] / Java

Step 5 – ViewsRequired for Instructor Guided Training

Consider closing the “Task List”, “Outline” and “Declaration” Views. These views can remain open: 

  • Javadoc (bottom-right)
  • Package Explorer (upper-left)
  • Problems (bottom-right)

These additional Views (within the Java perspective) may be opened from Window / Show View / Other…

  • Console (bottom-right)
  • JUnit (move to bottom-left creating a new window)
    • Consider using Layout / Vertical

Step 6 – Download the QuickStart Project

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

PC: C:\project\quickstart\justify-quickstart
Mac: /project/quickstart/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 “Existing Gradle Project” and pressing Next and Next again.

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

Select the “Gradle wrapper” option.  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 fluent “Rules” for configuration and powerful “Assertions” for verification. 

References

[1] https://github.com/gtcGroup/justify-quickstart/blob/master/justify-quickstart.zip