Anyhow für Rust: Vollständige Anleitung mit Beispielen

Einführung in Anyhow: Was es ist und warum man es braucht

\n\n

Anyhow ist eine der beliebtesten Bibliotheken zur Fehlerbehandlung im Rust-Ökosystem. Sie bietet eine einfache, flexible und bequeme Möglichkeit, mit Fehlern umzugehen, insbesondere in Situationen, in denen Sie keine strenge Fehlertypisierung benötigen oder wenn Sie Prototypen, Skripte, CLI-Tools oder Anwendungen schreiben, bei denen die Entwicklungsgeschwindigkeit wichtiger ist als die perfekte Behandlung jeder einzelnen Fehlerart.

\n\n

In der Standardbibliothek von Rust basiert die Fehlerbehandlung auf dem Typ Result<T, E>, wobei E der Fehlertyp ist. In großen Projekten können die Fehlertypen jedoch unterschiedlich sein: std::io::Error, serde_json::Error, reqwest::Error usw. Diese manuell zu kombinieren ist eine nicht triviale Aufgabe. Anyhow löst dieses Problem, indem es den universellen Typ anyhow::Error bereitstellt, der jeden Fehler speichern kann, der das Trait std::error::Error implementiert.

\n\n

Hauptvorteile von Anyhow:

\n

\n
• Einfachheit: Minimaler Boilerplate-Code. Sie müssen keine eigenen Fehlertypen für jedes Modul erstellen.
\n
• Flexibilität: Jeder Fehler wird automatisch in anyhow::Error konvertiert.
\n
• Kontext: Sie können mit der Methode .context() zusätzliche Informationen zu einem Fehler hinzufügen.
\n
• Praktische Makros: bail! und ensure! ermöglichen die schnelle Rückgabe von Fehlern.
\n
• Kompatibilität: Funktioniert mit jeder Bibliothek, die Result zurückgibt.
\n

\n\n

Anyhow ist nicht für Bibliotheken gedacht (wo besser thiserror verwendet wird), aber ideal für Anwendungen, Binärdateien und Tests.

\n\n

Installation

\n\n

Anyhow ist eine Bibliothek für Rust, daher erfolgt die Installation über den Paketmanager cargo. Fügen Sie die folgende Zeile zu Ihrer Cargo.toml-Datei hinzu:

\n\n

[dependencies]\nanyhow = "1.0"

\n\n

Führen Sie anschließend den Befehl cargo build aus, und die Bibliothek wird heruntergeladen und kompiliert. Wenn Sie Rust 2021 Edition oder neuer verwenden, sind keine zusätzlichen Einstellungen erforderlich.

\n\n

Um Anyhow im Code zu verwenden, reicht es, es zu importieren:

\n\n

use anyhow::{Result, anyhow, bail, Context};

\n\n

Schnellstart: Erstes Beispiel

\n\n

Schreiben wir ein einfaches Programm, das eine Datei liest, sie als JSON parst und das Ergebnis ausgibt. Wenn in einem Schritt ein Fehler auftritt, geben wir ihn einfach nach oben weiter.

\n\n

use anyhow::Result;\nuse std::fs;\n\nfn main() -> Result<()> {\n    // Dateiinhalt lesen\n    let data = fs::read_to_string("config.json")?;\n    \n    // Als JSON parsen (serde_json verwenden)\n    let config: serde_json::Value = serde_json::from_str(&data)?;\n    \n    println!("Konfiguration: {}", config);\n    Ok(())\n}

\n\n

Beachten Sie das ? – den Fehlerweitergabe-Operator. Wenn read_to_string oder from_str einen Fehler zurückgeben, wird dieser automatisch in anyhow::Error umgewandelt und die Funktion wird mit diesem Fehler beendet. Alles einfach und elegant.

\n\n

Wichtige Methoden und Funktionen von Anyhow

\n\n

Nachfolgend sind 10 wichtige Methoden und Funktionen der Anyhow-Bibliothek mit detaillierter Beschreibung und Beispielen aufgeführt.

\n\n

1. anyhow!() — Erstellen eines beliebigen Fehlers

\n

Was es tut: Das Makro anyhow! erstellt einen neuen Fehler vom Typ anyhow::Error aus einem String oder einer formatierten Nachricht. Es ist das Äquivalent zu format!, aber für Fehler.

\n

Parameter: Akzeptiert einen String mit Formatierung (wie format!) oder jeden Typ, der Display implementiert.

\n

Beispiel:

\n

use anyhow::{anyhow, Result};\n\nfn validate_age(age: i32) -> Result<()> {\n    if age < 0 {\n