SwingSet2.Tests

Integration Tests for SwingSet2

Prerequisites

Install jdk8u151
Download Demos and Samples for that jdk. We''ll need a SwingSet2.jar which is located at jdk1.8.0_151/demo/jfc/SwingSet2

Build (build task)

Open a Shell and navigate to the project root (e.g. SwingSet2.Tests)

run command:

- Mac:     ./gradlew build

- Windows: gradlew.bat build

Running Integration Tests (integrationTest task)

You can just run this task, because it will trigger the "build" task in the process

Put an app jar (SwingSet2.jar) into the "sut" directory in the project root(e.g. SwingSet2.Tests/sut). If you use Mac, make sure that you allow SwingSet2.jar to be launched! (Try to load it. If you recieve a message from the system, prohibiting you to launch it, go to System Preferences -> Security and Privacy -> Click to open anyway)
Open a Shell and navigate to the project root (e.g. SwingSet2.Tests)

Run command:

- Mac:     ./gradlew integrationTest

- Windows: gradlew.bat integrationTest

Don't touch the mouse and the keyboard for the duration of a test run.

Configuring

There are two configuration points in the project: config and specifications.

Config

Responsible for defining our test process. It allows us to change different timeouts(for finding elements, executing tests, disposing the app), delay between the events, whether to use system look & feel as default or use cross-platform one instead and etc. We can define different values for the platforms. If you have a slow machine, try tweaking timeout values in config.

mac.sutStartClass=SwingSet2Applet
mac.elementTimeout=1000
mac.testTimeout=15000
mac.disposeTimeout=3000
mac.specifications=mac:java:motif:nimbus
mac.delayBetweenEvents=10
mac.systemLook=true
mac.configuration=Basic

windows.sutStartClass=SwingSet2Applet
windows.elementTimeout=3000
windows.testTimeout=25000
windows.disposeTimeout=3000
windows.specifications=windows:java:motif:nimbus
windows.delayBetweenEvents=200
windows.systemLook=true
windows.configuration=Basic

Config is defined in SwingSet2.Tests/src/main/resources/config.properties

Specifications

Responsible for defining the test behaviour. Here I store all the relative values for tests, so they can be easily interchanged. We must always have a default specification. If we define a custom one, and a test is set to use it, first it's going to look for a desired property in custom specification. In case the test couldn't find property in custom specification, it will look for it in the default one. Custom specifications are useful for describing values that may vary depending on an app's state (e.g. Look & Feel of SwingSet2). Each property name must start with a prefix, the specification name. For example, property in default specification must start with "default", separated from the property name with a dot(.).

default.tableDemo.imageColumn=Favorite Food
default.tableDemo.firstImage=images/ImageClub/food/apple.jpg
default.tableDemo.lastImage=images/ImageClub/food/watermelon.jpg

default.tableDemo.inputDouble=0x1.fffffffffffffP+1042
default.tableDemo.inputDoubleExpected=Infinity

default.tableDemo.inputColor=Black
default.tableDemo.inputColorExpected=0:0:0

default.tableDemo.initialReordering=true
default.tableDemo.initialHorizLines=true
default.tableDemo.initialVertLines=true
default.tableDemo.initialRowSelection=true
default.tableDemo.initialColumnSelection=false
default.tableDemo.initialIntercellSpacing=1
default.tableDemo.initialRowHeight=33
default.tableDemo.initialSelectMode=Multiple ranges
default.tableDemo.initialResizeMode=Subsequent columns

default.menu.lookAndFeelMenu=Look & Feel

mac.menu.lookAndFeel=Mac OS X Look & Feel
mac.tableDemo.selectionColor=9:80:208
mac.tableDemo.gridColor=255:255:255
mac.tableDemo.showGrid=true

windows.menu.lookAndFeel=Windows Style Look & Feel
windows.tableDemo.selectionColor=0:120:215
windows.tableDemo.gridColor=128:128:128
windows.tableDemo.showGrid=true

java.menu.lookAndFeel=Java Look & Feel
java.tableDemo.selectionColor=184:207:229
java.tableDemo.gridColor=122:138:153
java.tableDemo.showGrid=true

Specifications are defined in SwingSet2.Tests/src/main/resources/specifications.properties

IntelliJ IDEA

.idea folder is in repository, so you can just open the project. But, after you open the project and it loads fully, you need to discard any changes IDEA made to the project in git. This is necessary because IDEA overrides project files and removes module-library dependency on SUT directory. After discarding, IDEA will recognize the directory and you will be able to use the junit runner in the idea to run tests. If you don't reset changes, you'll have to add app dependancy on sut directory in Project Settings manually in order to run tests with the embedded runner.

northern-byte/SwingSet2.Tests