python中的assertEquals和assertEqual

在python unittest.TestCase中,assertEqualsassertEqual之间有区别吗?

如果没有,为什么有两个函数?只是为了方便?

78826 次浏览

我没有在http://docs.python.org/library/unittest.html中找到任何提到assertEquals。然而,当我导入TestCase并执行“帮助(TestCase)”时,它会被列出。我认为这只是方便的同义词。

实际上,在Python 2.6中,assertEqualassertEquals都是failUnlessEqual的别名。资料来源是这样声明的:

# Synonyms for assertion methods
assertEqual = assertEquals = failUnlessEqual

Python 3中,根据你的观点,failUnlessEqual被明确地弃用了。assertEquals带有这样的注释:-)

# Synonyms for assertion methods
# The plurals are undocumented.  Keep them that way to discourage use.
# Do not add more.  Do not remove.
# Going through a deprecation cycle on these would annoy many people.

因此,结果似乎是你可以在Python 2中使用任何你喜欢的。x,但对于Python 3倾向于assertEqual

我认为这是“只有一种明显的方法”和“只有一种明显的方法”之间的紧张关系。“别名使整个代码语义化”。就我个人而言,我喜欢阅读

failIf(some_condition)

assertFalse(some_condition)

但是很喜欢

assertEqual(a, b)

而不是其他两个(assertEquals(a, b)困扰我的语法感)。

“只有一种明显的方法可以做到这一点”已经优先于未来。

3.3更新:From 26.3.7.1.1. 弃用别名:

由于历史原因,一些TestCase方法有一个或多个别名,现在已弃用。下表列出了正确的名称及其不推荐使用的别名:

Method Name   | Deprecated alias | Deprecated alias
--------------+------------------+-----------------
assertEqual() | failUnlessEqual  | assertEquals
...

不仅仅是Python 3。x,因为Python 2.7 assertEquals也已弃用:

Method Name            | Deprecated alias(es)
_________________________________________________________
assertEqual()          | failUnlessEqual, assertEquals

25.3.7.1.1. 弃用别名

我知道它没有回答具体的问题,但如果你在这里搜索:

using deprecated method assertEquals()

您只需要将调用更改为.assertEqual()(删除equalS中的's')