Toolkit for YNAB: eine Browsererweiterung im Wartungsmodus

Wartungsmodus und die Suche nach Maintainern

Die README beginnt mit einem Hinweis auf den Wartungsmodus. Updates werden deutlich seltener kommen und wahrscheinlich nur Fehlerbehebungen enthalten, keine neuen Funktionen. Das Projekt sucht aktiv nach neuen Maintainern, die bereit sind, die Aufgaben der Genehmigung und Veröffentlichung von Updates zu übernehmen. Interessierte werden an Josh Madewell im Projekt-Discord verwiesen. Die Repository-Metadaten zeigen 1511 Sterne, 362 Forks und 307 offene Issues, aber die README sagt nicht, wie sich der Wartungsmodus auf den Issue-Tracker oder die Roadmap auswirkt, und sie nennt kein Datum für den Beginn des Wartungsmodus.

Eine Browsererweiterung für die YNAB-Web-App

Toolkit for YNAB ist eine Browsererweiterung, die die YNAB-Webanwendung erweitert. Im Abschnitt zur Motivation wird erklärt, dass YNAB eine neue Webversion veröffentlicht hat und viele Power-User der älteren Versionen nach Optionen fragen, die sich leicht in einer Browsererweiterung umsetzen lassen. Statt das YNAB-Team zu bitten, diese Funktionen zu implementieren, hat das Projekt beschlossen, es selbst zu tun. Die vollständige Funktionsliste befindet sich in docs/feature-list.md, und auf der Optionsseite der installierten Erweiterung werden die Funktionen ebenfalls aufgelistet und können einzeln ein- oder ausgeschaltet werden. Die README selbst zählt die Funktionen nicht auf, daher ist das Funktionslisten-Dokument die Quelle für Einzelheiten.

Chrome, Firefox, Edge und kein Safari

Die Erweiterung wird mit den Browser- (Web-) Erweiterungs-APIs erstellt und ist für Chrome, Firefox und Edge verfügbar. Vorgefertigte Versionen werden über den Chrome Web Store, das Firefox-Add-on-Repository und die Microsoft-Edge-Add-ons-Seite verteilt, mit direkten Links in der README. Wenn Sie die Erweiterung nicht selbst aus dem Quellcode bauen möchten, können Sie sie direkt aus diesen Stores installieren. Da Web Extensions von Safari nicht unterstützt werden, wird die Erweiterung auch nicht auf Safari unterstützt. Die README sagt, dass das Projekt, falls Safari sich entscheidet, Web Extensions zu unterstützen, tun wird, was es kann, um Unterstützung für diesen Browser bereitzustellen. Die README enthält keine Angaben zu Update-Häufigkeit oder Versionsnummern der Store-Versionen.

Die Erweiterung aus dem Quellcode bauen

Für den Bau werden Node.js (>=18.12.1) und Yarn (>= v1.10.0) benötigt. Auf macOS können beide mit brew eingerichtet werden, und die Kommandozeilen-Entwicklerwerkzeuge (xcode-select --install) sind ebenfalls erforderlich. Auf Windows können node und yarn über den Chocolatey-Paketmanager installiert werden. Der Build-Prozess verwendet ESLint zur Überprüfung des Code-Stils, Babel zum Transpilieren von ES2015 zurück zu ES5 und Webpack, um die Einstiegspunkte aller Web-Erweiterungsseiten (Hintergrund, Popup, Optionen, Inhaltsskripte) in einzelne Dateien zu bündeln. Nach dem Klonen führt man yarn install und dann yarn build:development aus. Während der Entwicklung überwacht yarn watch das Projektverzeichnis und führt yarn build:development automatisch aus. yarn watch:webpack kompiliert nur Ihre Codeänderungen, ohne Indizes neu zu generieren, was die Entwicklung spürbar beschleunigen kann. Um die gebaute Erweiterung in Chrome zu laden, heißt es in der README, zu chrome://extensions zu navigieren, den Entwicklermodus einzuschalten, auf Entpackte Erweiterung laden zu klicken und den Ordner dist/extension auszuwählen. Wenn die Erweiterung bereits installiert war, muss sie möglicherweise neu geladen werden. Für Firefox wird dokumentiert, web-ext global mit yarn zu installieren, dann yarn run manifest:firefox und anschließend web-ext run --source-dir dist/extension/ auszuführen. VS-Code-Nutzer können die Setup-Aufgabe ausführen, um einige manuelle Schritte zu überspringen.

Beitragen und das Feature-Framework

Die README begrüßt Beiträge ausdrücklich und bittet Mitwirkende, sich vorher zu melden, damit keine doppelte Arbeit entsteht. Die Roadmap zeigt, woran wer arbeitet. Wer das Gesuchte dort nicht findet, kann eine Notiz im GitHub-Issue-Board hinterlassen, um das Team über neue Arbeiten zu informieren. Wenn der Code fertig ist, wird ein Pull-Request eingereicht. Der Feature-Code liegt im Verzeichnis src/extension/features, dessen Unterverzeichnisse jeweils einen Abschnitt der YNAB-Anwendung repräsentieren. Feature-Entwickler sollten den Ordner wählen, der dem Abschnitt entspricht, in dem das Feature laufen soll. Das neue Framework wurde gebaut, weil das alte in jedem Feature viel Boilerplate-Code verlangte; das neue nutzt ES6-Funktionen stärker und nimmt neuen Beiträgen diese Last ab. Die Dokumentation zum Bauen eines Features liegt in docs/building-features.md. Mitwirkende müssen ihren Editor auf Unix-Zeilenumbrüche (LFs) einstellen, sonst schlägt der Build fehl. Laut README betrifft das hauptsächlich Windows-Nutzer, da sich die Zeilenumbrüche auf dieser Plattform unterscheiden.

Lizenz und rechtlicher Hinweis

Die Erweiterung wird unter der MIT-Lizenz verteilt, Copyright 2016 Kevin Brown. Die Lizenz gewährt das Recht, Kopien der Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, und verlangt, dass der Copyright- und Genehmigungshinweis in allen Kopien oder wesentlichen Teilen enthalten ist. Die README enthält einen wichtigen Hinweis, dass die Erweiterung in keiner Weise mit YNAB verbunden ist und YNAB sie nicht gebilligt hat. You Need a Budget und YNAB sind eingetragene Warenzeichen von Steine LLC und/oder einer ihrer Tochtergesellschaften. Der Lizenztext enthält den Standard-Haftungsausschluss, dass die Software 'wie sie ist' ohne jegliche Gewährleistung bereitgestellt wird, einschließlich der Gewährleistung von Marktgängigkeit, Eignung für einen bestimmten Zweck und Nichtverletzung von Rechten, und dass die Autoren oder Copyright-Inhaber nicht für Ansprüche, Schäden oder andere Haftungen verantwortlich sind. Die README beschreibt darüber hinaus keine Support-Garantien oder Sicherheitsvorkehrungen.

Redaktionelles Fazit

Toolkit for YNAB wird unter der MIT-Lizenz verteilt und ist nicht mit YNAB verbunden. Die README beschreibt keinen Support-Kanal über den Discord-Link im Wartungshinweis hinaus und sagt nicht, wie sich der Wartungsmodus auf den Issue-Tracker auswirkt.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes