flask+apidoc⽣成接⼝⽂档(附加⼀个坑) 具体使⽤⽅法见这⾥
挺详细的,我就不抄了。
重点是⼀个坑:
执⾏ python manager.py apidoc ⽆反应并且没有⽣成api⽂档
执⾏ apidoc -o static/docs 显⽰Nothing to do
执⾏ apidoc -o static/docs --debug 显⽰⼀堆调试信息,说明确实⼯作了,但是还是啥⽂档没有
苦思冥想之后、还是不解
但是奇迹就在我给需要⽣成⽂档的代码⽂件头部增加了⽂档字符串后出现了。。。
python将.py⽂件的开头第⼀个字符串视为⽂档字符串
如果⽂档字符串没有或者为空字符串的话,apidoc竟然不起效,具体原因不明,没有继续追究下去,留待后⼈解释
>文档字符串是什么
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论