python - 使用 Swagger 生成的新代码更新 Flask 代码

Question

我最近开始使用 Swagger 生成 Flask 模板:http://editor.swagger.io/#/

我的工作流程有缺陷，我想知道我哪里出错了。我:

1. 使用UI编写API V1 .yaml
2. 使用 UI 编辑器生成代码，该编辑器会下载一个已 stub 的 zip
3. 编写被删除的函数

这部分流程没问题。但是，假设我们想要添加一个新端点或更改现有端点。怎么办？我:

1. 重新加载 swagger 编辑器
2. 编辑yaml
3. 生成代码，下载一个新的 zip 并清除旧代码
4. 获取新生成的代码并进行“自合并”，我将新 stub 复制到旧代码中，并将新 yaml 复制到旧代码中

flask 模板的初始生成与持续维护之间似乎存在差距。我做错了什么？

Answer 1

是的，AFAICS 还没有真正好的工作流程。

您可以做的一件事是将原始生成的代码检查到名为“generated”或类似分支的 git 中。然后将其合并到 master 并开始处理它。如果稍后扩展您的 swagger 定义，您可以再次生成代码，切换到生成的分支，用新生成的代码覆盖现有代码，再次提交并合并到 master。如果您只有一些额外的端点，这甚至应该可以在没有任何合并冲突的情况下工作。

如果 swagger 工具知道它们生成的代码并能够更新生成的代码，那当然会更好，但在那之前，这应该是一个可以忍受的解决方法。