PGdP 22/23 - Tests

This is a repository to collect JUnit Tests for PGdP exercises at TUM in WS22/23. These tests have been written by students for students and are not part of the official course.

Table of Contents

1. Legal Status
2. Usage
3. How to Contribute
4. Contributors
5. Helpful Links
6. Contact

1. Legal Status

Es ist alles erlaubt, was die Lösung nicht verrät.

The so-called Übungsleitung will have an eye on this repository. But as long as the tests do not reveal the solution of the homework, this repository will tolerate them. To ensure the solution is not getting revealed, the tests should be Input/Output-Tests only.

Furthermore, there is no guarantee of the correctness of the tests. Neither the Übungsleitung nor any of the other tutors will contribute own tests. We (Maximilian Anzinger, Johannes Stöhr, Georg Henning, Konrad Gößmann, Robin Marchart, Oliver Specht, and Anton Kluge) will just make shure that there are no tests that reveal the solution. It is your own responsibility to validate the correctness and if necessary report bugs or even provide/contribute a fix for your fellow student.

Examples

correct:

// Test Area calculation
// Arrange
Rectangle r1 = new Rectangle(length: 4, width: 4)
// Act & Assert
assertEquals(16, r1.calculateArea());

wrong!:

// Test Area calculation
// Arrange
Rectangle r1 = new Rectangle(length: 4, width: 6)
// Act & Assert
// Calculate using length * width             // <-- reveales the solution
assertEquals(4*6, r1.calculateArea()); // <-- reveales the solution

2. Usage

Clone this repository

git clone https://github.com/MaximilianAnzinger/pgdp2223-tests.git

Check for updates
```
git pull
```
copy the files in the test directory to the root of your repository and not inside your src folder

Or use the syslink instruction below.
Make sure your IDE (e.g. IntelIJ or Eclipse) sees your added files
Include JUnit to your Project by pressing the red lightbulb (or ALT + ENTER in IntelIJ) on one of the red underlined @Test Annotations in the test file.
Do not add them to your artemis git repository (it should already be in your .gitignore)
Run the tests and check your mistakes

Important note

As this is a student-driven project please keep in mind that mistakes can happen. If you think a test is wrong, please feel free to open an Issue (it is easy!). To help fixing bugs, please add the following info to your Issue:

Operating system
IDE (IntelIJ, Eclipse, …)
Where is the mistake / error
Citation of the homework instruction

How to use symlinks (Advanced Users only!)

Windows:

This has to be executed in the command line, run as administrator:

$ mklink /d \path\to\repository\aufgabe\test \path\to\repository\

Linux/MacOS:

$ ln -s /path/to/repository/aufgabe/test /path/to/repository/

3. How to Contribute

Fork Repository (Github Documentation)
Add / edit tests under <EXERCISE>/test/`
Ensure no solution or homework-code is getting revealed
Commit and push to your fork repository
Open a Pull Request to this repository (Github Documentation)
Wait until the changes are merged

4. Contributors

5. Helpful Links

Tests PGDP WS 21/22 (Testcases from last year might be a helpful guideline/inspiration)
Tests GAD 2022 (Testcases for a second semester course)
Write Tests using JUnit 5
How to use Git
How to use Github

6. Contact

Feel free to contact us (Maximilian Anzinger, Johannes Stöhr, Georg Henning, Konrad Gößmann, Robin Marchart, Oliver Specht, and Anton Kluge) via Zulip, but consider using google beforehand.