1berry/cpython
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

gh-93433: Fix dis doc example output (GH-93434)

Browse Source
This commit is contained in:
Ken Jin 2022-06-03 18:02:58 +08:00 committed by GitHub
parent b9509ba7a9
commit debf4c1ec5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Doc/library/dis.rst
View File

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