生成 API 说明文档 request2doc

码农软件 · 软件分类 · 其他开发相关 · 2019-10-17 14:13:52

授权协议: MIT
开发语言: PHP
操作系统: 跨平台
软件首页: https://github.com/kongxinchi/request2doc
软件文档: https://github.com/kongxinchi/request2doc/blob/master/README.md

软件介绍

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}