Tornado 如何自动生成 Rest API 文档

2015 年 1 月 20 日

zjmdp

有个设想就是通过注释或者注解描述Rest API，通过工具自动生成API描述文档，每次git commit后自动update文档，使得文档始终保持最新，减少后台和终端之间的沟通成本，不知道Tornado下是否有类似的解决方案？大概google了一把没看到靠谱的方案

8642 次点击

所在节点

12 条回复

2015 年 1 月 20 日

这是python的事，修改下搜索关键字！

zjmdp

2015 年 1 月 20 日

@loading 哈哈，也属于程序员的事呀

haoba

2015 年 1 月 20 日

@zjmdp 这位先生说的莫不是Sphnix ？

haoba

2015 年 1 月 20 日

swagger 好像更好一些。

otmb

2015 年 1 月 20 日

听说ror完爆tonardo，真是这样么？

binux

2015 年 1 月 20 日

这有什么难的，自己写一个呗

zjmdp

2015 年 1 月 20 日

@otmb 我也喜欢ruby，担心ruby程序员不太好找

Fikhtengol

2015 年 1 月 20 日

torrnado性能完爆ror 会告诉你吗

zjmdp

2015 年 1 月 20 日

@haoba 嗯，这个方案看上去可以，是个通用方案，先研究下

otmb

2015 年 1 月 21 日

@zjmdp python程序员好找么?

joshyu8

2016 年 5 月 31 日

@binux , 你的工具看起来很不错，有开源吗？

Wichna

2016 年 6 月 8 日

比较好的方式是 Swagger

第 1 页／共 1 页

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.