`times` argument of `itertools.repeat()` accepts a negative number and doesn't accept `None`

[hyperkai]

Bug report

Bug description:

times argument of itertools.repeat() accepts a negative number as shown below:

from itertools import repeat
                               # ↓↓↓↓
v = repeat(object='Hello', times=-100)

So, error should be raised like below:

ValueError: times must be 0 <= x

And, times argument doesn't accept None as shown below so None should be accepted:

from itertools import repeat

v = repeat(object='Hello', times=None)
# TypeError: 'NoneType' object cannot be interpreted as an integer

CPython versions tested on:

3.13

Operating systems tested on:

Windows

[skirpichev]

times argument of itertools.repeat() accepts a negative number as shown below:

Why not? range also accepts negative stop argument:

>>> list(range(-10))
[]
>>> import itertools
>>> list(itertools.repeat('a', 2))
['a', 'a']
>>> list(itertools.repeat('a', -2))
[]

And, times argument doesn't accept None as shown below

Example below is just an illustration. It's not API description.

Rather, function signature should be described like for range:

.. function:: repeat(object)
              repeat(object, times)

[skirpichev]

I opened a discussion thread: https://discuss.python.org/t/how-to-document-callables-with-multiple-signatures/95015

Meanwhile, this will be closed, as we don't have rules for functions with multiple signatures.