基于Python语言Hamcrest断言的使用
转自：https://blog.csdn.net/dou_being/article/details/105344001
我们通常熟悉的断言是assert()系列的断言，但有的时候也不能满足我们的需求，所以有了更强大的断言Hamcrest。
一、Hamcrest简介
Hamcrest源于Java，支持多种语言，是用于编写匹配器对象的框架，可以更灵活的定义“匹配”规则。Hamcrest 断言，基于更灵活的 Matchers 断言方式。
二、Hamcrest安装
可以使用常用的python打包工具来安装Hamcrest，也可以在pycharm中安装，下面以在pycharm中安装为例。
1.打开pycharm--》Preferences--》Project Interpreter
2.在搜索框中搜索“hamcrest”，选择第一个“PyHamcrest”，然后点击安装。
三、Hamcrest示例Demo
from hamcrest import *
import unittest
class HamcrestTest(unittest.TestCase):
def testEquals(self):
theString = 'Hello Hamcrest'
myString = 'Hello Hamcrest'
assert_that(theString, equal_to(myString))
if __name__ == '__main__':
unittest.main()
关于Hamcrest断言的更多使用，可以参考官网文档：https://github.com/hamcrest/PyHamcrest。
Hamcres API
在python中pyHamcrest属于第三方库，使用时需要安装。
Hamcrest在python中提供的API：
对象
- equal_to - 匹配相等对象
- has_length - 长度匹配 len()
- has_property - 匹配给定名称的属性值
- has_properties - 匹配具有所给定属性的对象
- has_string - 匹配字符串 str()
- instance_of - 匹配对象类型
- none, not_none - 匹配none或not none
- same_instance - 匹配相同的对象
- calling, raises - 封装一个方法调用并断言它引发异常
数字
- close_to - 匹配接近给定的数字值
- greater_than, greater_than_or_equal_to, less_than, less_than_or_equal_to - 匹配数字顺序
文本
- contains_string - 匹配部分字符串
- ends_with - 匹配字符串的结尾
- equal_to_ignoring_case - 匹配完整的字符串但忽略大小写
- equal_to_ignoring_whitespace - 匹配完整的字符串，但忽略多余的空格
- matches_regexp - 使用正则表达式匹配字符串
- starts_with - 匹配字符串的开头
- string_contains_in_order - 按相对顺序匹配字符串的各个部分
逻辑
- all_of - 如果所有匹配器都匹配才匹配,像Java里的&&
- any_of - - 如果任何匹配器匹配就匹配,像Java里的||
- anything - 匹配任何东西，如果不关心特定值则在复合匹配器中很有用
- is_not, not_ -如果包装的匹配器不匹配器时匹配,反之亦然
序列
- contains - 完全匹配整个序列
- contains_inanyorder - 以任何顺序匹配整个序列
- has_item - 只要给定项目在序列中出现则匹配
- has_items - 如果所有给定项以任意顺序出现在序列中则匹配
- is_in - 在给定顺序中如果给定项出现则匹配
- only_contains - 在给定顺序中如果序列的项目出现则匹配
- empty - 如果序列为空则匹配
字典
- has_entries - 匹配具有键值对列表的字典
- has_entry - 匹配包含键值对的字典
- has_key - 使用键匹配字典
- has_value - 使用值匹配字典
装饰器
- calling - 在延迟中封装一个可调用对象，在后续的调用行为中匹配
- raises - 确保延迟调用可以按预期方式引发
- described_as - 添加一个定制的失败表述装饰器
- is_ - 改进可读性装饰器
这些匹配器中的许多参数不仅接受匹配值，还接受另一个匹配器，因此可以组合匹配器以提高灵活性。 例如，only_contains（less_than（5））将匹配每个小于5项目的任何序列。
from hamcrest import * #数字类型 print(0.1*0.1) #0.010000000000000002 print(assert_that(0.1 * 0.1, close_to(0.01,0.000000000000001))) #close_to(预期比较的值，数字所对应的值之间最大差值被认为是接近的) print(assert_that(0.1 * 0.1, greater_than(0.01))) #大于 print(assert_that(0.1 * 0.1, greater_than_or_equal_to(0.01))) #大于或等于 print(assert_that(0.1 * 0.1, less_than(0.02))) #小于 print(assert_that(0.1 * 0.1, less_than_or_equal_to(0.02))) #小于或等于 #逻辑 print('***********逻辑*********') print(assert_that(["a", "b", "c"],all_of(has_items("b", "a"),has_items("c", "a")))) #如果所有匹配器都匹配才匹配,匹配上 print(assert_that(["a", "b", "c"],any_of(has_items("d", "a"),has_items("c", "a")))) #有一个匹配上，就是匹配上 print(assert_that(["a", "b", "c"],is_not("a"))) #如果包装的匹配器不匹配器时匹配,反之亦然 print(assert_that(["a", "b", "c"],is_not(equal_to("a")))) #如果包装的匹配器不匹配器时匹配,反之亦然 print(assert_that(["a", "b", "c"],not_(["a", "b"]))) #如果包装的匹配器不匹配器时匹配,反之亦然 print(assert_that(["a", "b", "c"],anything(1))) #匹配任何东西，如果不关心特定值则在复合匹配器中很有用
返回结果：
0.010000000000000002
None
None
None
None
None
***********逻辑*********
None
None
None
None
None
None
