Test Repository instructions

Test tool & command

Tests will be run using the command ./gradlew clean test.

Project structure

Make sure that the package structure of your test classes is equivalent to the package structure of your base and solution repository. Otherwise, during the test run Gradle will not be able to find the imported classes in your test files.

In order to use classes from the template or solution repository in a test case, you have to add the respective repository files as a dependency to the test project. Follow this description for IntelliJ:

1. Open the Test-Project first
2. Select File -> New -> Module from Existing Source. Then choose the template project root folder. Select the option Import module from external model and Gradle and press Finish.
3. Repeat the previous step for the Solution-Project.
4. Uncomment and edit the following line in settings.gradle within the Test-Project: includeBuild('/path/to/repository-exercise') or includeBuild('/path/to/repository-solution') depending on which project you want to use the source files for executing the test cases. The path can be given relative to the test project directory (e.g., ../repository-solution).
5. Inside the dependencies-block in the build.gradle inside the Test-Project, uncomment one of the lines: testImplementation(':test1') or testImplementation(':test1-Solution') depending on which project you want to use the source files for executing the test cases.
6. Change the assignmentSrcDir variable in build.gradle to the corresponding src/ directory within the template or solution repository (e.g., ../repository-solution/src/).

Note: The described changes to the build.gradle and settings.gradle files must not be pushed to the remote repository as they can only be used for editing all three projects in the local IDE.

Sequential test runs

In case you have enabled sequential test runs when creating the exercise a special folder structure of the test repository is used to differentiate structural and behavior tests:

1. Structural test files must be placed in the folder structural.
2. Behavior test files must be placed in the folder behavior.

Files in other folders will not be executed!

Static Code Analysis

The build.gradle contains dependencies for the execution of static code analysis, if the option is active for this programming exercise.