Skip to content

Commit

Permalink
[3.11] gh-93433: Fix dis doc example output (GH-93434) (GH-93460)
Browse files Browse the repository at this point in the history
(cherry picked from commit debf4c1)
  • Loading branch information
Fidget-Spinner committed Jun 3, 2022
1 parent 1d2b766 commit 74b91b1
Showing 1 changed file with 19 additions and 11 deletions.
30 changes: 19 additions & 11 deletions Doc/library/dis.rst
Expand Up @@ -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
Expand Down Expand Up @@ -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`:

>>> dis.dis(myfunc)
1 0 RESUME 0
.. doctest::

2 2 PUSH_NULL
4 LOAD_GLOBAL 1 (NULL + len)
6 LOAD_FAST 0 (alist)
8 PRECALL 1
10 CALL 1
12 RETURN_VALUE
>>> dis.dis(myfunc)
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).

Expand Down Expand Up @@ -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
Expand Down

0 comments on commit 74b91b1

Please sign in to comment.