====== LU03.A03 - Rotation-Chiffre ======
Schreibe die Unit Tests für das Programm "m450-lu03-a03-rotation".
===== Beschreibung =====
Die [[https://legacy.cryptool.org/de/cto/rotation|Rotation-Chiffre]] ist eine Methode zur Verschlüsselung von Nachrichten.
Der Klartext wird zeilenweise in Blöcke einer festen Länge geschrieben. Die Blöcke werden um 90° nach rechts gedreht und zeilenweise ausgelesen.
=== Begriffe ===
* **Klartext**: Dies ist der ursprüngliche Text, der verschlüsselt werden soll.
* **Chiffretext**: Der verschlüsselte Text
* **Blocklänge**: Die Länge eines Textblocks für die Verschlüsselung
=== Beispiel mit Blocklänge 5 ===
Klartext: kurzer Text -> KURZERTEXT
Blöcke: K U R Z E um 90° nach rechts gedreht: R K
R T E X T T U
E R
X Z
T E
Chiffretext: RKTUERXZTE
===== Das Programm =====
Das Programm in ''main.py'' ist fertig und in mehrere Funktionen zerlegt. Es muss **nicht** verändert werden.
^ Funktion ^ Verhalten ^
| ''prepare_text(text)'' | entfernt Leerzeichen und wandelt in Grossbuchstaben um |
| ''split_blocks(text, block_length)'' | teilt den Text in Blöcke, der letzte Block wird mit ''X'' aufgefüllt |
| ''rotate_right(blocks)'' | dreht die Blöcke um 90° nach rechts |
| ''encrypt(plaintext, block_length)'' | verschlüsselt einen Klartext |
| ''decrypt(ciphertext, block_length)'' | entschlüsselt einen Chiffretext |
Die Docstrings beschreiben, wann welche Exception ausgelöst wird.
===== Auftrag =====
In ''main_test.py'' sind die Testfunktionen vorbereitet. Die Kommentare ''# TODO ...'' beschreiben jeweils, welche Situation zu testen ist.
Erstelle für jede Funktion Tests für
* Gültige Werte, inklusive Grenzwerte und Spezialfälle (z.B. ein Text, der nicht genau in die Blöcke passt)
* Formal falsche Werte (je 1 Test pro Fehlersituation)
* Formal korrekte aber logisch ungültige Werte (je 1 Test pro Fehlersituation)
Für die Fehlersituationen prüfst du mit ''pytest.raises'', ob die erwartete Exception ausgelöst wird.
Theorie: [[..:exceptions|LU03e - Klassen und Fehlerfälle testen]], [[..:parametrize|LU03f - Parametrisierte Tests]]
===== Vorgehen =====
- Akzeptiere das GitHub Classroom Assignment im Moodlekurs.
- Klone das Repository in PyCharm.
- Schreibe die Unit Tests in ''main_test.py''.
- Führe die Tests mit ''pytest -v'' aus und prüfe das Ergebnis.
- Führe einen Commit und einen Push durch.
=== Abgabe ===
Die Abgabe erfolgt durch den Push ins GitHub Repository.
In Moodle ist keine Abgabe vorgesehen oder möglich.
----
GitHub-Repo: https://github.com/templates-python/m450-lu03-a03-rotation (Branch solution: Lösung)
{{tag>M450-LU03 M450-C1I M450-C1A}}
[[https://creativecommons.org/licenses/by-nc-sa/4.0/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] Marcel Suter