Docs: problem with page "unittest — Unit testing framework"

[Hanse00]

Documentation

The page at https://docs.python.org/3/library/unittest.html briefly describes assertCountEqual(a, b) as checking:

a and b have the same elements in the same number, regardless of their order.

To me (Admittedly as a non-English first language speaker) it wasn't immediately obvious what was meant by "in the same number".

I think a clearer phrasing might be a and b have the same elements in the same quantities or a and b have the same numbers of the same elements or something like that.

Open to discussion, also open to being told I'm just bad at reading 😄 But I think we could phrase ourselves a bit clearer.

Linked PRs

• gh-148186: Improve assertCountEqual description in docs. #148463

[ericvsmith]

The sentence at https://docs.python.org/3/library/unittest.html#unittest.TestCase.assertCountEqual is: Test that sequence first contains the same elements as second, regardless of their order. So maybe a contains the same elements as b, regardless of their order.