Inhalt

Um die Effizienz der REST-API-Entwicklung zu verbessern, werden meiner Meinung nach Tools zur Generierung von Spezifikationen, zur Codegenerierung, zur Stilprüfung und zur automatischen Formatierung verwendet.
Für Python sind hier einige Tools, die ich nützlich finde.
Der Entwicklungseditor ist VSCode.

REST API bezogen

Schreiben Sie die OpenAPI-Spezifikation im Yaml-Format und generieren Sie die REST-API-Schnittstellenspezifikation und den Code.
Schnittstellenspezifikationen
Serverseitiger Stub (Controller, HTTP-Anforderungs- / Antwortmodell)
Client SDK für die frontseitige REST-API
Das Generieren eines Server-Stubs ist sehr praktisch.
Wenn Sie Flask-Code in Python generieren, können Sie sogar eine Flask-App (in eine Bibliothek namens connexion eingeschlossen) steuern, die HTTP-Anforderungen basierend auf der OpenAPI-Spezifikation steuert.
Da HTTP-Anforderungen basierend auf der OpenAPI-Spezifikation validiert werden, müssen Sie den Validierungscode nicht selbst entwickeln.
Für die Clientseite kann es auch als Stub-Server verwendet werden, bis die Serverseite abgeschlossen ist.
Das Client-SDK ist ebenfalls nützlich. Es ist einfacher als eigene Endpunkte und Anforderungen zu erstellen.
Die verwendeten Werkzeuge sind wie folgt.

Verwenden	Werkzeugname	Erläuterung	Verknüpfung
Bearbeiten der OpenAPI-Spezifikation	VSCode + OpenAPI Editor(Erweiterung)	Schreiben Sie die OpenAPI-Spezifikation in VSCode. Es ist praktisch, auf der linken Seite eine Tabelle mit Pfaden und Schemata zu haben.	https://marketplace.visualstudio.com/items?itemName=42Crunch.vscode-openapi
Verweis auf OpenAPI-Spezifikationen	VSCode + Swagger Viewer(Erweiterung)	Sie können die OpenAPI-Spezifikation als Dokument verwenden.	https://marketplace.visualstudio.com/items?itemName=Arjun.swagger-viewer
Validierung von OpenAPI-Spezifikationen	openapi-generator	CLIでValidierung von OpenAPI-Spezifikationenができます。 Sie können auch Fehler erkennen, die der OpenAPI-Editor nicht erkennen kann. Es gibt jedoch noch einige Fehler, die nicht erkannt werden können. Beispielsweise ist das im Schema auf "Erforderlich" festgelegte Element nicht als Eigenschaft definiert. Ich bemerke diese Dinge, weil ich eine Fehlermeldung erhalte, wenn ich den Server-Stub codiere und starte.	https://github.com/OpenAPITools/openapi-generator
Codegenerierung	openapi-generator	OpenAPI仕様（yamlファイル）からCodegenerierung（サーバースタブ、クライアントSDK）できます。	Das gleiche wie oben
Dokumentenerstellung	openapi-genrator	Generieren Sie REST-API-Schnittstellenspezifikationen im HTML-Format.	Das gleiche wie oben

Generieren Sie ein Klassendiagramm und Klassenspezifikationen aus dem entwickelten Code.
Sie müssen einen Docstring als Voraussetzung für die Generierung einer Klassenspezifikation schreiben.
Linter (Stilprüfung) und Formatter (automatisches Format) sind auch für die Codeentwicklung nützlich.
Die verwendeten Werkzeuge sind wie folgt.

Verwenden	Werkzeugname	Erläuterung	Verknüpfung
Generierung eines Klassendiagramms	Pyreverse	Generierung von Klassendiagrammen	https://pypi.org/project/pylint/
Generierung von Klassenspezifikationen	Sphinx	Generierung von Klassenspezifikationen	https://www.sphinx-doc.org/ja/master/ Installationsverfahren für Sphinx
Unterstützung bei der Beschreibung der Dokumentzeichenfolge	VSCode + Python Docstring Generator	Sie können aus Ihrem Code eine Dokumentzeichenfolgenvorlage generieren. Im Fall einer Methode werden beispielsweise die Zusammenfassungszeile, der Argumentname, der Typ und der Rückgabetyp aus dem Code generiert, sodass Sie die Beschreibung einfach selbst schreiben können.	https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring
Python-Style-Check	VSCode + flake8	Es wird geprüft, ob es pep8 entspricht, und das Ergebnis angezeigt.	https://pypi.org/project/flake8/
Automatisches Python-Format	VSCode + autopep8	Bis zu einem gewissen Grad wird der Code automatisch so geändert, dass er pep8-kompatibel ist. Öffnen Sie beispielsweise eine zweizeilige Leerzeile über der Klassendefinition oder fügen Sie ein Leerzeichen mit halber Breite in das Argument ein.	https://pypi.org/project/autopep8/

In der Codeentwicklung wird in vielen Fällen DB verwendet.
Ich werde ein praktisches Tool vorstellen, das ER-Diagramme, Tabellendefinitionen und DDL mit GUI generieren kann.
Eclipse Plug-In ERMaster.
Wenn Sie ein ER-Diagramm mit GUI schreiben, können Sie daraus Excel-Tabellenspezifikationen und DDL-Anweisungen generieren.
Ich denke, es ist besser, das konzeptionelle Datenmodell in Powerpo oder draw.io zu schreiben und es aus dem logischen Datenmodell in ERMaster zu schreiben.

Verwenden	Werkzeugname	Erläuterung	Verknüpfung
ER-Diagramm, Tabellendefinition, DDL-Generierung	ERMaster	Eclipseのプラグインで、GUIで、ER-Diagramm, Tabellendefinition, DDL-Generierungができます。	http://ermaster.sourceforge.net/index_ja.html