摇摇晃晃然后烧瓶或相反

Question

大摇大摆然后是烧瓶或相反 你好，

我正在开始一个需要API的新项目。

我要去摇摇晃晃地摇摇晃晃。

一个简单的问题：我应该首先用招摇的方式定义API，然后生成python代码或相反的代码。

感谢您的帮助。

Answer 1

两种方法都有解决方案：

如果您最终希望先定义API，则建议使用connexion。您定义OpenAPI（Swagger的新名称）规范文件，然后相应地执行Python代码。我想说这是最好的方法，因为您可以保证以后编写的任何代码都符合规范，并且可以将其提供给任何需要的人。另一个优点是不会将逻辑的核心概念与API规范混淆。

否则，flask-restplus可以解决问题。这是最常见（但不一定更好）的方法，您可以在其中编写Python代码，然后生成规范。在简单的用例中，我通常会采用这种方法。

Answer 2

有关信息，我最终选择了openapi-generator工具，该工具可让我在Flask / connexion堆栈上生成python服务器存根，并在okhttp之上生成Android的客户端库。

https://github.com/OpenAPITools/openapi-generator

在项目期间，我对此选择感到非常满意。

要将最新版本的服务器存根与较旧的版本合并，您可以将git分支专用于原始服务器存根的生成，而另一个则用自己的代码填充。这样，您将不会丢失添加到服务器存根中的代码的先前版本。