pytest + yaml 框架 -14.钉钉机器人通知测试结果

前言

当用例执行完成后,希望能给报告反馈,常见的报告反馈有:邮箱/钉钉群/飞书/企业微信 等。
pip 安装插件

pip install pytest-yaml-yoyo

钉钉机器人通知测试结果功能在v1.1.1版本实现

钉钉机器人设置

钉钉机器人的设置请参考官方API文档https://open.dingtalk.com/document/group/custom-robot-access

我们主要得到Webhook地址上面的access_token 值
pytest + yaml 框架 -14.钉钉机器人通知测试结果_第1张图片

自定义关键字,默认:测试报告,也可以自定义

pytest + yaml 框架 -14.钉钉机器人通知测试结果_第2张图片

加签 的值,可以不勾选,也可以勾选。

总的来说,需要记住3个地方:

  • access_token 复制Webhook地址上面的access_token 值
  • 自定义关键字 默认:测试报告,也可以自定义其他名称,如果这里改了,后面的配置的title值也要改成一样
  • 加签 的值,可以不勾选,也可以勾选。如果勾选了,后面需配置secret 值

config 中配置 DING_TALK 项

在config 中配置 DING_TALK, 只有 access_token 值是必须项, 如果配置了 DING_TALK ,那么就会自动启动发送钉钉机器人通知。
如果不启动钉钉机器人通知测试报告,那么把此项注掉即可。

class Config:
    version = "v1.0"


class TestConfig(Config):
    """测试环境"""
    BASE_URL = 'http://127.0.0.1:8000'
    # 钉钉群机器人通知
    DING_TALK = {
        "access_token": "d2433d2b16cc85*************************************",
    }


class UatConfig(Config):
    """联调环境"""
    BASE_URL = 'http://192.168.1.1:8001'



# 环境关系映射,方便切换多环境配置
env = {
    "test": TestConfig,
    "uat": UatConfig
}

在pytest.ini 中配置

[pytest]


env = test

DING_TALK 相关参数说明

  • access_token: 钉钉群自定义机器人access_token
  • secret: 机器人安全设置页面勾选"加签"时需要传入的密钥
  • param pc_slide: 消息链接打开方式,默认False为浏览器打开,设置为True时为PC端侧边栏打开
  • param fail_notice: 消息发送失败提醒,默认为False不提醒,开发者可以根据返回的消息发送结果自行判断和处理
  • param title: 首屏会话透出的展示内容
  • param text: markdown格式的消息内容
  • param is_at_all: @所有人:True,否则为:False(可选), 默认False
  • param at_mobiles: 被@人的手机号, 手机号可以是一个或者多个,写到list
  • param at_dingtalk_ids: 被@用户的UserId(企业内部机器人可用,可选),可以是一个或者多个,写到list
  • param is_auto_at: 是否自动在text内容末尾添加@手机号,默认自动添加,也可设置为False,然后自行在text内容中自定义@手机号的位置,才有@效果,支持同时@多个手机号(可选)

运行用例后会自动在钉钉群发送通知

pytest + yaml 框架 -14.钉钉机器人通知测试结果_第3张图片

加签值配置

如果这里没有勾选 加签 值
pytest + yaml 框架 -14.钉钉机器人通知测试结果_第4张图片
那么只需要配置一个 access_token 即可

DING_TALK = {
        "access_token": "d2433d2b16cc85943*********************************",
    }

如果这里勾选 加签 值, 那么需同时配置 access_token 和 secret 值

DING_TALK = {
        "access_token": "d2433d2b16cc85943*********************************",
        "secret": "**************************"
    }

设置@指定的人

奈特指定的人有3个配置可以选择

  • is_at_all @所有人:True,否则为:False(可选)
  • at_mobiles: 被@人的手机号,可以是一个或者多个,写到list
  • at_dingtalk_ids: 被@用户的UserId(企业内部机器人可用,可选),可以是一个或者多个,写到list

使用示例

 DING_TALK = {
        "access_token": "d2433d2b16c*******************",
        "at_mobiles": ["15000xxxxxxx", "15001xxxxxxx"]
    }

于是就可以看到上图的效果,在内容后面带上@张三的样式

设置 title 和 内容

title 的名称必须与自定义关键字名称保持一致
pytest + yaml 框架 -14.钉钉机器人通知测试结果_第5张图片

 DING_TALK = {
        "access_token": "d2433d2b16cc859******************",
        "title": "测试报告",
        "at_mobiles": ["15000xxxxxxx", "15001xxxxxxx"]
    }

报告的text 内容, 也就是我们看到的

执行结果:

- 运行环境: test
- 运行base_url: http://127.0.0.1:8000
- 持续时间:  0.37 秒

本次运行结果:

- 总用例数: 3
- 通过用例:3
- 失败用例: 0
- 异常用例: 0
- 通过率: 100.0 %

text 的内容,默认是上面的这些,支持markdown 文档格式,如果你需要添加额外的内容,比如加上allure报告地址,那么可以用 text 字段追加内容

 DING_TALK = {
        "access_token": "d2433d2b16cc***************************",
        "title": "测试报告",
        "at_mobiles": ["15000xxxxxxx", "15001xxxxxxx"],
        "text": ""text": "- 查看报告:[allure报告地址](https://www.cnblogs.com/yoyoketang/)""
    }

把上面的https://www.cnblogs.com/yoyoketang/ 换成你自己的allure报告地址即可

于是看到以下的效果

pytest + yaml 框架 -14.钉钉机器人通知测试结果_第6张图片

总的来说,整个配置都是傻瓜式的,配置非常简单。

你可能感兴趣的:(pytest,机器人,pytest,钉钉)