This is a project I wrote for myself to facilitate migrating a good number of tests to JUnit 5 syntax. Feel free to use it/enhance it/etc if you find it useful.
Note that IntelliJ has functionality to migrate from JUnit 4 to 5. I recommend trying that before this program. (This program was written in September 2016 when no IDEs had the functionality).
Before starting out, the program assumes you have:
- Updated your Maven POM/Groovy build file/Gradle/whatever to reference the new JUnit 5 jars
- Migrated off JUnit 3.8. This program assumes you are on JUnit 4. JUnit 3.8 code will continue to work in JUnit 5. (as will JUnit 4 code.) But the goal of this program is to migrate JUnit 4 syntax to JUnit 5 syntax.
- Pass the absolute path of the directory containing your tests (ex /my/dir/src/test/java) when running class jb.Updater.
- Make sure to maven clean install it for the first time and for every time you make changes to the java files.
- Running example) Inside the directory of where you saved the repo, java -jar target/convert-junit4-to-to-junit5-0.0.1-SNAPSHOT.jar ~/git/project/src/test
- The program outputs the name of each file as it goes through them. It runs quickly. Under a few seconds for two thousand files.
- Then make manual edits at end (or rollback those test classes and deal with them later). In particular the following will not compile after running the program and require manual migration.
- Parameterized tests
- Tests that use expected parameter
- Tests that use timeout parameter
This program updates every class and reformats your code. This is a side effect of using Java Parser. If you have a standard coding format, you can always reapply it after running. Regardless, make sure to commit your code before running the program so this commit only has the refactoring to JUnit 5.
- The program can be run multiple times. That way you can rollback the classes that require manual intervention and commit the others. Then later when you re-run, it will only update the remaining classes.