[3.11] gh-93433: Fix dis doc example output (GH-93434) (GH-93460)

(cherry picked from commit debf4c1ec5)
This commit is contained in:
Ken Jin 2022-06-03 21:26:43 +08:00 committed by GitHub
parent 1d2b766100
commit 74b91b1763
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -6,6 +6,12 @@
**Source code:** :source:`Lib/dis.py`
.. testsetup::
import dis
def myfunc(alist):
return len(alist)
--------------
The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by
@ -37,17 +43,18 @@ Example: Given the function :func:`myfunc`::
return len(alist)
the following command can be used to display the disassembly of
:func:`myfunc`::
:func:`myfunc`:
.. doctest::
>>> dis.dis(myfunc)
1 0 RESUME 0
2 2 PUSH_NULL
4 LOAD_GLOBAL 1 (NULL + len)
6 LOAD_FAST 0 (alist)
8 PRECALL 1
10 CALL 1
12 RETURN_VALUE
2 0 RESUME 0
<BLANKLINE>
3 2 LOAD_GLOBAL 1 (NULL + len)
14 LOAD_FAST 0 (alist)
16 PRECALL 1
20 CALL 1
30 RETURN_VALUE
(The "2" is a line number).
@ -109,14 +116,15 @@ code.
.. versionchanged:: 3.11
Added the ``show_caches`` parameter.
Example::
Example:
.. doctest::
>>> bytecode = dis.Bytecode(myfunc)
>>> for instr in bytecode:
... print(instr.opname)
...
RESUME
PUSH_NULL
LOAD_GLOBAL
LOAD_FAST
PRECALL