lief 0.16.7__cp314-cp314-macosx_11_0_x86_64.whl

lief/assembly/x86/operands/__init__.pyi

@@ -0,0 +1,32 @@
+from typing import Iterator, Optional, Union
+
+import lief.assembly.x86
+
+
+class Immediate(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> int: ...
+
+class Register(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> lief.assembly.x86.REG: ...
+
+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: ...

lief/dsc/__init__.pyi

@@ -0,0 +1,222 @@
+from collections.abc import Sequence
+import enum
+import os
+from typing import Iterator, Optional, Union, overload
+
+import lief
+import lief.MachO
+import lief.assembly
+
+
+@overload
+def enable_cache() -> bool: ...
+
+@overload
+def enable_cache(target_cache_dir: str) -> bool: ...
+
+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: ...
+
+@overload
+def load(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+@overload
+def load(path: os.PathLike, arch: str = '') -> Optional[DyldSharedCache]: ...
+
+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 SubCache:
+    @property
+    def uuid(self) -> list[int]: ...
+
+    @property
+    def vm_offset(self) -> int: ...
+
+    @property
+    def suffix(self) -> str: ...
+
+    @property
+    def cache(self) -> Optional[DyldSharedCache]: ...
+
+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: ...

lief/dwarf/__init__.pyi

@@ -0,0 +1,293 @@
+import enum
+from typing import Iterator, Optional, Union, overload
+
+from . import parameters as parameters, types as types
+import lief
+import lief.assembly
+
+
+def load(path: str) -> Optional[DebugInfo]: ...
+
+class Scope:
+    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[Scope]: ...
+
+    @property
+    def type(self) -> Scope.TYPE: ...
+
+    def chained(self, sep: str = '::') -> str: ...
+
+class Type:
+    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 kind(self) -> Type.KIND: ...
+
+    @property
+    def name(self) -> Optional[str]: ...
+
+    @property
+    def size(self) -> Optional[int]: ...
+
+    @property
+    def location(self) -> lief.debug_location_t: ...
+
+    @property
+    def is_unspecified(self) -> bool: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+class Variable:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def linkage_name(self) -> str: ...
+
+    @property
+    def address(self) -> Optional[int]: ...
+
+    @property
+    def size(self) -> Optional[int]: ...
+
+    @property
+    def is_constexpr(self) -> bool: ...
+
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+class Function:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def linkage_name(self) -> str: ...
+
+    @property
+    def address(self) -> Optional[int]: ...
+
+    @property
+    def variables(self) -> Iterator[Optional[Variable]]: ...
+
+    @property
+    def is_artificial(self) -> bool: ...
+
+    @property
+    def is_external(self) -> bool: ...
+
+    @property
+    def size(self) -> int: ...
+
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
+
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
+
+    @property
+    def parameters(self) -> list[Optional[Parameter]]: ...
+
+    @property
+    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 CompilationUnit:
+    class Language:
+        class LANG(enum.Enum):
+            @staticmethod
+            def from_value(arg: int, /) -> CompilationUnit.Language.LANG: ...
+
+            def __eq__(self, arg, /) -> bool: ...
+
+            def __ne__(self, arg, /) -> bool: ...
+
+            def __int__(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: CompilationUnit.Language.LANG
+
+        version: int
+
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def producer(self) -> str: ...
+
+    @property
+    def compilation_dir(self) -> str: ...
+
+    @property
+    def language(self) -> CompilationUnit.Language: ...
+
+    @property
+    def low_address(self) -> int: ...
+
+    @property
+    def high_address(self) -> int: ...
+
+    @property
+    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 types(self) -> Iterator[Optional[Type]]: ...
+
+    @property
+    def functions(self) -> Iterator[Optional[Function]]: ...
+
+    @property
+    def imported_functions(self) -> Iterator[Optional[Function]]: ...
+
+    @property
+    def variables(self) -> Iterator[Optional[Variable]]: ...
+
+class DebugInfo(lief.DebugInfo):
+    @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]: ...
+
+    def find_type(self, name: str) -> Optional[Type]: ...
+
+    @property
+    def compilation_units(self) -> Iterator[Optional[CompilationUnit]]: ...

lief/dwarf/parameters/__init__.pyi

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

lief/dwarf/types/__init__.pyi

@@ -0,0 +1,167 @@
+import enum
+from typing import Iterator, Optional, Union as _Union
+
+import lief.dwarf
+
+
+class ClassLike(lief.dwarf.Type):
+    class Member:
+        @property
+        def name(self) -> str: ...
+
+        @property
+        def type(self) -> Optional[lief.dwarf.Type]: ...
+
+        @property
+        def is_external(self) -> bool: ...
+
+        @property
+        def is_declaration(self) -> bool: ...
+
+        @property
+        def offset(self) -> Optional[int]: ...
+
+        @property
+        def bit_offset(self) -> Optional[int]: ...
+
+    @property
+    def members(self) -> list[ClassLike.Member]: ...
+
+    def find_member(self, offset: int) -> Optional[ClassLike.Member]: ...
+
+    @property
+    def functions(self) -> Iterator[Optional[lief.dwarf.Function]]: ...
+
+class Structure(ClassLike):
+    pass
+
+class Class(ClassLike):
+    pass
+
+class Union(ClassLike):
+    pass
+
+class Packed(ClassLike):
+    pass
+
+class Pointer(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Const(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Base(lief.dwarf.Type):
+    class ENCODING(enum.Enum):
+        NONE = 0
+
+        SIGNED = 1
+
+        SIGNED_CHAR = 2
+
+        UNSIGNED = 3
+
+        UNSIGNED_CHAR = 4
+
+        FLOAT = 5
+
+        BOOLEAN = 6
+
+        ADDRESS = 7
+
+    @property
+    def encoding(self) -> Base.ENCODING: ...
+
+class Array(lief.dwarf.Type):
+    class size_info_t:
+        @property
+        def type(self) -> lief.dwarf.Type: ...
+
+        @property
+        def name(self) -> str: ...
+
+        @property
+        def size(self) -> int: ...
+
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+    @property
+    def size_info(self) -> Array.size_info_t: ...
+
+class Typedef(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Atomic(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Coarray(lief.dwarf.Type):
+    pass
+
+class Dynamic(lief.dwarf.Type):
+    pass
+
+class Enum(lief.dwarf.Type):
+    pass
+
+class File(lief.dwarf.Type):
+    pass
+
+class Immutable(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Interface(lief.dwarf.Type):
+    pass
+
+class PointerToMember(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+    @property
+    def containing_type(self) -> Optional[lief.dwarf.Type]: ...
+
+class RValueReference(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Reference(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Restrict(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class SetTy(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Shared(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class StringTy(lief.dwarf.Type):
+    pass
+
+class Subroutine(lief.dwarf.Type):
+    @property
+    def parameters(self) -> list[Optional[lief.dwarf.Parameter]]: ...
+
+class TemplateAlias(lief.dwarf.Type):
+    @property
+    def parameters(self) -> list[Optional[lief.dwarf.Parameter]]: ...
+
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Thrown(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...
+
+class Volatile(lief.dwarf.Type):
+    @property
+    def underlying_type(self) -> lief.dwarf.Type: ...