Tornado 如何自动生成 Rest API 文档

2015-01-20 16:37:17 +08:00
 zjmdp
有个设想就是通过注释或者注解描述Rest API，通过工具自动生成API描述文档，每次git commit后自动update文档，使得文档始终保持最新，减少后台和终端之间的沟通成本，不知道Tornado下是否有类似的解决方案？大概google了一把没看到靠谱的方案
7564 次点击
所在节点    程序员
12 条回复
loading
2015-01-20 16:50:45 +08:00
这是python的事，修改下搜索关键字！
zjmdp
2015-01-20 17:09:31 +08:00
@loading 哈哈，也属于程序员的事呀
haoba
2015-01-20 17:14:54 +08:00
@zjmdp 这位先生说的莫不是Sphnix ？
haoba
2015-01-20 17:21:17 +08:00
swagger 好像更好一些。
otmb
2015-01-20 17:34:00 +08:00
听说ror完爆tonardo，真是这样么？
binux
2015-01-20 18:39:33 +08:00
这有什么难的，自己写一个呗

zjmdp
2015-01-20 18:40:06 +08:00
@otmb 我也喜欢ruby，担心ruby程序员不太好找
Fikhtengol
2015-01-20 19:00:01 +08:00
torrnado性能完爆ror 会告诉你吗
zjmdp
2015-01-20 19:04:32 +08:00
@haoba 嗯，这个方案看上去可以，是个通用方案，先研究下
otmb
2015-01-21 02:08:52 +08:00
@zjmdp python程序员好找么?
joshyu8
2016-05-31 14:38:01 +08:00
@binux , 你的工具看起来很不错，有开源吗？
Wichna
2016-06-08 13:37:22 +08:00
比较好的方式是 Swagger

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

https://www.v2ex.com/t/163880

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

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

© 2021 V2EX