1. Was ist config und warum braucht man es?

Die Bibliothek config (Crate config im Rust-Ökosystem) ist ein leistungsstarkes und flexibles Werkzeug zur Verwaltung von Anwendungskonfigurationen. Sie bietet eine einheitliche Schnittstelle zum Laden von Einstellungen aus verschiedenen Quellen: Dateien (JSON, YAML, TOML, INI, HJSON), Umgebungsvariablen, Kommandozeilenargumenten und sogar entfernten Quellen. Die Hauptaufgabe der Bibliothek besteht darin, den Prozess des Lesens und Zusammenführens von Konfigurationen zu abstrahieren, sodass sich Entwickler auf die Geschäftslogik konzentrieren können, anstatt sich mit dem Parsen verschiedener Formate herumzuschlagen.

Warum ist das in realen Projekten wichtig? Moderne Anwendungen haben selten nur eine einzige Konfigurationsquelle. Ein typisches Szenario: Basiseinstellungen werden in einer config.toml-Datei gespeichert, sensible Daten (Passwörter, API-Schlüssel) werden aus Umgebungsvariablen geladen, und Parameter für einen bestimmten Start werden über Kommandozeilenargumente übergeben. config ermöglicht es, all diese Quellen in einem einzigen Konfigurationsbaum mit klarer Priorität zusammenzuführen (z. B. überschreiben Umgebungsvariablen Dateiwerte). Ohne eine solche Bibliothek müssten Entwickler den Code für jede Quelle manuell schreiben, Parsing-Fehler behandeln und die Reihenfolge der Überschreibungen im Auge behalten.

Die wichtigsten Vorteile von config: vollständige Typsicherheit (Einstellungen werden in Rust-Strukturen deserialisiert), Unterstützung für verschachtelte Konfigurationen, automatische Überwachung von Dateiänderungen (Watch) und Erweiterbarkeit durch eigene Datenquellen. Die Bibliothek wird häufig in Produktionsprojekten wie Webservern, CLI-Tools und Microservices eingesetzt.

2. Installation

Um die config-Bibliothek zu einem Rust-Projekt hinzuzufügen, verwenden Sie den Paketmanager Cargo. Führen Sie im Terminal im Stammverzeichnis Ihres Projekts aus:

cargo add config

Wenn Sie die manuelle Bearbeitung von Cargo.toml bevorzugen, fügen Sie im Abschnitt [dependencies] hinzu:

[dependencies]
config = "0.14"

Außerdem benötigen Sie eine Crate für die Serialisierung/Deserialisierung. Empfohlen wird serde mit dem derive-Makro:

cargo add serde --features derive

Um mit bestimmten Dateiformaten zu arbeiten, müssen Sie die entsprechenden Feature-Flags hinzufügen. Zum Beispiel für die Unterstützung von TOML, YAML und JSON:

cargo add config --features yaml,json,toml

Die vollständige Liste der verfügbaren Formate: ini, json, toml, yaml, hjson. Wenn Sie nur ein Format verwenden möchten, geben Sie nur dieses an – das verkürzt die Kompilierzeit.

3. Schnellstart – Minimales funktionierendes Beispiel

Erstellen Sie eine Datei Settings.toml im Stammverzeichnis Ihres Projekts:

# Settings.toml
[server]
host = "127.0.0.1"
port = 8080

[database]
url = "postgres://user:pass@localhost/db"
pool_size = 10

Schreiben wir nun den Code zum Lesen dieser Konfiguration:

use config::{Config, File, FileFormat};
use serde::Deserialize;
use std::env;

#[derive(Debug, Deserialize)]
struct ServerConfig {
    host: String,
    port: u16,
}

#[derive(Debug, Deserialize)]
struct DatabaseConfig {
    url: String,
    pool_size: u32,
}

#[derive(Debug, Deserialize)]
struct AppConfig {
    server: ServerConfig,
    database: DatabaseConfig,
}

fn main() -> Result<(), config::ConfigError> {
    // Konfigurations-Builder erstellen
    let builder = Config::builder()
        // Datei als Quelle hinzufügen
        .add_source