Skip to content

Auto generate doc file by request parameter and response body.

License

Notifications You must be signed in to change notification settings

kongxinchi/request2doc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

request2doc

Auto generate doc file by request parameter and response body. 

自动根据发送的请求生成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 https://any/get/url?key1=value1&key2=value2
python request2doc.py -d "key1=value1&key2=value2" https://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

About

Auto generate doc file by request parameter and response body.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published