lief 0.16.5__cp312-cp312-win32.whl → 0.17.0__cp312-cp312-win32.whl

lief/__init__.pyi

@@ -2,12 +2,16 @@ from collections.abc import Sequence
 import enum
 import io
 import lief
+import lief.ELF
+import lief.MachO
+import lief.PE
 import os
 from typing import Iterator, Optional, Union, overload
 
 from . import (
     ART as ART,
     Android as Android,
+    COFF as COFF,
     DEX as DEX,
     ELF as ELF,
     MachO as MachO,
@@ -23,208 +27,145 @@ from . import (
 )
 
 
-class Binary(Object):
-    class VA_TYPES(enum.Enum):
-        AUTO = 0
-
-        VA = 2
-
-        RVA = 1
-
-    class FORMATS(enum.Enum):
-        UNKNOWN = 0
-
-        ELF = 1
-
-        PE = 2
+__tag__: str = ...
 
-        MACHO = 3
+__commit__: str = ...
 
-        OAT = 4
+__is_tagged__: bool = ...
 
-    class it_sections:
-        def __getitem__(self, arg: int, /) -> Section: ...
+class lief_version_t:
+    major: int
 
-        def __len__(self) -> int: ...
+    minor: int
 
-        def __iter__(self) -> Binary.it_sections: ...
+    patch: int
 
-        def __next__(self) -> Section: ...
+    id: int
 
-    class it_symbols:
-        def __getitem__(self, arg: int, /) -> Symbol: ...
+    def __repr__(self) -> str: ...
 
-        def __len__(self) -> int: ...
+    def __str__(self) -> str: ...
 
-        def __iter__(self) -> Binary.it_symbols: ...
+def disable_leak_warning() -> None: ...
 
-        def __next__(self) -> Symbol: ...
+def demangle(mangled: str) -> Optional[str]: ...
 
-    class it_relocations:
-        def __getitem__(self, arg: int, /) -> Relocation: ...
+def dump(buffer: memoryview, title: str = '', prefix: str = '', limit: int = 0) -> str: ...
 
-        def __len__(self) -> int: ...
+def extended_version_info() -> str: ...
 
-        def __iter__(self) -> Binary.it_relocations: ...
+def extended_version() -> lief_version_t: ...
 
-        def __next__(self) -> Relocation: ...
+__extended__: bool = ...
 
-    @property
-    def debug_info(self) -> DebugInfo: ...
+class range_t:
+    low: int
 
-    @property
-    def format(self) -> Binary.FORMATS: ...
+    high: int
 
     @property
-    def is_pie(self) -> bool: ...
+    def size(self) -> int: ...
 
-    @property
-    def has_nx(self) -> bool: ...
+    def __repr__(self) -> str: ...
 
-    @property
-    def header(self) -> Header: ...
+    def __str__(self) -> str: ...
 
-    @property
-    def entrypoint(self) -> int: ...
+class debug_location_t:
+    line: int
 
-    def remove_section(self, name: str, clear: bool = False) -> None: ...
+    file: str
 
-    @property
-    def sections(self) -> Binary.it_sections: ...
+    def __repr__(self) -> str: ...
 
-    @property
-    def relocations(self) -> Binary.it_relocations: ...
+class PLATFORMS(enum.Enum):
+    @staticmethod
+    def from_value(arg: int, /) -> PLATFORMS: ...
 
-    @property
-    def exported_functions(self) -> list[Function]: ...
+    def __eq__(self, arg, /) -> bool: ...
 
-    @property
-    def imported_functions(self) -> list[Function]: ...
+    def __ne__(self, arg, /) -> bool: ...
 
-    @property
-    def libraries(self) -> list[Union[str,bytes]]: ...
+    def __int__(self) -> int: ...
 
-    @property
-    def symbols(self) -> Binary.it_symbols: ...
+    UNKNOWN = 3
 
-    def has_symbol(self, symbol_name: str) -> bool: ...
+    LINUX = 1
 
-    def get_symbol(self, symbol_name: str) -> Symbol: ...
+    ANDROID = 2
 
-    def get_function_address(self, function_name: str) -> Union[int, lief_errors]: ...
+    WINDOWS = 3
 
-    @overload
-    def patch_address(self, address: int, patch_value: Sequence[int], va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> None: ...
+    IOS = 4
 
-    @overload
-    def patch_address(self, address: int, patch_value: int, size: int = 8, va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> None: ...
+    OSX = 5
 
-    def get_content_from_virtual_address(self, virtual_address: int, size: int, va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> memoryview: ...
+def current_platform() -> PLATFORMS: ...
 
-    def get_int_from_virtual_address(self, address: int, interger_size: int, type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> Optional[int]: ...
+class Object:
+    def __hash__(self) -> int: ...
 
-    @property
-    def abstract(self) -> lief.Binary: ...
+    def __eq__(self, arg, /) -> bool: ...
 
-    @property
-    def concrete(self) -> lief.ELF.Binary | lief.PE.Binary | lief.MachO.Binary: ...
+class ok_t:
+    def __bool__(self) -> bool: ...
 
+class ok_error_t:
     @property
-    def ctor_functions(self) -> list[Function]: ...
-
-    def xref(self, virtual_address: int) -> list[int]: ...
-
-    def offset_to_virtual_address(self, offset: int, slide: int = 0) -> Union[int, lief_errors]: ...
+    def is_error(self) -> bool: ...
 
     @property
-    def imagebase(self) -> int: ...
+    def is_value(self) -> bool: ...
 
     @property
-    def original_size(self) -> int: ...
-
-    @overload
-    def disassemble(self, address: int) -> Iterator[Optional[assembly.Instruction]]: ...
-
-    @overload
-    def disassemble(self, address: int, size: int) -> Iterator[Optional[assembly.Instruction]]: ...
-
-    @overload
-    def disassemble(self, function_name: str) -> Iterator[Optional[assembly.Instruction]]: ...
-
-    def disassemble_from_bytes(self, buffer: bytes, address: int = 0) -> Iterator[Optional[assembly.Instruction]]: ...
-
-    def assemble(self, address: int, assembly: str) -> bytes: ...
-
-    def __str__(self) -> str: ...
-
-class DebugInfo:
-    class FORMAT(enum.Enum):
-        @staticmethod
-        def from_value(arg: int, /) -> DebugInfo.FORMAT: ...
-
-        def __eq__(self, arg, /) -> bool: ...
-
-        def __ne__(self, arg, /) -> bool: ...
-
-        def __int__(self) -> int: ...
-
-        UNKNOWN = 0
-
-        DWARF = 1
-
-        PDB = 2
+    def error(self) -> lief_errors: ...
 
     @property
-    def format(self) -> DebugInfo.FORMAT: ...
+    def value(self) -> ok_t: ...
 
-class Function(Symbol):
-    @overload
-    def __init__(self) -> None: ...
+    def __bool__(self) -> bool: ...
 
-    @overload
-    def __init__(self, arg: str, /) -> None: ...
+class lief_errors(enum.Enum):
+    read_error = 1
 
-    @overload
-    def __init__(self, arg: int, /) -> None: ...
+    not_found = 2
 
-    @overload
-    def __init__(self, arg0: str, arg1: int, /) -> None: ...
+    not_implemented = 3
 
-    class FLAGS(enum.Flag):
-        @staticmethod
-        def from_value(arg: int, /) -> Function.FLAGS: ...
+    not_supported = 4
 
-        def __eq__(self, arg, /) -> bool: ...
+    corrupted = 5
 
-        def __ne__(self, arg, /) -> bool: ...
+    conversion_error = 6
 
-        def __int__(self) -> int: ...
+    read_out_of_bound = 7
 
-        NONE = 0
+    asn1_bad_tag = 8
 
-        IMPORTED = 16
+    file_error = 9
 
-        EXPORTED = 8
+    file_format_error = 10
 
-        CONSTRUCTOR = 1
+    parsing_error = 11
 
-        DESTRUCTOR = 2
+    build_error = 12
 
-        DEBUG_INFO = 4
+    data_too_large = 13
 
-    def add(self, flag: Function.FLAGS) -> Function: ...
+    require_extended_version = 14
 
-    def has(self, flag: Function.FLAGS) -> bool: ...
+@overload
+def hash(arg: Object, /) -> int: ... # type: ignore
 
-    @property
-    def flags(self) -> Function.FLAGS: ...
+@overload
+def hash(arg: Sequence[int], /) -> int: ... # type: ignore
 
-    @property
-    def flags_list(self) -> list[Function.FLAGS]: ...
+@overload
+def hash(arg: bytes, /) -> int: ... # type: ignore
 
-    address: int
+@overload
+def hash(arg: str, /) -> int: ... # type: ignore
 
-    def __str__(self) -> str: ...
+def to_json(arg: Object, /) -> str: ...
 
 class Header(Object):
     class ARCHITECTURES(enum.Enum):
@@ -261,6 +202,8 @@ class Header(Object):
 
         LOONGARCH = 11
 
+        PPC64 = 12
+
     class ENDIANNESS(enum.Enum):
         @staticmethod
         def from_value(arg: int, /) -> Header.ENDIANNESS: ...
@@ -343,37 +286,142 @@ class Header(Object):
 
     def __str__(self) -> str: ...
 
-class Object:
-    def __hash__(self) -> int: ...
+class Binary(Object):
+    class VA_TYPES(enum.Enum):
+        AUTO = 0
 
-    def __eq__(self, arg, /) -> bool: ...
+        RVA = 1
 
-class PLATFORMS(enum.Enum):
-    @staticmethod
-    def from_value(arg: int, /) -> PLATFORMS: ...
+        VA = 2
 
-    def __eq__(self, arg, /) -> bool: ...
+    class FORMATS(enum.Enum):
+        UNKNOWN = 0
 
-    def __ne__(self, arg, /) -> bool: ...
+        ELF = 1
 
-    def __int__(self) -> int: ...
+        PE = 2
 
-    UNKNOWN = 3
+        MACHO = 3
 
-    LINUX = 1
+        OAT = 4
 
-    ANDROID = 2
+    class it_sections:
+        def __getitem__(self, arg: int, /) -> Section: ...
 
-    WINDOWS = 3
+        def __len__(self) -> int: ...
 
-    IOS = 4
+        def __iter__(self) -> Binary.it_sections: ...
 
-    OSX = 5
+        def __next__(self) -> Section: ...
 
-class Relocation(Object):
-    address: int
+    class it_symbols:
+        def __getitem__(self, arg: int, /) -> Symbol: ...
 
-    size: int
+        def __len__(self) -> int: ...
+
+        def __iter__(self) -> Binary.it_symbols: ...
+
+        def __next__(self) -> Symbol: ...
+
+    class it_relocations:
+        def __getitem__(self, arg: int, /) -> Relocation: ...
+
+        def __len__(self) -> int: ...
+
+        def __iter__(self) -> Binary.it_relocations: ...
+
+        def __next__(self) -> Relocation: ...
+
+    @property
+    def debug_info(self) -> DebugInfo: ...
+
+    @property
+    def format(self) -> Binary.FORMATS: ...
+
+    @property
+    def is_pie(self) -> bool: ...
+
+    @property
+    def has_nx(self) -> bool: ...
+
+    @property
+    def header(self) -> Header: ...
+
+    @property
+    def entrypoint(self) -> int: ...
+
+    def remove_section(self, name: str, clear: bool = False) -> None: ...
+
+    @property
+    def sections(self) -> Binary.it_sections: ...
+
+    @property
+    def relocations(self) -> Binary.it_relocations: ...
+
+    @property
+    def exported_functions(self) -> list[Function]: ...
+
+    @property
+    def imported_functions(self) -> list[Function]: ...
+
+    @property
+    def libraries(self) -> list[Union[str,bytes]]: ...
+
+    @property
+    def symbols(self) -> Binary.it_symbols: ...
+
+    def has_symbol(self, symbol_name: str) -> bool: ...
+
+    def get_symbol(self, symbol_name: str) -> Symbol: ...
+
+    def get_function_address(self, function_name: str) -> Union[int, lief_errors]: ...
+
+    @overload
+    def patch_address(self, address: int, patch_value: Sequence[int], va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> None: ...
+
+    @overload
+    def patch_address(self, address: int, patch_value: int, size: int = 8, va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> None: ...
+
+    def get_content_from_virtual_address(self, virtual_address: int, size: int, va_type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> memoryview: ...
+
+    def get_int_from_virtual_address(self, address: int, interger_size: int, type: Binary.VA_TYPES = Binary.VA_TYPES.AUTO) -> Optional[int]: ...
+
+    @property
+    def abstract(self) -> lief.Binary: ...
+
+    @property
+    def concrete(self) -> lief.ELF.Binary | lief.PE.Binary | lief.MachO.Binary: ...
+
+    @property
+    def ctor_functions(self) -> list[Function]: ...
+
+    def xref(self, virtual_address: int) -> list[int]: ...
+
+    def offset_to_virtual_address(self, offset: int, slide: int = 0) -> Union[int, lief_errors]: ...
+
+    @property
+    def imagebase(self) -> int: ...
+
+    @property
+    def original_size(self) -> int: ...
+
+    @overload
+    def disassemble(self, address: int) -> Iterator[Optional[assembly.Instruction]]: ...
+
+    @overload
+    def disassemble(self, address: int, size: int) -> Iterator[Optional[assembly.Instruction]]: ...
+
+    @overload
+    def disassemble(self, function_name: str) -> Iterator[Optional[assembly.Instruction]]: ...
+
+    def disassemble_from_bytes(self, buffer: bytes, address: int = 0) -> Iterator[Optional[assembly.Instruction]]: ...
+
+    def assemble(self, address: int, assembly: str, config: assembly.AssemblerConfig = ...) -> bytes: ...
+
+    @property
+    def page_size(self) -> int: ...
+
+    def load_debug_info(self, path: Union[str | os.PathLike]) -> DebugInfo: ...
 
     def __str__(self) -> str: ...
 
@@ -420,150 +468,133 @@ class Symbol(Object):
 
     def __str__(self) -> str: ...
 
-__commit__: str = ...
-
-__extended__: bool = ...
-
-__is_tagged__: bool = ...
-
-__tag__: str = ...
-
-def current_platform() -> PLATFORMS: ...
-
-class debug_location_t:
-    line: int
-
-    file: str
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]]) -> PE.Binary | OAT.Binary | ELF.Binary | MachO.Binary | COFF.Binary | None: ...
 
-    def __repr__(self) -> str: ...
-
-def demangle(mangled: str) -> Optional[str]: ...
+class Relocation(Object):
+    address: int
 
-def disable_leak_warning() -> None: ...
+    size: int
 
-@overload
-def hash(arg: Object, /) -> int: ... # type: ignore
+    def __str__(self) -> str: ...
 
-@overload
-def hash(arg: Sequence[int], /) -> int: ... # type: ignore
+class Function(Symbol):
+    @overload
+    def __init__(self) -> None: ...
 
-@overload
-def hash(arg: bytes, /) -> int: ... # type: ignore
+    @overload
+    def __init__(self, arg: str, /) -> None: ...
 
-@overload
-def hash(arg: str, /) -> int: ... # type: ignore
+    @overload
+    def __init__(self, arg: int, /) -> None: ...
 
-@overload
-def is_art(path: str) -> bool: ...
+    @overload
+    def __init__(self, arg0: str, arg1: int, /) -> None: ...
 
-@overload
-def is_art(raw: Sequence[int]) -> bool: ...
+    class FLAGS(enum.Flag):
+        @staticmethod
+        def from_value(arg: int, /) -> Function.FLAGS: ...
 
-@overload
-def is_dex(path: str) -> bool: ...
+        def __eq__(self, arg, /) -> bool: ...
 
-@overload
-def is_dex(raw: Sequence[int]) -> bool: ...
+        def __ne__(self, arg, /) -> bool: ...
 
-@overload
-def is_elf(filename: str) -> bool: ...
+        def __int__(self) -> int: ...
 
-@overload
-def is_elf(raw: Sequence[int]) -> bool: ...
+        NONE = 0
 
-@overload
-def is_macho(filename: str) -> bool: ...
+        IMPORTED = 16
 
-@overload
-def is_macho(raw: Sequence[int]) -> bool: ...
+        EXPORTED = 8
 
-@overload
-def is_oat(binary: ELF.Binary) -> bool: ...
+        CONSTRUCTOR = 1
 
-@overload
-def is_oat(path: str) -> bool: ...
+        DESTRUCTOR = 2
 
-@overload
-def is_oat(raw: Sequence[int]) -> bool: ...
+        DEBUG_INFO = 4
 
-@overload
-def is_pe(file: str) -> bool: ...
+    def add(self, flag: Function.FLAGS) -> Function: ...
 
-@overload
-def is_pe(raw: Sequence[int]) -> bool: ...
+    def has(self, flag: Function.FLAGS) -> bool: ...
 
-@overload
-def is_vdex(path: str) -> bool: ...
+    @property
+    def flags(self) -> Function.FLAGS: ...
 
-@overload
-def is_vdex(raw: Sequence[int]) -> bool: ...
+    @property
+    def flags_list(self) -> list[Function.FLAGS]: ...
 
-class lief_errors(enum.Enum):
-    read_error = 1
+    address: int
 
-    not_found = 2
+    def __str__(self) -> str: ...
 
-    not_implemented = 3
+class DebugInfo:
+    class FORMAT(enum.Enum):
+        @staticmethod
+        def from_value(arg: int, /) -> DebugInfo.FORMAT: ...
 
-    not_supported = 4
+        def __eq__(self, arg, /) -> bool: ...
 
-    corrupted = 5
+        def __ne__(self, arg, /) -> bool: ...
 
-    conversion_error = 6
+        def __int__(self) -> int: ...
 
-    read_out_of_bound = 7
+        UNKNOWN = 0
 
-    asn1_bad_tag = 8
+        DWARF = 1
 
-    file_error = 9
+        PDB = 2
 
-    file_format_error = 10
+    @property
+    def format(self) -> DebugInfo.FORMAT: ...
 
-    parsing_error = 11
+    def find_function_address(self, name: str) -> int | None: ...
 
-    build_error = 12
+def is_pdb(file: Union[str | os.PathLike]) -> bool: ...
 
-    data_too_large = 13
+def is_shared_cache(file: Union[str | os.PathLike]) -> bool: ...
 
-    require_extended_version = 14
+@overload
+def is_elf(filename: Union[str | os.PathLike]) -> bool: ...
 
-class ok_error_t:
-    @property
-    def is_error(self) -> bool: ...
+@overload
+def is_elf(raw: Sequence[int]) -> bool: ...
 
-    @property
-    def is_value(self) -> bool: ...
+@overload
+def is_pe(file: Union[str | os.PathLike]) -> bool: ...
 
-    @property
-    def error(self) -> lief_errors: ...
+@overload
+def is_pe(raw: Sequence[int]) -> bool: ...
 
-    @property
-    def value(self) -> ok_t: ...
+@overload
+def is_macho(filename: Union[str | os.PathLike]) -> bool: ...
 
-    def __bool__(self) -> bool: ...
+@overload
+def is_macho(raw: Sequence[int]) -> bool: ...
 
-class ok_t:
-    def __bool__(self) -> bool: ...
+@overload
+def is_oat(binary: ELF.Binary) -> bool: ...
 
 @overload
-def parse(raw: bytes) -> Optional[Binary]: ...
+def is_oat(path: str) -> bool: ...
 
 @overload
-def parse(filepath: str) -> Optional[Binary]: ...
+def is_oat(raw: Sequence[int]) -> bool: ...
 
 @overload
-def parse(obj: Union[io.IOBase | os.PathLike]) -> Optional[Binary]: ...
+def is_dex(path: str) -> bool: ...
 
-class range_t:
-    low: int
+@overload
+def is_dex(raw: Sequence[int]) -> bool: ...
 
-    high: int
+@overload
+def is_vdex(path: str) -> bool: ...
 
-    @property
-    def size(self) -> int: ...
+@overload
+def is_vdex(raw: Sequence[int]) -> bool: ...
 
-    def __repr__(self) -> str: ...
+@overload
+def is_art(path: str) -> bool: ...
 
-    def __str__(self) -> str: ...
+@overload
+def is_art(raw: Sequence[int]) -> bool: ...
 
-def to_json(arg: Object, /) -> str: ...
+def is_coff(file: Union[str | os.PathLike]) -> bool: ...