开源中国

我们不支持 IE 10 及以下版本浏览器

It appears you’re using an unsupported browser

为了获得更好的浏览体验,我们强烈建议您使用较新版本的 Chrome、 Firefox、 Safari 等,或者升级到最新版本的IE浏览器。 如果您使用的是 IE 11 或以上版本,请关闭“兼容性视图”。
request2doc首页、文档和下载 - 生成 API 说明文档 - 开源中国社区
Float_left Icon_close
全部项目分类
我要评价
MIT
PHP 查看源码»
跨平台
konglo
分享
收藏
5 人收藏
收录时间:2017-05-14
request2doc 详细介绍

request2doc

自动根据发送的请求生成 API 说明文档。文档模板可定制,默认为 wiki markup 格式。

Require

pip install jinja2

wxpython: https://www.wxpython.org/download.php

Usage

usage: request2doc.py [-h] [-d [DATA]] [-t [TEMPLATE]] [-o [OUTPUT]]
                  [-s [SLICE_STARTSWITH]] [-b [COOKIE_JAR]]
                  [url]

positional arguments:
  url                   URL

optional arguments:
  -h, --help                                                     show this help message and exit
  -d [DATA], --data [DATA]                                       POST数据键值对, e.g. key1=value&key2=value
  -t [TEMPLATE], --template [TEMPLATE]                           模板文件路径,默认为markup.tpl
  -o [OUTPUT], --output [OUTPUT]                                 将文件输出到指定文件,默认为打印到屏幕
  -s [SLICE_STARTSWITH], --slice-startswith [SLICE_STARTSWITH]   只打印返回数据中指定域的数据, e.g. data.results
  -b [COOKIE_JAR], --cookie-jar [COOKIE_JAR]                     cookie-jar文件路径

Example

python request2doc.py http://any/get/url?key1=value1&key2=value2
python request2doc.py -d "key1=value1&key2=value2" http://any/post/url

Output

h3.teacher/homework/search
METHOD: GET
----
GET参数:
||Name||Type||Description||
| status | Int |  |
返回字段说明:
||Name||Type||Description||
| a.\* |  | 0\|1 |
| a.\*.a | Float\|Int |  |
| a.\*.b | Int\|String |  |

{code:title=返回JSON样例|collapse=true}
{
  "data": {
    "a": [
      {
        "a": 1, 
        "b": 2
      }, 
      {
        "a": 1.1, 
        "b": "string"
      }
    ]
  }, 
  "message": "", 
  "error_code": 0, 
  "success": true
}
{code}

image

GUI

image


大家对 request2doc 的评论 (全部 1 条评论)
{{repayCom.userName}}
Xiphin
归类错了,这明明就是个Python项目
顶部