Workspace & CLI: Library + Binary
Lektion 6 von 7
Trennung von Logik und Einstieg
Unser Generator lebt in einer Library (src/lib.rs) — reine,
wiederverwendbare Logik. Der Einstiegspunkt (Binary) ist ein dünnes CLI,
das Dateien liest und HTML schreibt:
// src/main.rs (Binary) — nur der Einstieg
use std::fs;
use minissg::{parse, render_page};
fn main() -> std::io::Result<()> {
let src = fs::read_to_string("index.md")?;
let blocks = parse(&src);
let html = render_page("Meine Seite", &blocks);
fs::write("index.html", html)?;
Ok(())
}
In der Cargo.toml ist die Binary nur eine Datei, die die Library als
Pfad-Abhängigkeit nutzt (Workspace-Konzept aus Modul 16):
[package]
name = "minissg"
[dependencies]
minissg-lib = { path = "lib" }
Dünne Binary, dicke Library
Der gesamte Test- und Wartungsaufwand steckt in der Library — dort liegen Parsing, Rendering und Layout. Die Binary ist bewusst dünn: Sie verdrahtet nur Datei → Parsen → Rendern → Datei. Dank der Trennung kannst du die Logik per Unit-Tests prüfen, ohne ein CLI zu starten.
⚠ Häufiger Fehler: Cargo übersetzt Bindestriche in Crate-Namen zu Unterstrichen: Aus der Abhängigkeit
minissg-libwird im Codeminissg_lib. Weruse minissg-lib::parse;schreibt, scheitert schon am Parsen — der Compiler schlägt die Unterstrich-Schreibweise vor; dieCargo.tomlbehält den Bindestrich, deruse-Pfad nie.
✅ Wichtige Erkenntnisse
Haken setzen, um deinen Lernfortschritt zu markieren:
Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.
Erinnerungstraining
Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.