lief 0.15.1__cp310-cp310-win32.whl → 0.16.1__cp310-cp310-win32.whl

lief/assembly/x86/operands/__init__.pyi

@@ -0,0 +1,32 @@
+from typing import Iterator, Optional, Union
+
+import lief
+
+
+class Immediate(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> int: ...
+
+class Memory(lief.assembly.x86.Operand):
+    @property
+    def base(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def scaled_register(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def segment_register(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def scale(self) -> int: ...
+
+    @property
+    def displacement(self) -> int: ...
+
+class PCRelative(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> int: ...
+
+class Register(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> lief.assembly.x86.REG: ...

lief/dsc/__init__.pyi

@@ -0,0 +1,220 @@
+from collections.abc import Sequence
+import enum
+import os
+from typing import Iterator, Optional, Union, overload
+
+import lief
+
+
+class DyldSharedCache:
+    class VERSION(enum.Enum):
+        UNKNOWN = 0
+
+        DYLD_95_3 = 1
+
+        DYLD_195_5 = 2
+
+        DYLD_239_3 = 3
+
+        DYLD_360_14 = 4
+
+        DYLD_421_1 = 5
+
+        DYLD_832_7_1 = 6
+
+        DYLD_940 = 7
+
+        DYLD_1042_1 = 8
+
+        UNRELEASED = 9
+
+    class PLATFORM(enum.Enum):
+        UNKNOWN = 0
+
+        MACOS = 1
+
+        IOS = 2
+
+        TVOS = 3
+
+        WATCHOS = 4
+
+        BRIDGEOS = 5
+
+        IOSMAC = 6
+
+        IOS_SIMULATOR = 7
+
+        TVOS_SIMULATOR = 8
+
+        WATCHOS_SIMULATOR = 9
+
+        DRIVERKIT = 10
+
+        VISIONOS = 11
+
+        VISIONOS_SIMULATOR = 12
+
+        FIRMWARE = 13
+
+        SEPOS = 14
+
+        ANY = 4294967295
+
+    class ARCH(enum.Enum):
+        UNKNOWN = 0
+
+        I386 = 1
+
+        X86_64 = 2
+
+        X86_64H = 3
+
+        ARMV5 = 4
+
+        ARMV6 = 5
+
+        ARMV7 = 6
+
+        ARM64 = 7
+
+        ARM64E = 8
+
+    @staticmethod
+    def from_path(path: str, arch: str = '') -> Optional[DyldSharedCache]: ...
+
+    @staticmethod
+    def from_files(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+    @property
+    def filename(self) -> str: ...
+
+    @property
+    def version(self) -> DyldSharedCache.VERSION: ...
+
+    @property
+    def filepath(self) -> str: ...
+
+    @property
+    def load_address(self) -> int: ...
+
+    @property
+    def arch_name(self) -> str: ...
+
+    @property
+    def platform(self) -> DyldSharedCache.PLATFORM: ...
+
+    @property
+    def arch(self) -> DyldSharedCache.ARCH: ...
+
+    @property
+    def has_subcaches(self) -> bool: ...
+
+    def find_lib_from_va(self, virtual_address: int) -> Optional[Dylib]: ...
+
+    def find_lib_from_path(self, path: str) -> Optional[Dylib]: ...
+
+    def find_lib_from_name(self, name: str) -> Optional[Dylib]: ...
+
+    @property
+    def libraries(self) -> Sequence[Optional[Dylib]]: ...
+
+    @property
+    def mapping_info(self) -> Sequence[Optional[MappingInfo]]: ...
+
+    @property
+    def subcaches(self) -> Sequence[Optional[SubCache]]: ...
+
+    def get_content_from_va(self, addr: int, size: int) -> bytes: ...
+
+    def cache_for_address(self, address: int) -> Optional[DyldSharedCache]: ...
+
+    @property
+    def main_cache(self) -> Optional[DyldSharedCache]: ...
+
+    def find_subcache(self, filename: str) -> Optional[DyldSharedCache]: ...
+
+    def va_to_offset(self, virtual_address: int) -> Union[int, lief.lief_errors]: ...
+
+    def disassemble(self, arg: int, /) -> Iterator[Optional[lief.assembly.Instruction]]: ...
+
+    def enable_caching(self, target_dir: str) -> None: ...
+
+    def flush_cache(self) -> None: ...
+
+class Dylib:
+    class extract_opt_t:
+        def __init__(self) -> None: ...
+
+        pack: bool
+
+        fix_branches: bool
+
+        fix_memory: bool
+
+        fix_relocations: bool
+
+        fix_objc: bool
+
+        create_dyld_chained_fixup_cmd: bool
+
+    @property
+    def path(self) -> str: ...
+
+    @property
+    def address(self) -> int: ...
+
+    @property
+    def modtime(self) -> int: ...
+
+    @property
+    def inode(self) -> int: ...
+
+    @property
+    def padding(self) -> int: ...
+
+    def get(self, opt: Dylib.extract_opt_t = ...) -> Optional[lief.MachO.Binary]: ...
+
+class MappingInfo:
+    @property
+    def address(self) -> int: ...
+
+    @property
+    def size(self) -> int: ...
+
+    @property
+    def end_address(self) -> int: ...
+
+    @property
+    def file_offset(self) -> int: ...
+
+    @property
+    def max_prot(self) -> int: ...
+
+    @property
+    def init_prot(self) -> int: ...
+
+class SubCache:
+    @property
+    def uuid(self) -> list[int]: ...
+
+    @property
+    def vm_offset(self) -> int: ...
+
+    @property
+    def suffix(self) -> str: ...
+
+    @property
+    def cache(self) -> Optional[DyldSharedCache]: ...
+
+@overload
+def enable_cache() -> bool: ...
+
+@overload
+def enable_cache(target_cache_dir: str) -> bool: ...
+
+@overload
+def load(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+@overload
+def load(path: os.PathLike, arch: str = '') -> Optional[DyldSharedCache]: ...

lief/dwarf/__init__.pyi

@@ -1,193 +1,292 @@
-from typing import Any, ClassVar, Iterator, Optional
+import enum
+from typing import Iterator, Optional, Union, overload
+
+from . import parameters as parameters, types as types
+import lief
 
-from typing import overload
-import lief # type: ignore
-import lief.dwarf # type: ignore
-import lief.dwarf.CompilationUnit # type: ignore
-import lief.dwarf.CompilationUnit.Language # type: ignore
-import lief.dwarf.Function # type: ignore
-import lief.dwarf.Scope # type: ignore
-import lief.dwarf.Type # type: ignore
 
 class CompilationUnit:
     class Language:
-        class LANG:
-            C: ClassVar[CompilationUnit.Language.LANG] = ...
-            CPP: ClassVar[CompilationUnit.Language.LANG] = ...
-            DART: ClassVar[CompilationUnit.Language.LANG] = ...
-            RUST: ClassVar[CompilationUnit.Language.LANG] = ...
-            UNKNOWN: ClassVar[CompilationUnit.Language.LANG] = ...
-            __name__: str
-            def __init__(self, *args, **kwargs) -> None: ...
+        class LANG(enum.Enum):
             @staticmethod
-            def from_value(arg: int, /) -> lief.dwarf.CompilationUnit.Language.LANG: ...
-            def __ge__(self, other) -> bool: ...
-            def __gt__(self, other) -> bool: ...
-            def __hash__(self) -> int: ...
-            def __index__(self) -> Any: ...
+            def from_value(arg: int, /) -> CompilationUnit.Language.LANG: ...
+
+            def __eq__(self, arg, /) -> bool: ...
+
+            def __ne__(self, arg, /) -> bool: ...
+
             def __int__(self) -> int: ...
-            def __le__(self, other) -> bool: ...
-            def __lt__(self, other) -> bool: ...
-            @property
-            def value(self) -> int: ...
+
+            UNKNOWN = 0
+
+            C = 1
+
+            CPP = 2
+
+            RUST = 3
+
+            DART = 4
+
+            MODULA = 5
+
+            FORTRAN = 6
+
+            SWIFT = 7
+
+            D = 8
+
+            JAVA = 9
+
+            COBOL = 10
+
         lang: lief.dwarf.CompilationUnit.Language.LANG
+
         version: int
-        def __init__(self, *args, **kwargs) -> None: ...
-    def __init__(self, *args, **kwargs) -> None: ...
-    @overload
-    def find_function(self, name: str) -> Optional[lief.dwarf.Function]: ...
-    @overload
-    def find_function(self, addr: int) -> Optional[lief.dwarf.Function]: ...
-    @overload
-    def find_variable(self, addr: int) -> Optional[lief.dwarf.Variable]: ...
-    @overload
-    def find_variable(self, name: str) -> Optional[lief.dwarf.Variable]: ...
+
     @property
-    def compilation_dir(self) -> str: ...
+    def name(self) -> str: ...
+
     @property
-    def functions(self) -> Iterator[Optional[lief.dwarf.Function]]: ...
+    def producer(self) -> str: ...
+
     @property
-    def high_address(self) -> int: ...
+    def compilation_dir(self) -> str: ...
+
     @property
-    def language(self) -> lief.dwarf.CompilationUnit.Language: ...
+    def language(self) -> CompilationUnit.Language: ...
+
     @property
     def low_address(self) -> int: ...
+
     @property
-    def name(self) -> str: ...
+    def high_address(self) -> int: ...
+
     @property
-    def producer(self) -> str: ...
+    def size(self) -> int: ...
+
     @property
     def ranges(self) -> list[lief.range_t]: ...
+
+    @overload
+    def find_function(self, name: str) -> Optional[Function]: ...
+
+    @overload
+    def find_function(self, addr: int) -> Optional[Function]: ...
+
+    @overload
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
+
+    @overload
+    def find_variable(self, name: str) -> Optional[Variable]: ...
+
     @property
-    def size(self) -> int: ...
+    def types(self) -> Iterator[Optional[Type]]: ...
+
+    @property
+    def functions(self) -> Iterator[Optional[Function]]: ...
+
     @property
-    def types(self) -> Iterator[Optional[lief.dwarf.Type]]: ...
+    def imported_functions(self) -> Iterator[Optional[Function]]: ...
+
     @property
-    def variables(self) -> Iterator[Optional[lief.dwarf.Variable]]: ...
+    def variables(self) -> Iterator[Optional[Variable]]: ...
 
 class DebugInfo(lief.DebugInfo):
-    def __init__(self, *args, **kwargs) -> None: ...
     @overload
-    def find_function(self, name: str) -> Optional[lief.dwarf.Function]: ...
+    def find_function(self, name: str) -> Optional[Function]: ...
+
     @overload
-    def find_function(self, addr: int) -> Optional[lief.dwarf.Function]: ...
-    def find_type(self, name: str) -> Optional[lief.dwarf.Type]: ...
+    def find_function(self, addr: int) -> Optional[Function]: ...
+
     @overload
-    def find_variable(self, addr: int) -> Optional[lief.dwarf.Variable]: ...
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
+
     @overload
-    def find_variable(self, name: str) -> Optional[lief.dwarf.Variable]: ...
+    def find_variable(self, name: str) -> Optional[Variable]: ...
+
+    def find_type(self, name: str) -> Optional[Type]: ...
+
     @property
-    def compilation_units(self) -> Iterator[Optional[lief.dwarf.CompilationUnit]]: ...
+    def compilation_units(self) -> Iterator[Optional[CompilationUnit]]: ...
 
 class Function:
-    class Parameter:
-        def __init__(self, *args, **kwargs) -> None: ...
-        @property
-        def name(self) -> str: ...
-        @property
-        def type(self) -> Optional[lief.dwarf.Type]: ...
-    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def linkage_name(self) -> str: ...
+
     @property
     def address(self) -> Optional[int]: ...
+
     @property
-    def debug_location(self) -> lief.debug_location_t: ...
+    def variables(self) -> Iterator[Optional[Variable]]: ...
+
     @property
     def is_artificial(self) -> bool: ...
+
     @property
-    def linkage_name(self) -> str: ...
-    @property
-    def name(self) -> str: ...
+    def is_external(self) -> bool: ...
+
     @property
-    def parameters(self) -> list[lief.dwarf.Function.Parameter]: ...
+    def size(self) -> int: ...
+
     @property
     def ranges(self) -> list[lief.range_t]: ...
+
     @property
-    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    def debug_location(self) -> lief.debug_location_t: ...
+
     @property
-    def size(self) -> int: ...
+    def type(self) -> Optional[Type]: ...
+
     @property
-    def type(self) -> Optional[lief.dwarf.Type]: ...
+    def parameters(self) -> list[Optional[Parameter]]: ...
+
     @property
-    def variables(self) -> Iterator[Optional[lief.dwarf.Variable]]: ...
+    def thrown_types(self) -> list[Optional[Type]]: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+    @property
+    def instructions(self) -> Iterator[Optional[lief.assembly.Instruction]]: ...
+
+class Parameter:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
 
 class Scope:
-    class TYPE:
-        CLASS: ClassVar[Scope.TYPE] = ...
-        COMPILATION_UNIT: ClassVar[Scope.TYPE] = ...
-        FUNCTION: ClassVar[Scope.TYPE] = ...
-        NAMESPACE: ClassVar[Scope.TYPE] = ...
-        STRUCT: ClassVar[Scope.TYPE] = ...
-        UNION: ClassVar[Scope.TYPE] = ...
-        UNKNOWN: ClassVar[Scope.TYPE] = ...
-        __name__: str
-        def __init__(self, *args, **kwargs) -> None: ...
-        def __ge__(self, other) -> bool: ...
-        def __gt__(self, other) -> bool: ...
-        def __hash__(self) -> int: ...
-        def __index__(self) -> Any: ...
-        def __int__(self) -> int: ...
-        def __le__(self, other) -> bool: ...
-        def __lt__(self, other) -> bool: ...
-    def __init__(self, *args, **kwargs) -> None: ...
-    def chained(self, sep: str = ...) -> str: ...
+    class TYPE(enum.Enum):
+        UNKNOWN = 0
+
+        UNION = 1
+
+        CLASS = 2
+
+        STRUCT = 3
+
+        NAMESPACE = 4
+
+        FUNCTION = 5
+
+        COMPILATION_UNIT = 6
+
     @property
     def name(self) -> str: ...
+
     @property
-    def parent(self) -> Optional[lief.dwarf.Scope]: ...
+    def parent(self) -> Optional[Scope]: ...
+
     @property
-    def type(self) -> lief.dwarf.Scope.TYPE: ...
+    def type(self) -> Scope.TYPE: ...
+
+    def chained(self, sep: str = '::') -> str: ...
 
 class Type:
-    class KIND:
-        ARRAY: ClassVar[Type.KIND] = ...
-        BASE: ClassVar[Type.KIND] = ...
-        CLASS: ClassVar[Type.KIND] = ...
-        CONST: ClassVar[Type.KIND] = ...
-        POINTER: ClassVar[Type.KIND] = ...
-        STRUCT: ClassVar[Type.KIND] = ...
-        UNION: ClassVar[Type.KIND] = ...
-        UNKNOWN: ClassVar[Type.KIND] = ...
-        UNSPECIFIED: ClassVar[Type.KIND] = ...
-        __name__: str
-        def __init__(self, *args, **kwargs) -> None: ...
-        def __ge__(self, other) -> bool: ...
-        def __gt__(self, other) -> bool: ...
-        def __hash__(self) -> int: ...
-        def __index__(self) -> Any: ...
-        def __int__(self) -> int: ...
-        def __le__(self, other) -> bool: ...
-        def __lt__(self, other) -> bool: ...
-    def __init__(self, *args, **kwargs) -> None: ...
+    class KIND(enum.Enum):
+        UNKNOWN = 0
+
+        UNSPECIFIED = 1
+
+        BASE = 2
+
+        CONST_KIND = 3
+
+        CLASS = 4
+
+        ARRAY = 5
+
+        POINTER = 6
+
+        STRUCT = 7
+
+        UNION = 8
+
+        TYPEDEF = 9
+
+        REF = 10
+
+        SET_TYPE = 11
+
+        STRING = 12
+
+        SUBROUTINE = 13
+
+        POINTER_MEMBER = 14
+
+        PACKED = 15
+
+        FILE = 16
+
+        THROWN = 17
+
+        VOLATILE = 18
+
+        RESTRICT = 19
+
+        INTERFACE = 20
+
+        SHARED = 21
+
+        RVALREF = 22
+
+        TEMPLATE_ALIAS = 23
+
+        COARRAY = 24
+
+        DYNAMIC = 25
+
+        ATOMIC = 26
+
+        IMMUTABLE = 27
+
+        ENUM = 28
+
     @property
-    def is_unspecified(self) -> bool: ...
+    def kind(self) -> Type.KIND: ...
+
+    @property
+    def name(self) -> Optional[str]: ...
+
     @property
-    def kind(self) -> lief.dwarf.Type.KIND: ...
+    def size(self) -> Optional[int]: ...
+
     @property
     def location(self) -> lief.debug_location_t: ...
+
     @property
-    def name(self) -> Optional[str]: ...
-    @property
-    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    def is_unspecified(self) -> bool: ...
+
     @property
-    def size(self) -> Optional[int]: ...
+    def scope(self) -> Optional[Scope]: ...
 
 class Variable:
-    def __init__(self, *args, **kwargs) -> None: ...
     @property
-    def address(self) -> Optional[int]: ...
+    def name(self) -> str: ...
+
     @property
-    def debug_location(self) -> lief.debug_location_t: ...
+    def linkage_name(self) -> str: ...
+
     @property
-    def is_constexpr(self) -> bool: ...
+    def address(self) -> Optional[int]: ...
+
     @property
-    def linkage_name(self) -> str: ...
+    def size(self) -> Optional[int]: ...
+
     @property
-    def name(self) -> str: ...
+    def is_constexpr(self) -> bool: ...
+
     @property
-    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    def debug_location(self) -> lief.debug_location_t: ...
+
     @property
-    def size(self) -> Optional[int]: ...
+    def type(self) -> Optional[Type]: ...
+
     @property
-    def type(self) -> Optional[lief.dwarf.Type]: ...
+    def scope(self) -> Optional[Scope]: ...
 
-def load(path: str) -> Optional[lief.dwarf.DebugInfo]: ...
+def load(path: str) -> Optional[DebugInfo]: ...

lief/dwarf/parameters/__init__.pyi

@@ -0,0 +1,14 @@
+from typing import Iterator, Optional, Union
+
+import lief
+
+
+class Formal(lief.dwarf.Parameter):
+    @property
+    def type(self) -> Optional[lief.dwarf.Type]: ...
+
+class TemplateType(lief.dwarf.Parameter):
+    pass
+
+class TemplateValue(lief.dwarf.Parameter):
+    pass