Diese Aktivität beinhaltet die Implementierung statistischer Analysetools in mein Open-Source-Projekt GENEREADME, um die Codequalität und -konsistenz zu verbessern.

API_KEY=API_KEY

or

genereadme <files> -a API_KEY
genereadme <files> --api-key API_KEY

npm install -g

genereadme <files&gt
genereadme examples/sum.js
genereadme examples/createUser.js

Formatierer

Als Formatierer habe ich mich für Prettier entschieden. Aus einfachen Gründen habe ich mich dafür entschieden, weil ich die Grundfunktionen einfach schon einmal verwendet habe und ich vorhabe, mehr darüber zu lernen.

Technisch gesehen habe ich meine IDE bereits so eingerichtet, dass sie standardmäßig Prettier verwendet, sodass ich meinen Formatierer bereits von Anfang an hatte. Dank der nun schöneren Einrichtung im Projekt selbst können Mitwirkende jedoch auch den Formatierer verwenden, sodass der Code des Projekts hinsichtlich der Formatierung konsistent bleibt.

Ich habe einfach die Regeln hinzugefügt, wie der Code in meiner .prettierrc-Datei formatiert werden soll, und einige Einstellungen in „settings.json“ unter „.vscode/“ für Optionen wie Formatierung beim Speichern.

Linter

Für meinen Linter habe ich mich für die Verwendung von ESLint entschieden. Da ich JavaScript verwende, habe ich einen der beliebten Linters verwendet, mit dem ich auch schon Erfahrung hatte, den ich aber nicht wirklich selbst eingerichtet habe. Aus diesem Grund habe ich mich für ESLinter entschieden.

Das Einrichten von ESLinter war nicht wirklich kompliziert. Eine einfache Installation und das Einrichten der Regeln in eslint.config.js reicht aus, um den Linter zum Laufen zu bringen. Da ich jedoch gleichzeitig einen Formatierer und einen Linter verwende, muss ich sicherstellen, dass beide ordnungsgemäß zusammenarbeiten können. Dazu gehören grundsätzlich zusätzliche Regeln, um sicherzustellen, dass es zu keinen Konflikten mit Linter und Formatter kommt.

So verwenden Sie die Tools

Es gibt viele Möglichkeiten, die Tools im Projekt zu verwenden, und ich persönlich bevorzuge diese spezifischen Konfigurationen: Formatieren beim Speichern für Prettier und Ausführen beim Tippen für Eslint. Auf diese Weise prüft der Linter während der Eingabe durch den Entwickler immer, ob Flusenprobleme vorliegen, und der Formatierer formatiert die Änderungen dann automatisch, wenn ein Speichervorgang ausgelöst wird.

Für die Aufgabe dieser Woche habe ich jedoch auch Skripte hinzugefügt, damit der Benutzer den Formatierer und Linter manuell über die CLI ausführen kann. Außerdem ist ein Pre-Commit-Hook implementiert, um sicherzustellen, dass jeder in das Repository übertragene Code den Formatierungs- und Linting-Standards des Projekts entspricht. Durch das Hinzufügen dieses Hooks kann ich Prettier und ESLint vor jedem Commit automatisch ausführen, um Probleme frühzeitig zu erkennen und die Codekonsistenz über alle Beiträge hinweg aufrechtzuerhalten. Dieses Setup trägt dazu bei, die Wahrscheinlichkeit zu verringern, dass kleinere Formatierungsprobleme durchgehen, und verbessert die Lesbarkeit des Codes für alle, die am Projekt arbeiten.

Das obige ist der detaillierte Inhalt vonFormatierung und Linting für Konsistenz. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!