跳转到主要内容

为Robot Framework库创建有意义且易于使用的断言的通用方法。

项目描述

Robot Framework库创建有意义且易于使用的断言的通用方法。此工具是从Browser库项目衍生出来的,其中断言引擎作为库的一部分开发。

https://github.com/MarketSquare/AssertionEngine/actions/workflows/on-push.yml/badge.svg https://img.shields.io/badge/License-Apache%202.0-blue.svg

支持的断言

当前支持的断言运算符包括

运算符

替代运算符

描述

验证等效

==

equal, equals, should be

检查返回值是否等于预期值。

value == expected

!=

inequal, should not be

检查返回值是否不等于预期值。

value != expected

>

大于

检查返回值是否大于预期值。

值 > 预期

>=

检查返回值是否大于或等于预期值。

值 >= 预期

<

小于

检查返回值是否小于预期值。

值 < 预期

<=

检查返回值是否小于或等于预期值。

值 <= 预期

*=

包含

检查返回值是否包含预期值作为子串。

预期在值中

不包含

检查返回值是否不包含预期值作为子串。

预期不在值中

^=

应该以,开始于

检查返回值是否以预期值开始。

re.search(f”^{预期}”,值)

$=

应该以,结束于

检查返回值是否以预期值结束。

re.search(f”{预期}$”,值)

匹配

检查给定的正则表达式是否至少在返回值中出现一次。

re.search(预期,值)

验证

检查给定的Python表达式是否评估为True。

评估

然后

当使用此操作符时,关键字确实返回评估的Python表达式。

支持的格式化程序

格式化程序

描述

规范空格

将值中的多个空格替换为单个空格

去除空格

从值的开始和结尾去除空格

应用于预期

也将规则应用于预期值

不区分大小写

将值转换为小写

用法

当库开发者希望在关键字调用时内联执行断言时,断言引擎提供单个关键字调用内的自动验证。关键字方法应获取值,例如来自页面、数据库或库与之交互的任何内容,然后使用断言引擎的verify_assertion方法执行验证。verify_assertion方法执行断言需要三样东西:来自系统、assertion_operator如何执行验证以及代表预期值的assertion_expected。还可以提供自定义错误消息并前缀默认错误消息。

示例库可以包含关键字

def keyword(
    arg_to_get_value: str,
    assertion_operator: Optional[AssertionOperator] = None,
    assertion_expected: Any = None,
    message: str = None,
):
    value = method_to_get_value(arg_to_get_value)
    return verify_assertion(
        value,
        assertion_operator,
        assertion_expected,
        "Prefix message",
        message,
    )

断言引擎提供了一个接口来定义格式化程序的适用范围,但由于作用域是特定于库的实现,因此由库决定如何实际实现作用域。断言引擎的格式化程序类是一个ABC,为库开发者提供了get_formatterset_formatter接口方法。断言引擎的atest库有如何实际实现接口的示例。

项目详情


下载文件

下载适合您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

robotframework_assertion_engine-3.0.3.tar.gz (11.9 kB 查看散列)

上传于 源代码

构建分发

支持者