xdis 6.1.2__py313-none-any.whl

xdis/.gitignore

@@ -0,0 +1,3 @@
+/.coverage
+/.mypy_cache
+/.python-version

xdis/__init__.py

@@ -0,0 +1,290 @@
+"""
+  Copyright (c) 2015-2017, 2020-2024 by Rocky Bernstein
+  Copyright (c) 2000 by hartmut Goebel <h.goebel@crazy-compilers.com>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License
+  as published by the Free Software Foundation; either version 2
+  of the License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+  NB. This is not a masterpiece of software, but became more like a hack.
+  Probably a complete rewrite would be sensefull. hG/2000-12-27
+"""
+
+__docformat__ = "restructuredtext"
+
+# Export various things from the modules
+
+from xdis.bytecode import (
+    Bytecode,
+    get_instructions_bytes,
+    list2bytecode,
+    next_offset,
+    offset2line,
+    op_has_argument,
+)
+from xdis.codetype import (
+    Code2,
+    Code3,
+    Code13,
+    Code15,
+    Code38,
+    Code310,
+    Code311,
+    Code313,
+    codeType2Portable,
+)
+from xdis.codetype.base import code_has_star_arg, code_has_star_star_arg, iscode
+from xdis.cross_dis import (
+    code_info,
+    extended_arg_val,
+    findlabels,
+    findlinestarts,
+    format_code_info,
+    get_code_object,
+    get_jump_target_maps,
+    instruction_size,
+    op_size,
+    pretty_flags as pretty_code_flags,
+    show_code,
+)
+from xdis.disasm import (
+    disassemble_file,
+    disco_loop,
+    disco_loop_asm_format,
+    get_opcode,
+    show_module_header,
+)
+from xdis.instruction import Instruction
+from xdis.lineoffsets import (
+    LineOffsetInfo,
+    LineOffsets,
+    LineOffsetsCompact,
+    lineoffsets_in_file,
+    lineoffsets_in_module,
+)
+from xdis.load import (
+    check_object_path,
+    is_bytecode_extension,
+    is_pypy,
+    is_python_source,
+    load_file,
+    load_module,
+    load_module_from_file_object,
+    write_bytecode_file,
+)
+from xdis.magics import (
+    PYTHON_MAGIC_INT,
+    canonic_python_version,
+    int2magic,
+    magic2int,
+    sysinfo2magic,
+)
+from xdis.op_imports import get_opcode_module
+from xdis.opcodes import (
+    opcode_13,
+    opcode_14,
+    opcode_15,
+    opcode_22,
+    opcode_23,
+    opcode_24,
+    opcode_25,
+    opcode_26,
+    opcode_27,
+    opcode_30,
+    opcode_31,
+    opcode_32,
+    opcode_33,
+    opcode_34,
+    opcode_35,
+    opcode_36,
+    opcode_37,
+    opcode_38,
+    opcode_39,
+    opcode_310,
+    opcode_311,
+)
+from xdis.util import (
+    CO_ABSOLUTE_IMPORT,
+    CO_ASYNC_GENERATOR,
+    CO_COROUTINE,
+    CO_FUTURE_ANNOTATIONS,
+    CO_FUTURE_BARRY_AS_DBFL,
+    CO_FUTURE_DIVISION,
+    CO_FUTURE_GENERATOR_STOP,
+    CO_FUTURE_PRINT_FUNCTION,
+    CO_FUTURE_UNICODE_LITERALS,
+    CO_FUTURE_WITH_STATEMENT,
+    CO_GENERATOR,
+    CO_GENERATOR_ALLOWED,
+    CO_ITERABLE_COROUTINE,
+    CO_NESTED,
+    CO_NEWLOCALS,
+    CO_NOFREE,
+    CO_OPTIMIZED,
+    CO_VARARGS,
+    CO_VARKEYWORDS,
+    COMPILER_FLAG_BIT,
+    COMPILER_FLAG_NAMES,
+    PYPY_COMPILER_FLAG_NAMES,
+    co_flags_is_async,
+    code2num,
+)
+
+# This ensures __version__ will appear in pydoc
+from xdis.version import __version__  # noqa
+from xdis.version_info import (
+    IS_GRAAL,
+    IS_PYPY,
+    PYTHON3,
+    PYTHON_VERSION_STR,
+    PYTHON_VERSION_TRIPLE,
+)
+
+__all__ = [
+    # bytecode
+    "Bytecode",
+    "get_instructions_bytes",
+    "list2bytecode",
+    "next_offset",
+    "offset2line",
+    "op_has_argument",
+    # codetype
+    "CO_ABSOLUTE_IMPORT",
+    "CO_ASYNC_GENERATOR",
+    "CO_COROUTINE",
+    "CO_FUTURE_ANNOTATIONS",
+    "CO_FUTURE_BARRY_AS_DBFL",
+    "CO_FUTURE_DIVISION",
+    "CO_FUTURE_GENERATOR_STOP",
+    "CO_FUTURE_PRINT_FUNCTION",
+    "CO_FUTURE_UNICODE_LITERALS",
+    "CO_FUTURE_WITH_STATEMENT",
+    "CO_GENERATOR",
+    "CO_GENERATOR_ALLOWED",
+    "CO_ITERABLE_COROUTINE",
+    "CO_NESTED",
+    "CO_NEWLOCALS",
+    "CO_NOFREE",
+    "CO_OPTIMIZED",
+    "CO_VARARGS",
+    "CO_VARKEYWORDS",
+    "Code13",
+    "Code15",
+    "Code2",
+    "Code3",
+    "Code310",
+    "Code311",
+    "Code313",
+    "Code38",
+    "code_has_star_star_arg",
+    "code_has_star_arg",
+    "codeType2Portable",
+    "iscode",
+    # cross_dis
+    "code_info",
+    "extended_arg_val",
+    "findlinestarts",
+    "findlabels",
+    "format_code_info",
+    "get_code_object",
+    "get_jump_target_maps",
+    "instruction_size",
+    "pretty_code_flags",
+    "op_size",
+    "show_code",
+    # disasm
+    "get_opcode",
+    "show_module_header",
+    "disco_loop",
+    "disco_loop_asm_format",
+    "disassemble_file",
+    # load
+    "check_object_path",
+    "is_bytecode_extension",
+    "is_pypy",
+    "is_python_source",
+    "load_file",
+    "load_module",
+    "load_module_from_file_object",
+    "write_bytecode_file",
+    # lineoffsets
+    "LineOffsetInfo",
+    "LineOffsets",
+    "LineOffsetsCompact",
+    "lineoffsets_in_file",
+    "lineoffsets_in_module",
+    # instruction
+    "Instruction",
+    # magic
+    "canonic_python_version",
+    "int2magic",
+    "magic2int",
+    "PYTHON_MAGIC_INT",
+    "sysinfo2magic",
+    # opcodes
+    "opcode_13",
+    "opcode_14",
+    "opcode_15",
+    "opcode_22",
+    "opcode_23",
+    "opcode_24",
+    "opcode_25",
+    "opcode_26",
+    "opcode_27",
+    "opcode_30",
+    "opcode_31",
+    "opcode_32",
+    "opcode_33",
+    "opcode_34",
+    "opcode_35",
+    "opcode_36",
+    "opcode_37",
+    "opcode_38",
+    "opcode_39",
+    "opcode_310",
+    "opcode_311",
+    # op_imports
+    "get_opcode_module",
+    # util
+    "COMPILER_FLAG_BIT",
+    "COMPILER_FLAG_NAMES",
+    "CO_ABSOLUTE_IMPORT",
+    "CO_ASYNC_GENERATOR",
+    "CO_COROUTINE",
+    "CO_FUTURE_ANNOTATIONS",
+    "CO_FUTURE_BARRY_AS_DBFL",
+    "CO_FUTURE_DIVISION",
+    "CO_FUTURE_GENERATOR_STOP",
+    "CO_FUTURE_PRINT_FUNCTION",
+    "CO_FUTURE_UNICODE_LITERALS",
+    "CO_FUTURE_WITH_STATEMENT",
+    "CO_GENERATOR",
+    "CO_GENERATOR_ALLOWED",
+    "CO_ITERABLE_COROUTINE",
+    "CO_NESTED",
+    "CO_NEWLOCALS",
+    "CO_NOFREE",
+    "CO_OPTIMIZED",
+    "CO_VARARGS",
+    "CO_VARKEYWORDS",
+    "PYPY_COMPILER_FLAG_NAMES",
+    "code2num",
+    "co_flags_is_async",
+    # version_info
+    "IS_GRAAL",
+    "IS_PYPY",
+    "PYTHON3",
+    "PYTHON_VERSION_STR",
+    "PYTHON_VERSION_TRIPLE",
+    "__version__",
+]

xdis/__main__.py

@@ -0,0 +1,28 @@
+"""
+  Copyright (c) 2015-2017, 2020-2021, 2024 by Rocky Bernstein
+  Copyright (c) 2000 by hartmut Goebel <h.goebel@crazy-compilers.com>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License
+  as published by the Free Software Foundation; either version 2
+  of the License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+
+  NB. This is not a masterpiece of software, but became more like a hack.
+  Probably a complete rewrite would be sensefull. hG/2000-12-27
+"""
+import sys
+
+from xdis.disasm import disassemble_file
+
+if __name__ == "__main__" and len(sys.argv) > 1:
+    for path in sys.argv[1:]:
+        disassemble_file(path, sys.stdout)

xdis/bin/pydisasm.py

@@ -0,0 +1,86 @@
+# Mode: -*- python -*-
+# Copyright (c) 2015-2021 by Rocky Bernstein <rb@dustyfeet.com>
+#
+# Note: we can't start with #! because setup.py bdist_wheel will look for that
+# and change that into something that's not portable. Thank you, Python!
+#
+#
+from __future__ import print_function
+
+import os
+import os.path as osp
+import sys
+
+import click
+
+from xdis import disassemble_file
+from xdis.version import __version__
+from xdis.version_info import PYTHON_VERSION_STR, PYTHON_VERSION_TRIPLE
+
+program, ext = os.path.splitext(os.path.basename(__file__))
+
+PATTERNS = ("*.pyc", "*.pyo")
+
+if click.__version__ >= "7.":
+    case_sensitive = {"case_sensitive": False}
+else:
+    case_sensitive = {}
+
+
+@click.command()
+@click.option(
+    "--format",
+    "-F",
+    type=click.Choice(
+        ["xasm", "bytes", "classic", "dis", "extended", "extended-bytes", "header"],
+        **case_sensitive
+    ),
+    help="Select disassembly style",
+)
+@click.option(
+    "--show-source/--no-show-source",
+    "-S",
+    help="Intersperse Python source text from linecache if available.",
+)
+@click.version_option(version=__version__)
+@click.argument("files", nargs=-1, type=click.Path(readable=True), required=True)
+def main(format, show_source: bool, files):
+    """Disassembles a Python bytecode file.
+
+    We handle bytecode for virtually every release of Python and some releases of PyPy.
+    The version of Python in the bytecode doesn't have to be the same version as
+    the Python interpreter used to run this program. For example, you can disassemble Python 3.6.9
+    bytecode from Python 2.7.15 and vice versa.
+    """
+    if not ((2, 7) <= PYTHON_VERSION_TRIPLE < (3, 14)):
+        mess = "This code works on 3.6 to 3.13; you have %s."
+        if (2, 4) <= PYTHON_VERSION_TRIPLE <= (2, 7):
+            mess += " Code that works for %s can be found in the python-2.4 branch\n"
+        elif (3, 1) <= PYTHON_VERSION_TRIPLE <= (3, 2):
+            mess += " Code that works for %s can be found in the python-3.1 branch\n"
+        elif (3, 3) <= PYTHON_VERSION_TRIPLE <= (3, 5):
+            mess += " Code that works for %s can be found in the python-3.3 branch\n"
+        sys.stderr.write(mess % PYTHON_VERSION_STR)
+        sys.exit(2)
+
+    for path in files:
+        # Some sanity checks
+        if not osp.exists(path):
+            sys.stderr.write("File name: '%s' doesn't exist\n" % path)
+            continue
+        elif not osp.isfile(path):
+            sys.stderr.write("File name: '%s' isn't a file\n" % path)
+            continue
+        elif osp.getsize(path) < 50 and not path.endswith(".py"):
+            sys.stderr.write(
+                "File name: '%s (%d bytes)' is too short to be a valid pyc file\n"
+                % (path, osp.getsize(path))
+            )
+            continue
+
+        disassemble_file(path, sys.stdout, format, show_source=show_source)
+    return
+
+
+if __name__ == "__main__":
+    main(sys.argv[1:])