debugpy 1.8.5__zip → 1.8.7__zip

{debugpy-1.8.5 → debugpy-1.8.7}/src/debugpy/_vendored/pydevd/pydevd_attach_to_process/winappdbg/win32/context_i386.py

@@ -37,40 +37,41 @@ __revision__ = "$Id$"
 from winappdbg.win32.defines import *
 from winappdbg.win32.version import ARCH_I386
 
-#==============================================================================
+# ==============================================================================
 # This is used later on to calculate the list of exported symbols.
 _all = None
 _all = set(vars().keys())
-#==============================================================================
+# ==============================================================================
 
-#--- CONTEXT structures and constants -----------------------------------------
+# --- CONTEXT structures and constants -----------------------------------------
 
 # The following values specify the type of access in the first parameter
 # of the exception record when the exception code specifies an access
 # violation.
-EXCEPTION_READ_FAULT        = 0     # exception caused by a read
-EXCEPTION_WRITE_FAULT       = 1     # exception caused by a write
-EXCEPTION_EXECUTE_FAULT     = 8     # exception caused by an instruction fetch
+EXCEPTION_READ_FAULT = 0  # exception caused by a read
+EXCEPTION_WRITE_FAULT = 1  # exception caused by a write
+EXCEPTION_EXECUTE_FAULT = 8  # exception caused by an instruction fetch
 
-CONTEXT_i386                = 0x00010000    # this assumes that i386 and
-CONTEXT_i486                = 0x00010000    # i486 have identical context records
+CONTEXT_i386 = 0x00010000  # this assumes that i386 and
+CONTEXT_i486 = 0x00010000  # i486 have identical context records
 
-CONTEXT_CONTROL             = (CONTEXT_i386 | long(0x00000001)) # SS:SP, CS:IP, FLAGS, BP
-CONTEXT_INTEGER             = (CONTEXT_i386 | long(0x00000002)) # AX, BX, CX, DX, SI, DI
-CONTEXT_SEGMENTS            = (CONTEXT_i386 | long(0x00000004)) # DS, ES, FS, GS
-CONTEXT_FLOATING_POINT      = (CONTEXT_i386 | long(0x00000008)) # 387 state
-CONTEXT_DEBUG_REGISTERS     = (CONTEXT_i386 | long(0x00000010)) # DB 0-3,6,7
-CONTEXT_EXTENDED_REGISTERS  = (CONTEXT_i386 | long(0x00000020)) # cpu specific extensions
+CONTEXT_CONTROL = CONTEXT_i386 | long(0x00000001)  # SS:SP, CS:IP, FLAGS, BP
+CONTEXT_INTEGER = CONTEXT_i386 | long(0x00000002)  # AX, BX, CX, DX, SI, DI
+CONTEXT_SEGMENTS = CONTEXT_i386 | long(0x00000004)  # DS, ES, FS, GS
+CONTEXT_FLOATING_POINT = CONTEXT_i386 | long(0x00000008)  # 387 state
+CONTEXT_DEBUG_REGISTERS = CONTEXT_i386 | long(0x00000010)  # DB 0-3,6,7
+CONTEXT_EXTENDED_REGISTERS = CONTEXT_i386 | long(0x00000020)  # cpu specific extensions
 
-CONTEXT_FULL = (CONTEXT_CONTROL | CONTEXT_INTEGER | CONTEXT_SEGMENTS)
+CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_INTEGER | CONTEXT_SEGMENTS
 
-CONTEXT_ALL = (CONTEXT_CONTROL | CONTEXT_INTEGER | CONTEXT_SEGMENTS | \
-                CONTEXT_FLOATING_POINT | CONTEXT_DEBUG_REGISTERS | \
-                CONTEXT_EXTENDED_REGISTERS)
+CONTEXT_ALL = (
+    CONTEXT_CONTROL | CONTEXT_INTEGER | CONTEXT_SEGMENTS | CONTEXT_FLOATING_POINT | CONTEXT_DEBUG_REGISTERS | CONTEXT_EXTENDED_REGISTERS
+)
 
-SIZE_OF_80387_REGISTERS     = 80
+SIZE_OF_80387_REGISTERS = 80
 MAXIMUM_SUPPORTED_EXTENSION = 512
 
+
 # typedef struct _FLOATING_SAVE_AREA {
 #     DWORD   ControlWord;
 #     DWORD   StatusWord;
@@ -85,45 +86,47 @@ MAXIMUM_SUPPORTED_EXTENSION = 512
 class FLOATING_SAVE_AREA(Structure):
     _pack_ = 1
     _fields_ = [
-        ('ControlWord',     DWORD),
-        ('StatusWord',      DWORD),
-        ('TagWord',         DWORD),
-        ('ErrorOffset',     DWORD),
-        ('ErrorSelector',   DWORD),
-        ('DataOffset',      DWORD),
-        ('DataSelector',    DWORD),
-        ('RegisterArea',    BYTE * SIZE_OF_80387_REGISTERS),
-        ('Cr0NpxState',     DWORD),
+        ("ControlWord", DWORD),
+        ("StatusWord", DWORD),
+        ("TagWord", DWORD),
+        ("ErrorOffset", DWORD),
+        ("ErrorSelector", DWORD),
+        ("DataOffset", DWORD),
+        ("DataSelector", DWORD),
+        ("RegisterArea", BYTE * SIZE_OF_80387_REGISTERS),
+        ("Cr0NpxState", DWORD),
     ]
 
-    _integer_members = ('ControlWord', 'StatusWord', 'TagWord', 'ErrorOffset', 'ErrorSelector', 'DataOffset', 'DataSelector', 'Cr0NpxState')
+    _integer_members = ("ControlWord", "StatusWord", "TagWord", "ErrorOffset", "ErrorSelector", "DataOffset", "DataSelector", "Cr0NpxState")
 
     @classmethod
     def from_dict(cls, fsa):
-        'Instance a new structure from a Python dictionary.'
+        "Instance a new structure from a Python dictionary."
         fsa = dict(fsa)
         s = cls()
         for key in cls._integer_members:
             setattr(s, key, fsa.get(key))
-        ra = fsa.get('RegisterArea', None)
+        ra = fsa.get("RegisterArea", None)
         if ra is not None:
             for index in compat.xrange(0, SIZE_OF_80387_REGISTERS):
                 s.RegisterArea[index] = ra[index]
         return s
 
     def to_dict(self):
-        'Convert a structure into a Python dictionary.'
+        "Convert a structure into a Python dictionary."
         fsa = dict()
         for key in self._integer_members:
             fsa[key] = getattr(self, key)
-        ra = [ self.RegisterArea[index] for index in compat.xrange(0, SIZE_OF_80387_REGISTERS) ]
+        ra = [self.RegisterArea[index] for index in compat.xrange(0, SIZE_OF_80387_REGISTERS)]
         ra = tuple(ra)
-        fsa['RegisterArea'] = ra
+        fsa["RegisterArea"] = ra
         return fsa
 
+
 PFLOATING_SAVE_AREA = POINTER(FLOATING_SAVE_AREA)
 LPFLOATING_SAVE_AREA = PFLOATING_SAVE_AREA
 
+
 # typedef struct _CONTEXT {
 #     DWORD ContextFlags;
 #     DWORD   Dr0;
@@ -165,7 +168,6 @@ class CONTEXT(Structure):
     #  The layout of the record conforms to a standard call frame.
 
     _fields_ = [
-
         # The flags values within this flag control the contents of
         # a CONTEXT record.
         #
@@ -181,77 +183,69 @@ class CONTEXT(Structure):
         # context corresponding to set flags will be returned.
         #
         # The context record is never used as an OUT only parameter.
-
-        ('ContextFlags',        DWORD),
-
+        ("ContextFlags", DWORD),
         # This section is specified/returned if CONTEXT_DEBUG_REGISTERS is
         # set in ContextFlags.  Note that CONTEXT_DEBUG_REGISTERS is NOT
         # included in CONTEXT_FULL.
-
-        ('Dr0',                 DWORD),
-        ('Dr1',                 DWORD),
-        ('Dr2',                 DWORD),
-        ('Dr3',                 DWORD),
-        ('Dr6',                 DWORD),
-        ('Dr7',                 DWORD),
-
+        ("Dr0", DWORD),
+        ("Dr1", DWORD),
+        ("Dr2", DWORD),
+        ("Dr3", DWORD),
+        ("Dr6", DWORD),
+        ("Dr7", DWORD),
         # This section is specified/returned if the
         # ContextFlags word contains the flag CONTEXT_FLOATING_POINT.
-
-        ('FloatSave',           FLOATING_SAVE_AREA),
-
+        ("FloatSave", FLOATING_SAVE_AREA),
         # This section is specified/returned if the
         # ContextFlags word contains the flag CONTEXT_SEGMENTS.
-
-        ('SegGs',               DWORD),
-        ('SegFs',               DWORD),
-        ('SegEs',               DWORD),
-        ('SegDs',               DWORD),
-
+        ("SegGs", DWORD),
+        ("SegFs", DWORD),
+        ("SegEs", DWORD),
+        ("SegDs", DWORD),
         # This section is specified/returned if the
         # ContextFlags word contains the flag CONTEXT_INTEGER.
-
-        ('Edi',                 DWORD),
-        ('Esi',                 DWORD),
-        ('Ebx',                 DWORD),
-        ('Edx',                 DWORD),
-        ('Ecx',                 DWORD),
-        ('Eax',                 DWORD),
-
+        ("Edi", DWORD),
+        ("Esi", DWORD),
+        ("Ebx", DWORD),
+        ("Edx", DWORD),
+        ("Ecx", DWORD),
+        ("Eax", DWORD),
         # This section is specified/returned if the
         # ContextFlags word contains the flag CONTEXT_CONTROL.
-
-        ('Ebp',                 DWORD),
-        ('Eip',                 DWORD),
-        ('SegCs',               DWORD),         # MUST BE SANITIZED
-        ('EFlags',              DWORD),         # MUST BE SANITIZED
-        ('Esp',                 DWORD),
-        ('SegSs',               DWORD),
-
+        ("Ebp", DWORD),
+        ("Eip", DWORD),
+        ("SegCs", DWORD),  # MUST BE SANITIZED
+        ("EFlags", DWORD),  # MUST BE SANITIZED
+        ("Esp", DWORD),
+        ("SegSs", DWORD),
         # This section is specified/returned if the ContextFlags word
         # contains the flag CONTEXT_EXTENDED_REGISTERS.
         # The format and contexts are processor specific.
-
-        ('ExtendedRegisters',   BYTE * MAXIMUM_SUPPORTED_EXTENSION),
+        ("ExtendedRegisters", BYTE * MAXIMUM_SUPPORTED_EXTENSION),
     ]
 
-    _ctx_debug   = ('Dr0', 'Dr1', 'Dr2', 'Dr3', 'Dr6', 'Dr7')
-    _ctx_segs    = ('SegGs', 'SegFs', 'SegEs', 'SegDs', )
-    _ctx_int     = ('Edi', 'Esi', 'Ebx', 'Edx', 'Ecx', 'Eax')
-    _ctx_ctrl    = ('Ebp', 'Eip', 'SegCs', 'EFlags', 'Esp', 'SegSs')
+    _ctx_debug = ("Dr0", "Dr1", "Dr2", "Dr3", "Dr6", "Dr7")
+    _ctx_segs = (
+        "SegGs",
+        "SegFs",
+        "SegEs",
+        "SegDs",
+    )
+    _ctx_int = ("Edi", "Esi", "Ebx", "Edx", "Ecx", "Eax")
+    _ctx_ctrl = ("Ebp", "Eip", "SegCs", "EFlags", "Esp", "SegSs")
 
     @classmethod
     def from_dict(cls, ctx):
-        'Instance a new structure from a Python dictionary.'
+        "Instance a new structure from a Python dictionary."
         ctx = Context(ctx)
         s = cls()
-        ContextFlags = ctx['ContextFlags']
-        setattr(s, 'ContextFlags', ContextFlags)
+        ContextFlags = ctx["ContextFlags"]
+        setattr(s, "ContextFlags", ContextFlags)
         if (ContextFlags & CONTEXT_DEBUG_REGISTERS) == CONTEXT_DEBUG_REGISTERS:
             for key in s._ctx_debug:
                 setattr(s, key, ctx[key])
         if (ContextFlags & CONTEXT_FLOATING_POINT) == CONTEXT_FLOATING_POINT:
-            fsa = ctx['FloatSave']
+            fsa = ctx["FloatSave"]
             s.FloatSave = FLOATING_SAVE_AREA.from_dict(fsa)
         if (ContextFlags & CONTEXT_SEGMENTS) == CONTEXT_SEGMENTS:
             for key in s._ctx_segs:
@@ -263,21 +257,21 @@ class CONTEXT(Structure):
             for key in s._ctx_ctrl:
                 setattr(s, key, ctx[key])
         if (ContextFlags & CONTEXT_EXTENDED_REGISTERS) == CONTEXT_EXTENDED_REGISTERS:
-            er = ctx['ExtendedRegisters']
+            er = ctx["ExtendedRegisters"]
             for index in compat.xrange(0, MAXIMUM_SUPPORTED_EXTENSION):
                 s.ExtendedRegisters[index] = er[index]
         return s
 
     def to_dict(self):
-        'Convert a structure into a Python native type.'
+        "Convert a structure into a Python native type."
         ctx = Context()
         ContextFlags = self.ContextFlags
-        ctx['ContextFlags'] = ContextFlags
+        ctx["ContextFlags"] = ContextFlags
         if (ContextFlags & CONTEXT_DEBUG_REGISTERS) == CONTEXT_DEBUG_REGISTERS:
             for key in self._ctx_debug:
                 ctx[key] = getattr(self, key)
         if (ContextFlags & CONTEXT_FLOATING_POINT) == CONTEXT_FLOATING_POINT:
-            ctx['FloatSave'] = self.FloatSave.to_dict()
+            ctx["FloatSave"] = self.FloatSave.to_dict()
         if (ContextFlags & CONTEXT_SEGMENTS) == CONTEXT_SEGMENTS:
             for key in self._ctx_segs:
                 ctx[key] = getattr(self, key)
@@ -288,14 +282,16 @@ class CONTEXT(Structure):
             for key in self._ctx_ctrl:
                 ctx[key] = getattr(self, key)
         if (ContextFlags & CONTEXT_EXTENDED_REGISTERS) == CONTEXT_EXTENDED_REGISTERS:
-            er = [ self.ExtendedRegisters[index] for index in compat.xrange(0, MAXIMUM_SUPPORTED_EXTENSION) ]
+            er = [self.ExtendedRegisters[index] for index in compat.xrange(0, MAXIMUM_SUPPORTED_EXTENSION)]
             er = tuple(er)
-            ctx['ExtendedRegisters'] = er
+            ctx["ExtendedRegisters"] = er
         return ctx
 
+
 PCONTEXT = POINTER(CONTEXT)
 LPCONTEXT = PCONTEXT
 
+
 class Context(dict):
     """
     Register context dictionary for the i386 architecture.
@@ -304,24 +300,31 @@ class Context(dict):
     arch = CONTEXT.arch
 
     def __get_pc(self):
-        return self['Eip']
+        return self["Eip"]
+
     def __set_pc(self, value):
-        self['Eip'] = value
+        self["Eip"] = value
+
     pc = property(__get_pc, __set_pc)
 
     def __get_sp(self):
-        return self['Esp']
+        return self["Esp"]
+
     def __set_sp(self, value):
-        self['Esp'] = value
+        self["Esp"] = value
+
     sp = property(__get_sp, __set_sp)
 
     def __get_fp(self):
-        return self['Ebp']
+        return self["Ebp"]
+
     def __set_fp(self, value):
-        self['Ebp'] = value
+        self["Ebp"] = value
+
     fp = property(__get_fp, __set_fp)
 
-#--- LDT_ENTRY structure ------------------------------------------------------
+
+# --- LDT_ENTRY structure ------------------------------------------------------
 
 # typedef struct _LDT_ENTRY {
 #   WORD LimitLow;
@@ -349,50 +352,56 @@ class Context(dict):
 # } LDT_ENTRY,
 #  *PLDT_ENTRY;
 
+
 class _LDT_ENTRY_BYTES_(Structure):
     _pack_ = 1
     _fields_ = [
-        ('BaseMid',         BYTE),
-        ('Flags1',          BYTE),
-        ('Flags2',          BYTE),
-        ('BaseHi',          BYTE),
+        ("BaseMid", BYTE),
+        ("Flags1", BYTE),
+        ("Flags2", BYTE),
+        ("BaseHi", BYTE),
     ]
 
+
 class _LDT_ENTRY_BITS_(Structure):
     _pack_ = 1
     _fields_ = [
-        ('BaseMid',         DWORD,  8),
-        ('Type',            DWORD,  5),
-        ('Dpl',             DWORD,  2),
-        ('Pres',            DWORD,  1),
-        ('LimitHi',         DWORD,  4),
-        ('Sys',             DWORD,  1),
-        ('Reserved_0',      DWORD,  1),
-        ('Default_Big',     DWORD,  1),
-        ('Granularity',     DWORD,  1),
-        ('BaseHi',          DWORD,  8),
+        ("BaseMid", DWORD, 8),
+        ("Type", DWORD, 5),
+        ("Dpl", DWORD, 2),
+        ("Pres", DWORD, 1),
+        ("LimitHi", DWORD, 4),
+        ("Sys", DWORD, 1),
+        ("Reserved_0", DWORD, 1),
+        ("Default_Big", DWORD, 1),
+        ("Granularity", DWORD, 1),
+        ("BaseHi", DWORD, 8),
     ]
 
+
 class _LDT_ENTRY_HIGHWORD_(Union):
     _pack_ = 1
     _fields_ = [
-        ('Bytes',           _LDT_ENTRY_BYTES_),
-        ('Bits',            _LDT_ENTRY_BITS_),
+        ("Bytes", _LDT_ENTRY_BYTES_),
+        ("Bits", _LDT_ENTRY_BITS_),
     ]
 
+
 class LDT_ENTRY(Structure):
     _pack_ = 1
     _fields_ = [
-        ('LimitLow',        WORD),
-        ('BaseLow',         WORD),
-        ('HighWord',        _LDT_ENTRY_HIGHWORD_),
+        ("LimitLow", WORD),
+        ("BaseLow", WORD),
+        ("HighWord", _LDT_ENTRY_HIGHWORD_),
     ]
 
+
 PLDT_ENTRY = POINTER(LDT_ENTRY)
 LPLDT_ENTRY = PLDT_ENTRY
 
 ###############################################################################
 
+
 # BOOL WINAPI GetThreadSelectorEntry(
 #   __in   HANDLE hThread,
 #   __in   DWORD dwSelector,
@@ -401,21 +410,22 @@ LPLDT_ENTRY = PLDT_ENTRY
 def GetThreadSelectorEntry(hThread, dwSelector):
     _GetThreadSelectorEntry = windll.kernel32.GetThreadSelectorEntry
     _GetThreadSelectorEntry.argtypes = [HANDLE, DWORD, LPLDT_ENTRY]
-    _GetThreadSelectorEntry.restype  = bool
+    _GetThreadSelectorEntry.restype = bool
     _GetThreadSelectorEntry.errcheck = RaiseIfZero
 
     ldt = LDT_ENTRY()
     _GetThreadSelectorEntry(hThread, dwSelector, byref(ldt))
     return ldt
 
+
 # BOOL WINAPI GetThreadContext(
 #   __in     HANDLE hThread,
 #   __inout  LPCONTEXT lpContext
 # );
-def GetThreadContext(hThread, ContextFlags = None, raw = False):
+def GetThreadContext(hThread, ContextFlags=None, raw=False):
     _GetThreadContext = windll.kernel32.GetThreadContext
     _GetThreadContext.argtypes = [HANDLE, LPCONTEXT]
-    _GetThreadContext.restype  = bool
+    _GetThreadContext.restype = bool
     _GetThreadContext.errcheck = RaiseIfZero
 
     if ContextFlags is None:
@@ -427,6 +437,7 @@ def GetThreadContext(hThread, ContextFlags = None, raw = False):
         return Context
     return Context.to_dict()
 
+
 # BOOL WINAPI SetThreadContext(
 #   __in  HANDLE hThread,
 #   __in  const CONTEXT* lpContext
@@ -434,16 +445,17 @@ def GetThreadContext(hThread, ContextFlags = None, raw = False):
 def SetThreadContext(hThread, lpContext):
     _SetThreadContext = windll.kernel32.SetThreadContext
     _SetThreadContext.argtypes = [HANDLE, LPCONTEXT]
-    _SetThreadContext.restype  = bool
+    _SetThreadContext.restype = bool
     _SetThreadContext.errcheck = RaiseIfZero
 
     if isinstance(lpContext, dict):
         lpContext = CONTEXT.from_dict(lpContext)
     _SetThreadContext(hThread, byref(lpContext))
 
-#==============================================================================
+
+# ==============================================================================
 # This calculates the list of exported symbols.
 _all = set(vars().keys()).difference(_all)
-__all__ = [_x for _x in _all if not _x.startswith('_')]
+__all__ = [_x for _x in _all if not _x.startswith("_")]
 __all__.sort()
-#==============================================================================
+# ==============================================================================