Rust: Watch For File/Directory Changes
Zusammenfassung
Kurz
Der Beitrag erklärt Datei- und Verzeichnisüberwachung in Rust mit `notify`, einschließlich blockierender und nicht blockierender Verarbeitung sowie backendabhängiger Konfiguration. Seine Beispiele zur Ereigniszuordnung gelten für macOS; der Autor weist auf mögliche verpasste Ereignisse und bekannte, hier nicht im Einzelnen aufgeführte Einschränkungen hin.
Mittel
Der Artikel zeigt, wie Rust-Programme mit der Bibliothek `notify` Dateien und Verzeichnisse beobachten können. Das Grundmuster besteht darin, einen `Watcher` zu erzeugen, einen Ereignisbehandler einzurichten und mit `watch` einen Pfad zu überwachen. Ein Kanal vereinfacht die Verarbeitung, blockiert beim fortlaufenden Lesen aber den aufrufenden Thread. Als Alternativen nennt der Beitrag einen eigenen Thread, eine Closure oder einen selbst implementierten `EventHandler`. Bei Verzeichnissen steuert `RecursiveMode`, ob Unterverzeichnisse einbezogen werden; einzelne Dateien werden unabhängig davon beobachtet.
Der Autor beschreibt außerdem Konfigurationsoptionen wie Polling-Intervall, Inhaltsvergleich und Folgen symbolischer Links. Deren Verfügbarkeit hängt vom Backend ab, und manche Einstellungen können nach dem Erzeugen des Watchers nicht mehr geändert werden. Die Beispiele zur Ereigniszuordnung beziehen sich ausdrücklich auf macOS: Löschen kann dort etwa als Namensänderung erscheinen, während Öffnen, Schließen und Ausführen in den aufgeführten Fällen keine Ereignisse liefern. Für mögliche Ereignislücken empfiehlt der Artikel `Event::need_rescan`, insbesondere bei langen Polling-Intervallen. Bekannte Einschränkungen sollen vor einem produktiven Einsatz geprüft werden; der Artikel führt sie selbst nicht vollständig auf.
Ausführlich lesen
Der Artikel erklärt, wie sich Datei- und Verzeichnisänderungen mit Rust und der Bibliothek `notify` beobachten lassen. Als mögliche Einsatzfälle nennt der Autor etwa Werkzeuge, die bei Änderungen Dateien neu formatieren oder Entwicklungsprozesse überwachen. Er beschreibt `notify` als plattformübergreifende Bibliothek und verweist darauf, dass Projekte wie `cargo watch`, Deno und `rust-analyzer` sie verwenden.
Für den Einstieg empfiehlt der Beitrag, `notify` als Abhängigkeit einzutragen und einen plattformüblichen `Watcher` mit `recommended_watcher` zu erzeugen. Dieser erhält einen Ereignisbehandler; im Grundbeispiel ist das ein Kanal aus Rusts Standardbibliothek. Das Programm beginnt die Überwachung mit `watch` und liest anschließend Ereignisse vom Empfänger. Diese Schleife blockiert den aufrufenden Thread. Bei Verzeichnissen bestimmt `RecursiveMode`, ob auch Unterverzeichnisse einbezogen werden. Bei einer einzelnen Datei werde diese Einstellung ignoriert. Mit `unwatch` lasse sich die Beobachtung wieder beenden; der Aufruf könne fehlschlagen, wenn der Pfad nicht überwacht werde oder das Entfernen nicht gelinge.
Als nicht blockierende Varianten führt der Autor drei Möglichkeiten vor: Die Überwachung kann in einen eigenen Thread verlagert werden, Ereignisse können über eine Closure verarbeitet werden, oder ein eigener Typ kann das `EventHandler`-Trait implementieren. Die Beispiele geben Ereignisse aus; im Thread-Beispiel hält eine Schleife mit kurzen Pausen den Hauptprozess am Laufen.
Ein weiterer Abschnitt behandelt die Konfiguration. Gezeigt werden Einstellungen für Abfrageintervalle, Inhaltsvergleiche und das Folgen symbolischer Links. Welche Optionen verfügbar sind, hängt laut Artikel vom verwendeten Watcher-Backend ab; außerdem lassen sich nicht alle Einstellungen nach dem Erzeugen des Watchers ändern. Das Laufzeitbeispiel gibt `Ok(true)` bei Erfolg, `Ok(false)` bei nicht unterstützten Optionen und einen Fehler bei einem Fehlschlag zurück. Der Autor berichtet, dass die gezeigte Konfiguration auf seinem Mac mit dem dort verwendeten `FsEventWatcher` nicht zur Laufzeit unterstützt werde. Er weist außerdem darauf hin, dass nicht unterstützte Einstellungen bei der Erzeugung ignoriert werden können.
Zu Ereignissen erläutert der Beitrag die Felder Typ, betroffene Pfade und Attribute. Eine Tabelle beschreibt beispielhafte Ereignisse für Datei- und Verzeichnisoperationen auf dem Mac. Dabei könnten Vorgänge wie Löschen als Namensänderung gemeldet werden; Öffnen, Schließen oder Ausführen würden in den aufgeführten Fällen nicht gemeldet. Die Tabelle ist ausdrücklich auf Mac bezogen und sollte daher nicht als plattformübergreifende Ereigniszuordnung verstanden werden. Attribute können unter anderem Tracker-ID, Kennzeichen, Quelle, Prozess-ID und Zusatzinformationen enthalten. Der Artikel empfiehlt, `Event::need_rescan` zu prüfen, wenn Ereignisse verpasst worden sein könnten, besonders bei längeren Polling-Intervallen. Ereignisse ließen sich außerdem mit aktivierter `serde`-Funktion serialisieren.
Der Beitrag verweist abschließend auf bekannte Einschränkungen und Probleme der Bibliothek und empfiehlt, diese vor einem produktiven Einsatz zu prüfen. Eine konkrete vollständige Auflistung dieser Probleme enthält der Artikel nicht.
Gegengeprüft von Claude Haiku 5.5: ok
Beide Zusammenfassungen von Luna wurden gemeinsam geprüft, da der Schema-Eintrag nur eine Zusammenfassung vorsieht. Sie geben den Bericht sachlich korrekt wieder, ohne erfundene Angaben. Die Einordnung blieb leer, weil im Auftrag keine Fragen angegeben waren (Sammel- und Teilfragen jeweils '(keine)').
Im Bericht, aber nicht in der Zusammenfassung
- Die Struktur des Event-Objekts (kind, paths, attrs) und die Tabelle der macOS-Ereignisse werden in beiden Fassungen nur knapp oder gar nicht beschrieben.
- Der Serde-Feature-Hinweis zu Events fehlt in beiden Fassungen.
- Die Kurzfassung nennt das RecursiveMode-Verhalten bei Verzeichnissen nicht.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.