Skip to content
Modul 22 — Capstone: Statischer Site-Generator
6

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-lib wird im Code minissg_lib. Wer use minissg-lib::parse; schreibt, scheitert schon am Parsen — der Compiler schlägt die Unterstrich-Schreibweise vor; die Cargo.toml behält den Bindestrich, der use-Pfad nie.

✅ Wichtige Erkenntnisse

0/3

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.

Der Test- und Wartungsaufwand steckt in der (src/lib.rs) — die Binary ist bewusst dünn: nur Datei → Parsen → Rendern → Datei.
Das CLI liest die Eingabe mit fs::("index.md") und schreibt das fertige HTML mit fs::write("index.html").
In der Cargo.toml nutzt die Binary die Library als -Abhängigkeit: minissg-lib = { path = "lib" }.
0 von 3 richtig

This site uses essential cookies for Stripe payments. No tracking cookies.