[docs] [issue24653] Mock.assert_has_calls([]) is surprising for users

Inada Naoki report at bugs.python.org
Wed May 22 06:00:21 EDT 2019


Inada Naoki <songofacandy at gmail.com> added the comment:

> I opened the bug because we have evidence that users find the current documentation confusing. Saying that its not confusing to us doesn't fix the confusion.

Is there evidence people get confused by the document?

I suppose people get confused because they guessed behavior from existing assert_has_calls usages, without reading docs.
If they guess without reading doc, adding anything in doc doesn't help them.

The document describe well it tests inclusion, not equality.  There are no confusion about it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24653>
_______________________________________


More information about the docs mailing list