Executable jar file
for the Spest specification checker
Using Spest:
-
Download the jar file to a location of your choice. For lab on
Friday, November 13th, download to team member laptops that run Java 8.
-
Make sure all of the Java files to be checked have compiled correctly with
javac and that the .class files are located somewhere within
your source directory.
-
Invoke the Spest checker from the Desktop icon or with the command line:
java -jar spest.jar
-
In the GUI, navigate to the source root directory for your Java code that has
the classes with formally specified methods.
-
For now, you can leave the 'Test Output Directory' text field empty. (If you
fill it in, make the tests directory that will hold the testing code, as
discussed in Lecture on Friday of Week 8.)
-
At the bottom of the GUI windows are these four buttons:
-
"Select Files" -- this lets you select which files in the Soure Directory to
check.
-
"Validate" -- this runs the Spest validator on the specs
-
"Generate Tests" -- if the specs are valid, this generates unit tests from the
specs; we'll discuss details of this next week
-
"Cancel" -- if the validator or test generator is taking too long, pressing
Cancel will stop it
-
Press the 'Validate' button at the bottom of the UI window.
-
The validation results may take a few seconds to appear in the 'Console Output'
text area.
-
If necessary, scroll to the top of the 'Console Output'.
-
If there are no Spest checking errors, it means your spec validated
successfully.
-
If there are errors, they are reported with a compiler-style message, including
the line and character number where the error occurs.
-
If there's an error you can't figure out how to fix, make a note of it, uncheck
the affected file from the "Select Files" list, and send an email about it to
gfisher@calpoly.edu and cjohns71@calpoly.edu.
-
We appreciate your participation and patience in the development of the Spest
checker and test generator!
