TestFX-DSL

TestFX-DSL aims to bring DSL capabilities on top of TestFX. Inspired by Geb, this DSL enables a fluent interface design on top of the facilities exposed by TestFX.

Instead of writing code such as

clickOn("#showSettingsButton");
JFXDrawer settingsPanel = lookup("#drawer").query();
waitUntil(settingsPanel, isShown(), defaultWaitTimeout());
verifyThat("#username", hasText(defaultUsernameValue));
clickOn("#username").eraseText(defaultUsernameValue.length());
clickOn("#username").write(usernameValue);
verifyThat("#username", hasText(usernameValue));

write it like this

$("#showSettingsButton")
    .click()
.$$("#drawer")
    .waitUntil(isShown(), defaultWaitTimeout())
.$$("#username")
    .verifyThat(hasText(defaultUsernameValue))
    .click()
    .eraseText(defaultUsernameValue.length())
    .write(usernameValue)
    .verifyThat(hasText(usernameValue));

The DSL allows you to chain method calls and remember the last NodeQuery made. It’s easy to get started, just add the following import statement to your test case:

import static org.kordamp.testfx.QueryChain.$;

Installing

You can get the latest version of TestFX-DSL directly from Bintray’s JCenter repository.

Gradle

testCompile 'org.kordamp.testfx:testfx-dsl:0.1.0

Maven

<dependency>
    <groupId>org.kordamp.testfxgroupId>
    <artifactId>testfx-dslartifactId>
    <artifactId>0.1.0artifactId>
    <scope>testscope>
dependency>

<repositories>
    <repository>
        <id>jcenterid>
        <url>http://jcenter.bintray.com/url>
    repository>
repositories>

Building

You must meet the following requirements:

JDK8u60 as a minimum
Gradle 2.14

You may used the included gradle wrapper script if you don’t have gradle installed.

Installing Gradle

Manual

Download Gradle from http://gradle.org/downloads
Unzip the file into a directory without spaces (recommended).
Create a GRADLE_HOME environment variable that points to this directory.
Adjust your PATH environment variable to include $GRADLE_HOME/bin (%GRADLE_HOME%\bin on Windows).
Test your setup by invoking gradle --version.

SDKMAN

Follow the instructions found at http://sdkman.io/ to install SDKMAN.
You need a POSIX environment if running Windows. We recommend using Babun Shell (http://babun.github.io/)
Once SDKMAN is installed invoke sdk install gradle 2.14.
Test your setup by invoking gradle --version.

Gdub

GDub is a wrapper script that facilitates invoking gradle tasks anywhere within a Gradle project. It’s smart enough to use the gradle wrapper if available or your global gradle command. This is an optional download.