Skip to content

[3.11] gh-106446: Fix failed doctest in stdtypes (GH-106447) #106742

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
terryjreedy merged 2 commits into from
Jul 14, 2023
Merged

[3.11] gh-106446: Fix failed doctest in stdtypes (GH-106447) #106742

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
87ba4cf
gh-106446: Fix failed doctest in stdtypes (#106447)
terryjreedy Jul 14, 2023
f1359be
[3.11] gh-106446: Fix failed doctest in stdtypes (GH-106447)
terryjreedy Jul 14, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
gh-106446: Fix failed doctest in stdtypes (#106447) 
---------
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

(cherry picked from commit 89867d2)
  • Loading branch information
@terryjreedy
terryjreedy committed Jul 14, 2023
commit 87ba4cfe84e3bc4f5041e061bc3fba5ec0fb9b01
35 changes: 20 additions & 15 deletions Doc/library/stdtypes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3903,7 +3903,7 @@ copying.
>>> m = memoryview(bytearray(b'abc'))
>>> mm = m.toreadonly()
>>> mm.tolist()
[89, 98, 99]
[97, 98, 99]
>>> mm[0] = 42
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
Expand Down Expand Up @@ -3959,6 +3959,7 @@ copying.
:mod:`struct` syntax. One of the formats must be a byte format
('B', 'b' or 'c'). The byte length of the result must be the same
as the original length.
Note that all byte lengths may depend on the operating system.

Cast 1D/long to 1D/unsigned bytes::

Expand Down Expand Up @@ -3989,8 +3990,8 @@ copying.
>>> x = memoryview(b)
>>> x[0] = b'a'
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: memoryview: invalid value for format "B"
...
TypeError: memoryview: invalid type for format 'B'
>>> y = x.cast('c')
>>> y[0] = b'a'
>>> b
Expand Down Expand Up @@ -4735,8 +4736,10 @@ An example of dictionary view usage::
>>> # set operations
>>> keys & {'eggs', 'bacon', 'salad'}
{'bacon'}
>>> keys ^ {'sausage', 'juice'}
{'juice', 'sausage', 'bacon', 'spam'}
>>> keys ^ {'sausage', 'juice'} == {'juice', 'sausage', 'bacon', 'spam'}
True
>>> keys | ['juice', 'juice', 'juice'] == {'bacon', 'spam', 'juice'}
True

>>> # get back a read-only proxy for the original dictionary
>>> values.mapping
Expand Down Expand Up @@ -4943,8 +4946,8 @@ exception to disallow mistakes like ``dict[str][str]``::

>>> dict[str][str]
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: There are no type variables left in dict[str]
...
TypeError: dict[str] is not a generic class

However, such expressions are valid when :ref:`type variables <generics>` are
used. The index must have as many elements as there are type variable items
Expand Down Expand Up @@ -5150,13 +5153,15 @@ enables cleaner type hinting syntax compared to :data:`typing.Union`.
>>> isinstance("", int | str)
True

However, union objects containing :ref:`parameterized generics
<types-genericalias>` cannot be used::
However, :ref:`parameterized generics <types-genericalias>` in
union objects cannot be checked::

>>> isinstance(1, int | list[int])
>>> isinstance(1, int | list[int]) # short-circuit evaluation
True
>>> isinstance([1], int | list[int])
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: isinstance() argument 2 cannot contain a parameterized generic
...
TypeError: isinstance() argument 2 cannot be a parameterized generic

The user-exposed type for the union object can be accessed from
:data:`types.UnionType` and used for :func:`isinstance` checks. An object cannot be
Expand Down Expand Up @@ -5472,7 +5477,7 @@ types, where they are relevant. Some of these are not reported by the
definition order. Example::

>>> int.__subclasses__()
[<class 'bool'>]
[<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, <class 're._constants._NamedIntConstant'>]


.. _int_max_str_digits:
Expand Down Expand Up @@ -5508,15 +5513,15 @@ When an operation would exceed the limit, a :exc:`ValueError` is raised:
>>> _ = int('2' * 5432)
Traceback (most recent call last):
...
ValueError: Exceeds the limit (4300 digits) for integer string conversion: value has 5432 digits; use sys.set_int_max_str_digits() to increase the limit.
ValueError: Exceeds the limit (4300 digits) for integer string conversion: value has 5432 digits; use sys.set_int_max_str_digits() to increase the limit
>>> i = int('2' * 4300)
>>> len(str(i))
4300
>>> i_squared = i*i
>>> len(str(i_squared))
Traceback (most recent call last):
...
ValueError: Exceeds the limit (4300 digits) for integer string conversion: value has 8599 digits; use sys.set_int_max_str_digits() to increase the limit.
ValueError: Exceeds the limit (4300 digits) for integer string conversion; use sys.set_int_max_str_digits() to increase the limit
>>> len(hex(i_squared))
7144
>>> assert int(hex(i_squared), base=16) == i*i # Hexadecimal is unlimited.
Expand Down