AssertJ Swing

AssertJ Swing is a Java library that provides a fluent interface for functional Swing UI testing.

AssertJ Swing is based on JDK standard types assertions and can be used with either JUnit or TestNG.

Different AssertJ Swing major versions depend on different Java versions:

• AssertJ Swing 3.x requires Java 8 or higher
• AssertJ Swing 2.x requires Java 7 or higher
• AssertJ Swing 1.x requires Java 6 or higher

Features of AssertJ Swing

• Simulation of user interaction with a GUI (e.g. drag 'n drop)
• Reliable GUI component lookup (by type, by name or custom search criteria)
• Support for all Swing components included in the JDK
• Compact and powerful API for creation and maintenance of functional GUI tests
• Supports Applet testing
• Ability to embed screenshots of failed GUI tests in HTML test reports
• Can be used with either TestNG or JUnit
• Supports testing violations of Swing's threading rules
• Can be used with JIDE Software (since 1.1.0)

Getting started

To get quickly started, just have a look at our one minute starting guide.

If you have a bit more time, start with our getting started guide.

Why have I forked Fest Swing?

AssertJ Swing is a fork of FEST Swing, a great project I have used for five years and that Joel has contributed to during 3 years, so why have I forked it?

Well the main reason is, FEST Swing isn't really being continued. On 10th September, 2012 Alex announced that he stopped development and that Yvonne is going to continue FEST Swing. Unfortunately except February and March of 2013 there were no further commit activities on FEST Swing.

I think even if some developers declare Swing as dead, FEST Swing is still used a lot and the development should continue. Not only support for the next Java releases should be ensured. But there are also a lot of issues that would improve FEST Swing. Therefore we added AssertJ Swing to the AssertJ suite.

If you feel that something is missing, please file a ticket or even better make a contribution!

Joel Costigliola (AssertJ creator) and Christian Rösch (maintainer of AssertJ Swing)

Code and issue tracker

AssertJ Swing is hosted on github: https://github.com/joel-costigliola/assertj-swing.

Please report bugs or missing features in AssertJ Swing issue tracker.

Contributing to AssertJ Swing

You are very welcome to contribute, we really want to offer the richer and easy to use Swing testing API, so ideas from our users are very appreciated.

Contributing is easy and we try to help people contributing, have a look at the contributor guidelines (these are the same guidelines shown when you create a new issue).

Special thanks to all assertj-swing contributors:

• stefanmahler
• ingokegel

Thanks

AssertJ Swing has its roots in FEST Swing, a project I have used for 5 years, so thanks to Alex Ruiz FEST's creator!

This documentation is based on the large documentation of FEST Swing. So thanks a lot to all the original authors!