精确地：适用于Python的Matcher库

精确地允许您编写精确的断言，以便仅测试您真正感兴趣的行为。这使读者可以更清楚地了解预期的行为，并使测试不那么脆弱。这还可以生成更好的错误消息断言失败时受Hamcrest的启发。

例如，假设我们要确保一个唯一函数从列表中删除重复项，我们可以编写如下测试：

从精确导入assert_that，contains_exactly def test_unique_removes_duplicates（）：结果=唯一（[＆＃34; a＆＃34 ;、＆＃34; a＆＃34 ;、＆＃34; b＆＃34 ;、＆＃34; a＆＃34 ;，＆＃34; b＆＃34;]）assert_that（结果，contains_exactly（＆＃34; a＆＃34 ;,＆＃34; b＆＃34;））

只要结果包含＆＃34; a＆＃34 ;，声明就会通过。和＆＃34; b＆＃34;不同于断言结果== [＆＃34; a＆＃34 ;,＆＃34; b＆＃34;]，我们的断言忽略元素的顺序。当以下情况时，此方法很有用：

如果唯一声明了特定的顺序，则我们将测试实现而不是合同。

订单是在唯一性合同中指定的，但订单是在单独的测试用例中进行测试的。

当断言失败时，错误消息将不仅仅是更详细地描述失败，而不仅仅是声明两个值不相等。例如，如果unique具有值[＆＃34; a＆＃34 ;,＆＃ 34; a＆＃34;，＆＃34; b＆＃34;]，我们会收到失败消息：

预期：以任意顺序包含的可迭代：*＆＃39; a＆＃39; *＆b＆＃39;但是：有额外的元素：*＆＃39; a＆＃39;

许多匹配器由其他匹配器组成。如果给它们一个值而不是一个匹配器，则该值将被包装在equal_to（）中，例如has_attrs（name =＆＃34; bob＆＃34;）等同于has_attrs（名称= equal_to（＆bob＆＃34;））。

has_attr（attribute_name，matcher）：如果具有指定的属性，则匹配一个值。当属性名称为常数时，通常认为has_attrs更惯用，例如，代替：

assert_that（结果，contains_exactly（＆＃34; a＆＃34 ;,＆＃34; b＆＃34;））＃匹配[＆＃34; a＆＃34 ;、＆＃34; b＆＃34;]和[＆＃ 34; b＆＃34;，＆＃34; a＆＃34;]，但不是[[## a＆＃34;，＆＃34; a＆＃34;，＆＃34; b＆＃34;] ＆＃34; a＆＃34;]或[＆＃34; a＆＃34 ;、＆＃34; b＆＃34 ;、＆＃34; c＆＃34;]

is_sequence（* args）：如果一个元素具有相同的顺序，则匹配一个iterable，例如：

assert_that（result，is_sequence（＆＃34; a＆＃34 ;,＆＃34; b＆＃34;））＃匹配[＆＃34; a＆＃34 ;,＆＃34; b＆＃34;]＃但不匹配[ ＆＃34; a＆＃34;]或[＆＃34; a＆＃34 ;、＆＃34; b＆＃34 ;、＆＃34; c＆＃34;]或[＆ ＃34; c＆＃34;，＆＃34; a＆＃34;，＆＃34; b＆＃34;]

assert_that（结果，包括（＆＃34; a＆＃34 ;、＆＃34; b＆＃34;））＃匹配[＆＃34; a＆＃34 ;、＆＃34; b＆＃34;]，[＆＃ 34; b＆＃34;，＆＃34; a＆＃34;]和[＆＃34; a＆＃34;，＆＃34; c＆＃34;，＆＃34; b＆＃34;]＃而非[＆ ＃34; a＆＃34;，＆＃34; c＆＃34;]或[＆＃34; a＆＃34;] assert_that（结果，包括（＆＃34; a＆＃34 ;、＆＃34; a＆＃34 ;））＃匹配[＆＃34; a＆＃34 ;,＆＃34; a＆＃34;]和[＆＃34; a＆＃34 ;、＆＃34; a＆＃34 ;、＆＃34; a＆＃ 34;]＃，但不是[＆＃34; a＆＃34;]

is_mapping（matchers）：如果映射具有相同的键和匹配的值，则匹配一个映射，例如dict。如果该映射缺少任何键或具有任何额外的键，则会引发错误，例如：

mapping_includes（matchers）：如果映射具有相同的键和匹配的值，则匹配一个映射，例如dict。如果该映射缺少任何键，但允许额外的键，则会引发错误，例如：

assert_that（result，mapping_includes（{＆＃34; a＆＃34 ;: equal_to（1），＆＃34; b＆＃34 ;: equal_to（4），}））＃匹配{＆＃34; a＆＃34 ;: 1，＆＃34; b＆＃34 ;: 4}和{＆＃34; a＆＃34 ;: 1，＆＃34; b＆＃34 ;: 4，4，＆＃34; c＆＃34 ;: 5}＃但不是{＆＃34; a＆＃34 ;: 1}也不是{＆＃34; a＆＃34 ;: 1，＆＃34; b＆＃34 ;: 5}

为了清楚起见，它通常有助于将has_feature的使用提取到其自己的函数中：

PyHamcrest是匹配器的另一个Python实现。我更喜欢该项目产生的错误消息，但可以自行判断：

＃准确地从精确导入assert_that，is_sequence，has_attrs assert_that（[User（＆＃34; bob＆＃34 ;,＆＃34; [email protected]"），User（＆＃34; jim＆＃34;，＆ ＃34; [email protected]"），]，is_sequence（has_attrs（用户名=＆＃34; bob＆＃34 ;、电子邮件地址=＆＃34; [email protected]"），has_attrs（用户名= ＆＃34; jim＆＃34 ;, email_address =＆＃34; [email protected]"），））＃预期的：可迭代的包含顺序：＃0：属性：＃*用户名：＆＃39; bob＆＃ 39; ＃* email_address：＆＃39; [email protected]' ＃1：属性：＃*用户名：＆＃39; jim＆＃39; ＃* email_address：＆＃39; [email protected]' ＃但是：索引0处的元素不匹配：＃*属性email_address：是＆＃39; [email protected]' ＃hamcrest从hamcrest导入assert_that，包含has_properties assert_that（[User（＆＃34; bob＆＃34 ;,＆＃34; [email protected]"），User（＆＃34; jim＆＃34 ;,＆ ＃34; [email protected]"），]，包含（has_properties（用户名=＆＃34; bob＆＃34 ;、电子邮件地址=＆＃34; [email protected]"），has_properties（用户名= ＆＃34; jim＆＃34 ;, email_address =＆＃34; [email protected]"），））＃Hamcrest错误：＃预期值：包含[（具有属性＆＃39; username＆＃的对象的对象的序列39;匹配＆＃39; bob＆＃39;和具有&&＃39; email_address＆＃39;匹配＆＃39; [email protected]'的对象）（具有＆＃39;用户名＆＃39;匹配＆＃39; jim＆＃39;和对象的属性＆＃39; email_address＆＃39;匹配＆＃39; [email protected]'）]＃但：项目0：对象具有属性＆＃39; email_address＆＃39;匹配＆＃39; [email protected]'财产＆＃39;电子邮件地址＆＃39;是＆＃39; [email protected]'