lief 0.15.1__cp313-cp313-macosx_11_0_arm64.whl

lief/VDEX.pyi

@@ -0,0 +1,49 @@
+from typing import Optional, Union
+
+from typing import overload
+import io
+import lief.Android # type: ignore
+import lief.DEX # type: ignore
+import lief.OAT.Binary # type: ignore
+import lief.VDEX # type: ignore
+import os
+
+class File(lief.Object):
+    class it_dex_files:
+        def __init__(self, *args, **kwargs) -> None: ...
+        def __getitem__(self, arg: int, /) -> lief.DEX.File: ...
+        def __iter__(self) -> lief.OAT.Binary.it_dex_files: ...
+        def __len__(self) -> int: ...
+        def __next__(self) -> lief.DEX.File: ...
+    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def dex2dex_json_info(self) -> str: ...
+    @property
+    def dex_files(self) -> lief.OAT.Binary.it_dex_files: ...
+    @property
+    def header(self) -> lief.VDEX.Header: ...
+
+class Header(lief.Object):
+    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def dex_size(self) -> int: ...
+    @property
+    def magic(self) -> list[int]: ...
+    @property
+    def nb_dex_files(self) -> int: ...
+    @property
+    def quickening_info_size(self) -> int: ...
+    @property
+    def verifier_deps_size(self) -> int: ...
+    @property
+    def version(self) -> int: ...
+
+def android_version(vdex_version: int) -> lief.Android.ANDROID_VERSIONS: ...
+@overload
+def parse(filename: str) -> Optional[lief.VDEX.File]: ...
+@overload
+def parse(obj: Union[io.IOBase|os.PathLike], name: str = ...) -> Optional[lief.VDEX.File]: ...
+@overload
+def version(file: str) -> int: ...
+@overload
+def version(raw: list[int]) -> int: ...

lief/__init__.py

@@ -0,0 +1,13 @@
+import os
+import sys
+import traceback
+if len(__path__) > 0 and __path__[0] not in sys.path:
+    from . import _lief
+    from ._lief import *
+    from ._lief import __version__, __tag__, __commit__, __is_tagged__, __extended__
+
+    # cf. https://github.com/pytorch/pytorch/blob/60a3b7425dde97fe8b46183c154a9c3b24f0c733/torch/__init__.py#L467-L470
+    for attr in dir(_lief):
+        candidate = getattr(_lief, attr)
+        if type(candidate) is type(_lief):
+            sys.modules.setdefault(f"lief.{attr}", candidate)

lief/__init__.pyi

@@ -0,0 +1,428 @@
+from typing import Any, ClassVar, Optional, Union
+
+from . import ART, Android, DEX, ELF, MachO, OAT, PE, VDEX, dwarf, logging, objc, pdb # type: ignore
+from typing import overload
+import io
+import lief # type: ignore
+import lief.Binary # type: ignore
+import lief.DebugInfo # type: ignore
+import lief.ELF # type: ignore
+import lief.Function # type: ignore
+import lief.MachO # type: ignore
+import lief.PE # type: ignore
+import lief.logging # type: ignore
+import os
+
+class ARCHITECTURES:
+    ARM: ClassVar[ARCHITECTURES] = ...
+    ARM64: ClassVar[ARCHITECTURES] = ...
+    INTEL: ClassVar[ARCHITECTURES] = ...
+    LOONGARCH: ClassVar[ARCHITECTURES] = ...
+    MIPS: ClassVar[ARCHITECTURES] = ...
+    NONE: ClassVar[ARCHITECTURES] = ...
+    PPC: ClassVar[ARCHITECTURES] = ...
+    RISCV: ClassVar[ARCHITECTURES] = ...
+    SPARC: ClassVar[ARCHITECTURES] = ...
+    SYSZ: ClassVar[ARCHITECTURES] = ...
+    X86: ClassVar[ARCHITECTURES] = ...
+    XCORE: ClassVar[ARCHITECTURES] = ...
+    __name__: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    @staticmethod
+    def from_value(arg: int, /) -> lief.ARCHITECTURES: ...
+    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: ...
+    @property
+    def value(self) -> int: ...
+
+class Binary(Object):
+    class FORMATS:
+        ELF: ClassVar[Binary.FORMATS] = ...
+        MACHO: ClassVar[Binary.FORMATS] = ...
+        OAT: ClassVar[Binary.FORMATS] = ...
+        PE: ClassVar[Binary.FORMATS] = ...
+        UNKNOWN: ClassVar[Binary.FORMATS] = ...
+        __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: ...
+
+    class VA_TYPES:
+        AUTO: ClassVar[Binary.VA_TYPES] = ...
+        RVA: ClassVar[Binary.VA_TYPES] = ...
+        VA: ClassVar[Binary.VA_TYPES] = ...
+        __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: ...
+
+    class it_relocations:
+        def __init__(self, *args, **kwargs) -> None: ...
+        def __getitem__(self, arg: int, /) -> lief.Relocation: ...
+        def __iter__(self) -> lief.Binary.it_relocations: ...
+        def __len__(self) -> int: ...
+        def __next__(self) -> lief.Relocation: ...
+
+    class it_sections:
+        def __init__(self, *args, **kwargs) -> None: ...
+        def __getitem__(self, arg: int, /) -> lief.Section: ...
+        def __iter__(self) -> lief.Binary.it_sections: ...
+        def __len__(self) -> int: ...
+        def __next__(self) -> lief.Section: ...
+
+    class it_symbols:
+        def __init__(self, *args, **kwargs) -> None: ...
+        def __getitem__(self, arg: int, /) -> lief.Symbol: ...
+        def __iter__(self) -> lief.Binary.it_symbols: ...
+        def __len__(self) -> int: ...
+        def __next__(self) -> lief.Symbol: ...
+    def __init__(self, *args, **kwargs) -> None: ...
+    def get_content_from_virtual_address(self, virtual_address: int, size: int, va_type: lief.Binary.VA_TYPES = ...) -> memoryview: ...
+    def get_function_address(self, function_name: str) -> Union[int,lief.lief_errors]: ...
+    def get_symbol(self, symbol_name: str) -> lief.Symbol: ...
+    def has_symbol(self, symbol_name: str) -> bool: ...
+    def offset_to_virtual_address(self, offset: int, slide: int = ...) -> Union[int,lief.lief_errors]: ...
+    @overload
+    def patch_address(self, address: int, patch_value: list[int], va_type: lief.Binary.VA_TYPES = ...) -> None: ...
+    @overload
+    def patch_address(self, address: int, patch_value: int, size: int = ..., va_type: lief.Binary.VA_TYPES = ...) -> None: ...
+    def remove_section(self, name: str, clear: bool = ...) -> None: ...
+    def xref(self, virtual_address: int) -> list[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[lief.Function]: ...
+    @property
+    def debug_info(self) -> lief.DebugInfo: ...
+    @property
+    def entrypoint(self) -> int: ...
+    @property
+    def exported_functions(self) -> list[lief.Function]: ...
+    @property
+    def format(self) -> lief.Binary.FORMATS: ...
+    @property
+    def has_nx(self) -> bool: ...
+    @property
+    def header(self) -> lief.Header: ...
+    @property
+    def imagebase(self) -> int: ...
+    @property
+    def imported_functions(self) -> list[lief.Function]: ...
+    @property
+    def is_pie(self) -> bool: ...
+    @property
+    def libraries(self) -> list[Union[str,bytes]]: ...
+    @property
+    def original_size(self) -> int: ...
+    @property
+    def relocations(self) -> lief.Binary.it_relocations: ...
+    @property
+    def sections(self) -> lief.Binary.it_sections: ...
+    @property
+    def symbols(self) -> lief.Binary.it_symbols: ...
+
+class DebugInfo:
+    class FORMAT:
+        DWARF: ClassVar[DebugInfo.FORMAT] = ...
+        PDB: ClassVar[DebugInfo.FORMAT] = ...
+        UNKNOWN: ClassVar[DebugInfo.FORMAT] = ...
+        __name__: str
+        def __init__(self, *args, **kwargs) -> None: ...
+        @staticmethod
+        def from_value(arg: int, /) -> lief.DebugInfo.FORMAT: ...
+        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: ...
+        @property
+        def value(self) -> int: ...
+    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def format(self) -> lief.DebugInfo.FORMAT: ...
+
+class ENDIANNESS:
+    BIG: ClassVar[ENDIANNESS] = ...
+    LITTLE: ClassVar[ENDIANNESS] = ...
+    NONE: ClassVar[ENDIANNESS] = ...
+    __name__: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    @staticmethod
+    def from_value(arg: int, /) -> lief.ENDIANNESS: ...
+    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: ...
+    @property
+    def value(self) -> int: ...
+
+class Function(Symbol):
+    class FLAGS:
+        CONSTRUCTOR: ClassVar[Function.FLAGS] = ...
+        DEBUG_INFO: ClassVar[Function.FLAGS] = ...
+        DESTRUCTOR: ClassVar[Function.FLAGS] = ...
+        EXPORTED: ClassVar[Function.FLAGS] = ...
+        IMPORTED: ClassVar[Function.FLAGS] = ...
+        __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: ...
+    address: int
+    @overload
+    def __init__(self) -> None: ...
+    @overload
+    def __init__(self, arg: str, /) -> None: ...
+    @overload
+    def __init__(self, arg: int, /) -> None: ...
+    @overload
+    def __init__(self, arg0: str, arg1: int, /) -> None: ...
+    def add(self, flag: lief.Function.FLAGS) -> lief.Function: ...
+    @property
+    def flags(self) -> list[lief.Function.FLAGS]: ...
+
+class Header(Object):
+    architecture: lief.ARCHITECTURES
+    endianness: lief.ENDIANNESS
+    entrypoint: int
+    modes: set[lief.MODES]
+    object_type: lief.OBJECT_TYPES
+    def __init__(self) -> None: ...
+    @property
+    def is_32(self) -> bool: ...
+    @property
+    def is_64(self) -> bool: ...
+
+class MODES:
+    ARM: ClassVar[MODES] = ...
+    M16: ClassVar[MODES] = ...
+    M32: ClassVar[MODES] = ...
+    M64: ClassVar[MODES] = ...
+    MCLASS: ClassVar[MODES] = ...
+    MIPS3: ClassVar[MODES] = ...
+    MIPS32: ClassVar[MODES] = ...
+    MIPS32R6: ClassVar[MODES] = ...
+    MIPS64: ClassVar[MODES] = ...
+    MIPSGP64: ClassVar[MODES] = ...
+    NONE: ClassVar[MODES] = ...
+    THUMB: ClassVar[MODES] = ...
+    UNDEFINED: ClassVar[MODES] = ...
+    V7: ClassVar[MODES] = ...
+    V8: ClassVar[MODES] = ...
+    V9: ClassVar[MODES] = ...
+    __name__: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    @staticmethod
+    def from_value(arg: int, /) -> lief.MODES: ...
+    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: ...
+    @property
+    def value(self) -> int: ...
+
+class OBJECT_TYPES:
+    EXECUTABLE: ClassVar[OBJECT_TYPES] = ...
+    LIBRARY: ClassVar[OBJECT_TYPES] = ...
+    NONE: ClassVar[OBJECT_TYPES] = ...
+    OBJECT: ClassVar[OBJECT_TYPES] = ...
+    __name__: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    @staticmethod
+    def from_value(arg: int, /) -> lief.OBJECT_TYPES: ...
+    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: ...
+    @property
+    def value(self) -> int: ...
+
+class Object:
+    def __init__(self, *args, **kwargs) -> None: ...
+    def __hash__(self) -> int: ...
+
+class PLATFORMS:
+    ANDROID: ClassVar[PLATFORMS] = ...
+    IOS: ClassVar[PLATFORMS] = ...
+    LINUX: ClassVar[PLATFORMS] = ...
+    OSX: ClassVar[PLATFORMS] = ...
+    UNKNOWN: ClassVar[PLATFORMS] = ...
+    WINDOWS: ClassVar[PLATFORMS] = ...
+    __name__: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    @staticmethod
+    def from_value(arg: int, /) -> lief.PLATFORMS: ...
+    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: ...
+    @property
+    def value(self) -> int: ...
+
+class Relocation(Object):
+    address: int
+    size: int
+    def __init__(self, *args, **kwargs) -> None: ...
+
+class Section(Object):
+    content: memoryview
+    name: Union[str,bytes]
+    offset: int
+    size: int
+    virtual_address: int
+    def __init__(self, *args, **kwargs) -> None: ...
+    @overload
+    def search(self, number: int, pos: int = ..., size: int = ...) -> Optional[int]: ...
+    @overload
+    def search(self, str: str, pos: int = ...) -> Optional[int]: ...
+    @overload
+    def search(self, bytes: bytes, pos: int = ...) -> Optional[int]: ...
+    @overload
+    def search_all(self, number: int, size: int = ...) -> list[int]: ...
+    @overload
+    def search_all(self, str: str) -> list[int]: ...
+    @property
+    def entropy(self) -> float: ...
+    @property
+    def fullname(self) -> bytes: ...
+
+class Symbol(Object):
+    name: Union[str,bytes]
+    size: int
+    value: int
+    def __init__(self, *args, **kwargs) -> None: ...
+
+class debug_location_t:
+    file: str
+    line: int
+    def __init__(self, *args, **kwargs) -> None: ...
+
+class lief_errors:
+    asn1_bad_tag: ClassVar[lief_errors] = ...
+    build_error: ClassVar[lief_errors] = ...
+    conversion_error: ClassVar[lief_errors] = ...
+    corrupted: ClassVar[lief_errors] = ...
+    data_too_large: ClassVar[lief_errors] = ...
+    file_error: ClassVar[lief_errors] = ...
+    file_format_error: ClassVar[lief_errors] = ...
+    not_found: ClassVar[lief_errors] = ...
+    not_implemented: ClassVar[lief_errors] = ...
+    not_supported: ClassVar[lief_errors] = ...
+    parsing_error: ClassVar[lief_errors] = ...
+    read_error: ClassVar[lief_errors] = ...
+    read_out_of_bound: ClassVar[lief_errors] = ...
+    __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: ...
+
+class ok_error_t:
+    def __init__(self, *args, **kwargs) -> None: ...
+    def __bool__(self) -> bool: ...
+    @property
+    def error(self) -> lief_errors: ...
+    @property
+    def is_error(self) -> bool: ...
+    @property
+    def is_value(self) -> bool: ...
+    @property
+    def value(self) -> lief.ok_t: ...
+
+class ok_t:
+    def __init__(self, *args, **kwargs) -> None: ...
+    def __bool__(self) -> bool: ...
+
+class range_t:
+    high: int
+    low: int
+    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def size(self) -> int: ...
+
+def current_platform() -> lief.PLATFORMS: ...
+def disable_leak_warning() -> None: ...
+@overload
+def hash(arg: lief.Object, /) -> int: ...
+@overload
+def hash(arg: list[int], /) -> int: ...
+@overload
+def hash(arg: bytes, /) -> int: ...
+@overload
+def hash(arg: str, /) -> int: ...
+@overload
+def is_art(path: str) -> bool: ...
+@overload
+def is_art(raw: list[int]) -> bool: ...
+@overload
+def is_dex(path: str) -> bool: ...
+@overload
+def is_dex(raw: list[int]) -> bool: ...
+@overload
+def is_elf(filename: str) -> bool: ...
+@overload
+def is_elf(raw: list[int]) -> bool: ...
+@overload
+def is_macho(filename: str) -> bool: ...
+@overload
+def is_macho(raw: list[int]) -> bool: ...
+@overload
+def is_oat(binary: lief.ELF.Binary) -> bool: ...
+@overload
+def is_oat(path: str) -> bool: ...
+@overload
+def is_oat(raw: list[int]) -> bool: ...
+@overload
+def is_pe(file: str) -> bool: ...
+@overload
+def is_pe(raw: list[int]) -> bool: ...
+@overload
+def is_vdex(path: str) -> bool: ...
+@overload
+def is_vdex(raw: list[int]) -> bool: ...
+@overload
+def parse(raw: bytes) -> Optional[lief.Binary]: ...
+@overload
+def parse(filepath: str) -> Optional[lief.Binary]: ...
+@overload
+def parse(obj: Union[io.IOBase|os.PathLike]) -> Optional[lief.Binary]: ...
+def to_json(arg: lief.Object, /) -> str: ...

lief/dwarf/__init__.pyi

@@ -0,0 +1,193 @@
+from typing import Any, ClassVar, Iterator, Optional
+
+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: ...
+            @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 __int__(self) -> int: ...
+            def __le__(self, other) -> bool: ...
+            def __lt__(self, other) -> bool: ...
+            @property
+            def value(self) -> int: ...
+        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: ...
+    @property
+    def functions(self) -> Iterator[Optional[lief.dwarf.Function]]: ...
+    @property
+    def high_address(self) -> int: ...
+    @property
+    def language(self) -> lief.dwarf.CompilationUnit.Language: ...
+    @property
+    def low_address(self) -> int: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def producer(self) -> str: ...
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
+    @property
+    def size(self) -> int: ...
+    @property
+    def types(self) -> Iterator[Optional[lief.dwarf.Type]]: ...
+    @property
+    def variables(self) -> Iterator[Optional[lief.dwarf.Variable]]: ...
+
+class DebugInfo(lief.DebugInfo):
+    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]: ...
+    def find_type(self, name: str) -> Optional[lief.dwarf.Type]: ...
+    @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_units(self) -> Iterator[Optional[lief.dwarf.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 address(self) -> Optional[int]: ...
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+    @property
+    def is_artificial(self) -> bool: ...
+    @property
+    def linkage_name(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def parameters(self) -> list[lief.dwarf.Function.Parameter]: ...
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
+    @property
+    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    @property
+    def size(self) -> int: ...
+    @property
+    def type(self) -> Optional[lief.dwarf.Type]: ...
+    @property
+    def variables(self) -> Iterator[Optional[lief.dwarf.Variable]]: ...
+
+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: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def parent(self) -> Optional[lief.dwarf.Scope]: ...
+    @property
+    def type(self) -> lief.dwarf.Scope.TYPE: ...
+
+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: ...
+    @property
+    def is_unspecified(self) -> bool: ...
+    @property
+    def kind(self) -> lief.dwarf.Type.KIND: ...
+    @property
+    def location(self) -> lief.debug_location_t: ...
+    @property
+    def name(self) -> Optional[str]: ...
+    @property
+    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    @property
+    def size(self) -> Optional[int]: ...
+
+class Variable:
+    def __init__(self, *args, **kwargs) -> None: ...
+    @property
+    def address(self) -> Optional[int]: ...
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+    @property
+    def is_constexpr(self) -> bool: ...
+    @property
+    def linkage_name(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def scope(self) -> Optional[lief.dwarf.Scope]: ...
+    @property
+    def size(self) -> Optional[int]: ...
+    @property
+    def type(self) -> Optional[lief.dwarf.Type]: ...
+
+def load(path: str) -> Optional[lief.dwarf.DebugInfo]: ...