]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.11] gh-93433: Fix dis doc example output (GH-93434) (GH-93460)
authorKen Jin <kenjin4096@gmail.com>
Fri, 3 Jun 2022 13:26:43 +0000 (21:26 +0800)
committerGitHub <noreply@github.com>
Fri, 3 Jun 2022 13:26:43 +0000 (21:26 +0800)
(cherry picked from commit debf4c1ec5f0bae44d50f889b8a7dc0c3ea1fc9d)

Doc/library/dis.rst

index 08e6c736d3e3c9d2510970b0638ea9b0ffeedbaa..27a2f6bf795241a98d0515cc06ee627ac8ae1efd 100644 (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`:
 
-   >>> 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).
 
@@ -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