Kotlin Test data Helper

This plugin introduces some nice features to make working with compiler tests of Kotlin project more cozy.

Main features:

• Separated view for files related to opened testdata file
• Ability to run specific generated test, associated with opened testdata file
• Ability to run all tests associated with opened file
• Ability to run tests from arbitrary modules given the inclusion filters (--tests)

Previews

• Test Data editor

• Split view for files related to opened tests

Setup

Plugin creates enhanced editor for any .kt files which belong to directories listed in plugin settings (they are stored per project in .idea/kotlinTestDataPluginTestDataPaths.xml file)

The plugin assumes that if some test file named someName.kt then all files which start with someName. are considered related to this test, and it shows them in the left combobox for split mode. The plugin can be configured to search for related files in other places (not just in the same directory as the .kt file). This can be useful, for example, for displaying the generated code when working on Kotlin/JS tests.

For detecting test methods for opened file plugin uses following conversion:

• if test file named someName.kt then test method should name testSomeName and marked as test (e.g. using @Test annotation from JUnit)
• test method should be annotated with @org.jetbrains.kotlin.test.TestMetadata annotation which stores filename in its argument (@TestMetadata("someName.kt"))
• class which contains test method also should me marked with @TestMetadata annotation, and path to directory with someName.kt file should be passed to its argument

Plugin searches for all methods in project which satisfy those conditions and creates buttons for running those test methods in right corner of toolbar. Also right panel has two additional buttons:

• Reload button runs detection of test methods again. This can be useful if you add new test method after opening test data file
• Run all button runs gradle command which executes all found test methods

This plugin is hosted in a custom repository, so if you want to receive automatic updates please add this repository to Settings -> Plugins -> Manage Plugin Repositories

https://teamcity.jetbrains.com/guestAuth/app/rest/builds/buildType:(id:Kotlin_KotlinCompilerTestHelper_BuildPlugin),status:success,count:1/artifacts/content/updatePlugins.xml

Running Tests from Arbitrary Modules

The plugin adds a Run Anything provider that introduces a command testGlobally. It accepts a sequence of test filters, finds the relevant modules and then calls their :test Gradle tasks with the relevant filters.

The syntax is: testGlobally [--tests <pattern>]*. For example: testGlobally --tests 'a.b.Test$Sub.testSomething' --tests a.b.*.

There's a limitation, though: the packages must be fully specified, and only their initial part that doesn't contain wildcards will be considered for searching for the relevant modules. Also note that specifying a filter without a package (--tests SomeTestGenerated) will result in all modules with test source sets being called via :test. The algorithm searches for the relevant module by comparing the package with the directory structure, and empty package represents the source set root which is always present for every source set.

Build plugin from sources

./gradlew buildPlugin # -> ./build/distributions/TestHelper-0.0.19.zip