Ein robuster, komplett testgetrieben (TDD) entwickelter JSON-Parser und Validator in Rust. Das Projekt wurde ohne externe Parsing-Bibliotheken implementiert, um das Zusammenspiel von sicherem Speicher-Handling (&str), der Transformation von Daten und striktem Fehler-Design in Rust zu meistern.
Dieses Projekt ist eines meiner ersten Projekte in der Programmiersprache Rust. Es ist bewusst im Rahmen eines intensiven Lernprozesses entstanden.
- Bewusster Verzicht auf Crates (Bibliotheken): In produktiven Rust-Anwendungen gehört der Einsatz von
serdeundserde_jsonzum absoluten Standard. Für dieses Projekt habe ich bewusst auf jegliche externen Bibliotheken verzichtet. - Das Ziel: Ich wollte mich nicht auf fertige Magie verlassen, sondern die Kernkonzepte von Rust von Grund auf erzwingen und tiefgründig verstehen. Dazu gehören das strikte Ownership-Modell, das Arbeiten mit String-Slices (
&str), Speicherallokation, die Fehlerbehandlung viaResultundMatchsowie das Schreiben von sauberen Unit-Tests.
Dieses Projekt folgt strikt dem TDD-Paradigma. Jedes Feature und jede Validierungsregel wurde nach dem klassischen Dreischritt aufgebaut:
- commits -> test: Schreiben eines fehlschlagenden Integrationstests (z. B. für unvollständige Datentypen oder Altersgrenzen).
- commits -> feat: Implementierung des minimal notwendigen Produktionscodes, bis
cargo testerfolgreich durchläuft. - commits -> refactor: Modularisierung und Auslagerung des Codes in isolierte Prüffunktionen, abgesichert durch die bestehende Test-Suite.
Dank dieses Ansatzes ist die Pipeline zu 100 % regressionstestgesichert.
Der Eingabe-String durchläuft vier isolierte, testgesicherte Phasen, bevor er in die Zielstruktur überführt wird:
pruefe_basis_json_struktur() ➔ Validiert {}, leere Eingaben & Hochkomma-Anzahl (Garantierte Basis)
│
▼
pruefe_pflichtfelder() ➔ Schlägt fehl, wenn 'benutzer', 'email' oder 'alter' fehlen
│
▼
pruefe_email() ➔ Validiert die formale Syntax der E-Mail (@ und .)
│
▼
pruefe_alter() ➔ Isoliert das Alter, prüft Datentyp und erzwingt Altersgrenze (>= 18)
│
▼
[Zuweisung & Struct-Wandlung] ➔ Extraktion der finalen Werte via Whitespace- & Tabulator-Bereinigung
#[derive(Debug, PartialEq)]
pub struct BenutzerAnfrage {
pub benutzer: String,
pub email: String,
pub alter: u32,
}Der Parser nutzt das Result-Muster von Rust und wirft zu keinem Zeitpunkt Laufzeitfehler (panic!). Fehler werden präzise aufgeschlüsselt:
LeereJsonDatei— Keine Daten übergeben.FalschesJsonFormat— Fehlerhafte äußere Struktur (z. B. fehlende{}).KaputteJson— Unausgeglichene Anführungszeichen.FeldFehlt(String)— Ein spezifisches Pflichtfeld fehlt im JSON.EmailUngueltig— E-Mail-Validierung fehlgeschlagen.AlterZuJung— Nutzer erfüllt die Altersgrenze von 18 Jahren nicht.UngueltigerDatentyp(String)— Wenn z. B."alter": "drei-und-zwanzig"statt einer Zahl übergeben wird.
Da der Parser nativ geschrieben ist, benötigst du keine externen Crates.
Lass alle geschriebenen Tests laufen, um die Integrität des Parsers zu prüfen:
cargo test