miaou 0.2.2

selenium

使用 selenium 4.8.0 版本以上，默认使用 chromedriver，可根据你的 Chrome 版本，在 chromedriver 下载，并 添加到 path 中。如果要使用 firefox 可在参数中指定，例如

import miaou

miaou.generate(
    ...
    scanner="selenium",
    config={"driver": "firefox"},
)

api

使用禅道对应的 API 生成规格。调用时指定扫描器类型即可

import miaou

miaou.generate(
    ...
    scanner="api",
    ...
)

注意，使用此扫描器生成的规格与禅道文档有一些不同，比如禅道文档中描述的查询 testsuite 的 API 为

GET  /zentao/testsuite.json

使用 selenium 扫描器生成的规格即为

testsuite:
    method: GET
    path: testsuite

而禅道 API 查询到的格式类似于

GET  /zentao/testsuite-index.json

所以使用 api 扫描器生成的规格为

testsuite_index:
    method: GET
    path: testsuite-index

这两种 API 得到的数据是相同的，在转换成 pyzentao 方法时请以你使用的规格文件为准。

自定义扫描器

也可以自定义扫描器，从 miaou.Scanner 继承

import miaou

class MyScanner(miaou.Scanner):
    """doc string"""

    def __init__(self, config):
        ...

然后需要实现如下方法：

• open(self, site_url, username, password)

  一般是获得禅道授权

• close(self)

  清扫工作，没有就不写

• get_module_groups(self, dev_url)

  获得 API 模块页面链接，也就是 后台 - 二次开发 - API 页面左边栏 模块列表 下的那些链接。返回模块链接数组 [url…]

• get_apis(self, api_url)

  在指定的模块页面，即 api_url 中获取 API 规格，返回包含dict的数组类似 [{name, method, path, params}]

使用自定义扫描器

import miaou

miaou.generate(
    ...
    scanner=MyScanner(config),
    ...
)

另，此工具的功能仅在 Linux/Python3.10 环境下测试，使用其他环境的宝子请自娱自乐 ╮(╯▽╰)╭