lief 0.16.5__cp313-cp313-musllinux_1_2_aarch64.whl → 0.17.0__cp313-cp313-musllinux_1_2_aarch64.whl

lief/assembly/x86/operands/__init__.pyi

@@ -1,12 +1,16 @@
 from typing import Iterator, Optional, Union
 
-import lief
+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: ...
@@ -26,7 +30,3 @@ class Memory(lief.assembly.x86.Operand):
 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

@@ -4,8 +4,16 @@ 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: Union[str | os.PathLike]) -> bool: ...
+
 class DyldSharedCache:
     class VERSION(enum.Enum):
         UNKNOWN = 0
@@ -26,7 +34,11 @@ class DyldSharedCache:
 
         DYLD_1042_1 = 8
 
-        UNRELEASED = 9
+        DYLD_1231_3 = 9
+
+        DYLD_1284_13 = 10
+
+        UNRELEASED = 11
 
     class PLATFORM(enum.Enum):
         UNKNOWN = 0
@@ -142,6 +154,12 @@ class DyldSharedCache:
 
     def flush_cache(self) -> None: ...
 
+@overload
+def load(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+@overload
+def load(path: Union[str | os.PathLike], arch: str = '') -> Optional[DyldSharedCache]: ...
+
 class Dylib:
     class extract_opt_t:
         def __init__(self) -> None: ...
@@ -175,46 +193,34 @@ class Dylib:
 
     def get(self, opt: Dylib.extract_opt_t = ...) -> Optional[lief.MachO.Binary]: ...
 
-class MappingInfo:
+class SubCache:
     @property
-    def address(self) -> int: ...
+    def uuid(self) -> list[int]: ...
 
     @property
-    def size(self) -> int: ...
+    def vm_offset(self) -> int: ...
 
     @property
-    def end_address(self) -> int: ...
+    def suffix(self) -> str: ...
 
     @property
-    def file_offset(self) -> int: ...
+    def cache(self) -> Optional[DyldSharedCache]: ...
 
+class MappingInfo:
     @property
-    def max_prot(self) -> int: ...
+    def address(self) -> int: ...
 
     @property
-    def init_prot(self) -> int: ...
+    def size(self) -> int: ...
 
-class SubCache:
     @property
-    def uuid(self) -> list[int]: ...
+    def end_address(self) -> int: ...
 
     @property
-    def vm_offset(self) -> int: ...
+    def file_offset(self) -> int: ...
 
     @property
-    def suffix(self) -> str: ...
+    def max_prot(self) -> int: ...
 
     @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]: ...
+    def init_prot(self) -> int: ...

lief/dwarf/__init__.pyi

@@ -1,113 +1,147 @@
 import enum
+import os
 from typing import Iterator, Optional, Union, overload
 
-from . import parameters as parameters, types as types
+from . import (
+    editor as editor,
+    parameters as parameters,
+    types as types
+)
 import lief
+import lief.assembly
 
 
-class CompilationUnit:
-    class Language:
-        class LANG(enum.Enum):
-            @staticmethod
-            def from_value(arg: int, /) -> CompilationUnit.Language.LANG: ...
+def load(path: Union[str | os.PathLike]) -> Optional[DebugInfo]: ...
 
-            def __eq__(self, arg, /) -> bool: ...
+class Scope:
+    class TYPE(enum.Enum):
+        UNKNOWN = 0
 
-            def __ne__(self, arg, /) -> bool: ...
+        UNION = 1
 
-            def __int__(self) -> int: ...
+        CLASS = 2
 
-            UNKNOWN = 0
+        STRUCT = 3
 
-            C = 1
+        NAMESPACE = 4
 
-            CPP = 2
+        FUNCTION = 5
 
-            RUST = 3
+        COMPILATION_UNIT = 6
 
-            DART = 4
+    @property
+    def name(self) -> str: ...
 
-            MODULA = 5
+    @property
+    def parent(self) -> Optional[Scope]: ...
 
-            FORTRAN = 6
+    @property
+    def type(self) -> Scope.TYPE: ...
 
-            SWIFT = 7
+    def chained(self, sep: str = '::') -> str: ...
 
-            D = 8
+class Type:
+    class KIND(enum.Enum):
+        UNKNOWN = 0
 
-            JAVA = 9
+        UNSPECIFIED = 1
 
-            COBOL = 10
+        BASE = 2
 
-        lang: lief.dwarf.CompilationUnit.Language.LANG
+        CONST_KIND = 3
 
-        version: int
+        CLASS = 4
 
-    @property
-    def name(self) -> str: ...
+        ARRAY = 5
 
-    @property
-    def producer(self) -> str: ...
+        POINTER = 6
 
-    @property
-    def compilation_dir(self) -> str: ...
+        STRUCT = 7
 
-    @property
-    def language(self) -> CompilationUnit.Language: ...
+        UNION = 8
 
-    @property
-    def low_address(self) -> int: ...
+        TYPEDEF = 9
 
-    @property
-    def high_address(self) -> int: ...
+        REF = 10
 
-    @property
-    def size(self) -> int: ...
+        SET_TYPE = 11
 
-    @property
-    def ranges(self) -> list[lief.range_t]: ...
+        STRING = 12
 
-    @overload
-    def find_function(self, name: str) -> Optional[Function]: ...
+        SUBROUTINE = 13
 
-    @overload
-    def find_function(self, addr: int) -> Optional[Function]: ...
+        POINTER_MEMBER = 14
 
-    @overload
-    def find_variable(self, addr: int) -> Optional[Variable]: ...
+        PACKED = 15
 
-    @overload
-    def find_variable(self, name: str) -> Optional[Variable]: ...
+        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 types(self) -> Iterator[Optional[Type]]: ...
+    def kind(self) -> Type.KIND: ...
 
     @property
-    def functions(self) -> Iterator[Optional[Function]]: ...
+    def name(self) -> Optional[str]: ...
 
     @property
-    def imported_functions(self) -> Iterator[Optional[Function]]: ...
+    def size(self) -> Optional[int]: ...
 
     @property
-    def variables(self) -> Iterator[Optional[Variable]]: ...
+    def location(self) -> lief.debug_location_t: ...
 
-class DebugInfo(lief.DebugInfo):
-    @overload
-    def find_function(self, name: str) -> Optional[Function]: ...
+    @property
+    def is_unspecified(self) -> bool: ...
 
-    @overload
-    def find_function(self, addr: int) -> Optional[Function]: ...
+    @property
+    def scope(self) -> Optional[Scope]: ...
 
-    @overload
-    def find_variable(self, addr: int) -> Optional[Variable]: ...
+class Variable:
+    @property
+    def name(self) -> str: ...
 
-    @overload
-    def find_variable(self, name: str) -> Optional[Variable]: ...
+    @property
+    def linkage_name(self) -> str: ...
 
-    def find_type(self, name: str) -> Optional[Type]: ...
+    @property
+    def address(self) -> Optional[int]: ...
 
     @property
-    def compilation_units(self) -> Iterator[Optional[CompilationUnit]]: ...
+    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
@@ -159,134 +193,114 @@ class Parameter:
     @property
     def type(self) -> Optional[Type]: ...
 
-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
+class CompilationUnit:
+    class Language:
+        class LANG(enum.Enum):
+            @staticmethod
+            def from_value(arg: int, /) -> CompilationUnit.Language.LANG: ...
 
-        CONST_KIND = 3
+            def __eq__(self, arg, /) -> bool: ...
 
-        CLASS = 4
+            def __ne__(self, arg, /) -> bool: ...
 
-        ARRAY = 5
+            def __int__(self) -> int: ...
 
-        POINTER = 6
+            UNKNOWN = 0
 
-        STRUCT = 7
+            C = 1
 
-        UNION = 8
+            CPP = 2
 
-        TYPEDEF = 9
+            RUST = 3
 
-        REF = 10
+            DART = 4
 
-        SET_TYPE = 11
+            MODULA = 5
 
-        STRING = 12
+            FORTRAN = 6
 
-        SUBROUTINE = 13
+            SWIFT = 7
 
-        POINTER_MEMBER = 14
+            D = 8
 
-        PACKED = 15
+            JAVA = 9
 
-        FILE = 16
+            COBOL = 10
 
-        THROWN = 17
+        lang: CompilationUnit.Language.LANG
 
-        VOLATILE = 18
+        version: int
 
-        RESTRICT = 19
+    @property
+    def name(self) -> str: ...
 
-        INTERFACE = 20
+    @property
+    def producer(self) -> str: ...
 
-        SHARED = 21
+    @property
+    def compilation_dir(self) -> str: ...
 
-        RVALREF = 22
+    @property
+    def language(self) -> CompilationUnit.Language: ...
 
-        TEMPLATE_ALIAS = 23
+    @property
+    def low_address(self) -> int: ...
 
-        COARRAY = 24
+    @property
+    def high_address(self) -> int: ...
 
-        DYNAMIC = 25
+    @property
+    def size(self) -> int: ...
 
-        ATOMIC = 26
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
 
-        IMMUTABLE = 27
+    @overload
+    def find_function(self, name: str) -> Optional[Function]: ...
 
-        ENUM = 28
+    @overload
+    def find_function(self, addr: int) -> Optional[Function]: ...
 
-    @property
-    def kind(self) -> Type.KIND: ...
+    @overload
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
 
-    @property
-    def name(self) -> Optional[str]: ...
+    @overload
+    def find_variable(self, name: str) -> Optional[Variable]: ...
 
     @property
-    def size(self) -> Optional[int]: ...
+    def types(self) -> Iterator[Optional[Type]]: ...
 
     @property
-    def location(self) -> lief.debug_location_t: ...
+    def functions(self) -> Iterator[Optional[Function]]: ...
 
     @property
-    def is_unspecified(self) -> bool: ...
+    def imported_functions(self) -> Iterator[Optional[Function]]: ...
 
     @property
-    def scope(self) -> Optional[Scope]: ...
+    def variables(self) -> Iterator[Optional[Variable]]: ...
 
-class Variable:
-    @property
-    def name(self) -> str: ...
+class DebugInfo(lief.DebugInfo):
+    @overload
+    def find_function(self, name: str) -> Optional[Function]: ...
 
-    @property
-    def linkage_name(self) -> str: ...
+    @overload
+    def find_function(self, addr: int) -> Optional[Function]: ...
 
-    @property
-    def address(self) -> Optional[int]: ...
+    @overload
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
 
-    @property
-    def size(self) -> Optional[int]: ...
+    @overload
+    def find_variable(self, name: str) -> Optional[Variable]: ...
 
-    @property
-    def is_constexpr(self) -> bool: ...
+    def find_type(self, name: str) -> Optional[Type]: ...
 
     @property
-    def debug_location(self) -> lief.debug_location_t: ...
+    def compilation_units(self) -> Iterator[Optional[CompilationUnit]]: ...
 
-    @property
-    def type(self) -> Optional[Type]: ...
+class Editor:
+    @staticmethod
+    def from_binary(bin: lief.Binary) -> Optional[Editor]: ...
 
-    @property
-    def scope(self) -> Optional[Scope]: ...
+    def create_compilation_unit(self) -> Optional[editor.CompilationUnit]: ...
 
-def load(path: str) -> Optional[DebugInfo]: ...
+    def write(self, output: Union[str | os.PathLike]) -> None: ...

lief/dwarf/editor/__init__.pyi

@@ -0,0 +1,138 @@
+from collections.abc import Sequence
+import enum
+from typing import Iterator, Optional, Union, overload
+
+
+class Type:
+    def pointer_to(self) -> Optional[PointerType]: ...
+
+class PointerType(Type):
+    pass
+
+class EnumType(Type):
+    class Value:
+        pass
+
+    def set_size(self, size: int) -> EnumType: ...
+
+    def add_value(self, name: str, value: int) -> Optional[EnumType.Value]: ...
+
+class BaseType(Type):
+    class ENCODING(enum.Enum):
+        NONE = 0
+
+        ADDRESS = 1
+
+        SIGNED = 2
+
+        SIGNED_CHAR = 3
+
+        UNSIGNED = 4
+
+        UNSIGNED_CHAR = 5
+
+        BOOLEAN = 6
+
+        FLOAT = 7
+
+class ArrayType(Type):
+    pass
+
+class FunctionType(Type):
+    class Parameter:
+        pass
+
+    def set_return_type(self, type: Type) -> FunctionType: ...
+
+    def add_parameter(self, type: Type) -> Optional[FunctionType.Parameter]: ...
+
+class TypeDef(Type):
+    pass
+
+class StructType(Type):
+    class TYPE(enum.Enum):
+        CLASS = 0
+
+        STRUCT = 1
+
+        UNION = 2
+
+    class Member:
+        pass
+
+    def set_size(self, size: int) -> StructType: ...
+
+    def add_member(self, name: str, type: Type, offset: int = -1) -> Optional[StructType.Member]: ...
+
+class Function:
+    class range_t:
+        @overload
+        def __init__(self) -> None: ...
+
+        @overload
+        def __init__(self, start: int, end: int) -> None: ...
+
+        start: int
+
+        end: int
+
+    class Parameter:
+        pass
+
+    class LexicalBlock:
+        pass
+
+    class Label:
+        pass
+
+    def set_address(self, addr: int) -> Function: ...
+
+    def set_low_high(self, low: int, high: int) -> Function: ...
+
+    def set_ranges(self, ranges: Sequence[Function.range_t]) -> Function: ...
+
+    def set_external(self) -> Function: ...
+
+    def set_return_type(self, type: Type) -> Function: ...
+
+    def add_parameter(self, name: str, type: Type) -> Optional[Function.Parameter]: ...
+
+    def create_stack_variable(self, name: str) -> Optional[Variable]: ...
+
+    def add_lexical_block(self, start: int, end: int) -> Optional[Function.LexicalBlock]: ...
+
+    def add_label(self, addr: int, label: str) -> Optional[Function.Label]: ...
+
+class Variable:
+    def set_addr(self, addr: int) -> Variable: ...
+
+    def set_stack_offset(self, offset: int) -> Variable: ...
+
+    def set_external(self) -> Variable: ...
+
+    def set_type(self, type: Type) -> Variable: ...
+
+class CompilationUnit:
+    def set_producer(self, arg: str, /) -> CompilationUnit: ...
+
+    def create_function(self, name: str) -> Optional[Function]: ...
+
+    def create_variable(self, name: str) -> Optional[Variable]: ...
+
+    def create_generic_type(self, name: str) -> Optional[Type]: ...
+
+    def create_enum(self, name: str) -> Optional[EnumType]: ...
+
+    def create_typedef(self, name: str, ty: Type) -> Optional[TypeDef]: ...
+
+    def create_structure(self, name: str, kind: StructType.TYPE = StructType.TYPE.STRUCT) -> Optional[StructType]: ...
+
+    def create_base_type(self, name: str, size: int, encoding: BaseType.ENCODING = BaseType.ENCODING.NONE) -> Optional[BaseType]: ...
+
+    def create_function_type(self, name: str) -> Optional[FunctionType]: ...
+
+    def create_pointer_type(self, ty: Type) -> Optional[PointerType]: ...
+
+    def create_void_type(self) -> Optional[Type]: ...
+
+    def create_array(self, name: str, ty: Type, count: int) -> Optional[ArrayType]: ...

lief/dwarf/parameters/__init__.pyi

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