objutils 0.10.13__tar.gz → 0.10.15__tar.gz

objutils-0.10.15/.idea/pyLspTools.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PyToolsState">
+    <option name="tools">
+      <map>
+        <entry key="ruff">
+          <value>
+            <ToolEntry>
+              <option name="enabled" value="true" />
+            </ToolEntry>
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+</project>

{objutils-0.10.13 → objutils-0.10.15}/.pre-commit-config.yaml

@@ -42,7 +42,7 @@ repos:
         args: ["--line-length=132"]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.21
+    rev: v0.16.0
     hooks:
       - id: ruff
         args: ["--fix", "--exit-non-zero-on-fix"]

{objutils-0.10.13 → objutils-0.10.15}/CMakeLists.txt

@@ -82,7 +82,11 @@ set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
 include_directories(${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions ${PROJECT_SOURCE_DIR}/objutils/aml)
 
-pybind11_add_module(hexfiles_ext ${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions/wrapper.cpp ${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions/exceptions.cpp)
+pybind11_add_module(hexfiles_ext
+    ${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions/wrapper.cpp
+    ${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions/exceptions.cpp
+    ${CMAKE_CURRENT_SOURCE_DIR}/objutils/extensions/elf_parser.cpp
+)
 
 target_compile_options(hexfiles_ext PUBLIC "-DEXTENSION_NAME=hexfiles_ext" PUBLIC $<$<AND:$<COMPILE_LANGUAGE:CXX>,$<CXX_COMPILER_ID:MSVC>>:/utf-8>)
 

{objutils-0.10.13 → objutils-0.10.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: objutils
-Version: 0.10.13
+Version: 0.10.15
 Summary: Objectfile library for Python
 Keywords: hex files,intel hex,s19,srec,srecords,object files,map files,embedded,microcontroller,ECU,shf,rfc4194
 Author-Email: Christoph Schueler <cpu12.gems@googlemail.com>
@@ -87,6 +87,9 @@ Features
 Recent improvements
 -------------------
 
+- ``ElfParser`` now supports ``in_memory=True``: use a transient ``:memory:`` SQLite
+  database instead of persisting a .prgdb file – ideal for read-only analysis, CI
+  pipelines and unit tests.
 - New ``oj-hex-merge`` and ``oj-hex-split`` CLI tools for combining and partitioning HEX files.
 - New ``oj-dwarf-import`` CLI replaces ``dwarfer.py``/``cu_info.py`` for DWARF imports, CU listing, summaries, and attribute traversal.
 - Faster DWARF imports: batched ORM writes, quiet flag propagation, and safe DWARF expression evaluation keep large ELF files stable.

{objutils-0.10.13 → objutils-0.10.15}/docs/README.rst

@@ -51,6 +51,9 @@ Features
 Recent improvements
 -------------------
 
+- ``ElfParser`` now supports ``in_memory=True``: use a transient ``:memory:`` SQLite
+  database instead of persisting a .prgdb file – ideal for read-only analysis, CI
+  pipelines and unit tests.
 - New ``oj-hex-merge`` and ``oj-hex-split`` CLI tools for combining and partitioning HEX files.
 - New ``oj-dwarf-import`` CLI replaces ``dwarfer.py``/``cu_info.py`` for DWARF imports, CU listing, summaries, and attribute traversal.
 - Faster DWARF imports: batched ORM writes, quiet flag propagation, and safe DWARF expression evaluation keep large ELF files stable.

{objutils-0.10.13 → objutils-0.10.15}/docs/conf.py

@@ -17,7 +17,7 @@ def get_version():
     import re
     from pathlib import Path
 
-    VERSION = re.compile(r'version\s*=\s*"(?P<version>\d+\.\d+(\.\d+)?)\s*"', re.M)
+    VERSION = re.compile(r'version\s*=\s*"(?P<version>\d+\.\d+(\.\d+)?)\s*"', re.MULTILINE)
 
     try:
         cfg = Path(r"../pyproject.toml")

{objutils-0.10.13 → objutils-0.10.15}/docs/howto.rst

@@ -84,6 +84,29 @@ Use the CLI to generate HEX for flashing:
 
    oj-elf-extract build/app.elf app.srec -t srec
 
+Analyse ELF without writing a .prgdb file (in-memory database)
+---------------------------------------------------------------
+
+By default ``ElfParser`` creates a ``<name>.prgdb`` SQLite cache file next to
+the ELF file.  Pass ``in_memory=True`` to keep everything in memory – useful
+for read-only scripting, CI pipelines, or unit tests where disk writes are
+undesirable.
+
+.. code-block:: python
+
+   from objutils.elf import ElfParser
+
+   # No .prgdb file is created – database lives only in RAM
+   with ElfParser('build/app.elf', in_memory=True) as parser:
+       print(f"Machine: {parser.e_machine}")
+       image = parser.create_image()
+
+.. note::
+
+   The in-memory database is rebuilt on every instantiation (no caching
+   benefit).  Use the default on-disk mode if you parse the same file
+   repeatedly and want fast cached access.
+
 Extract loadable image from PE/COFF (32-bit and 64-bit)
 -------------------------------------------------------
 

{objutils-0.10.13 → objutils-0.10.15}/objutils/__init__.py

@@ -13,20 +13,20 @@ Registers CODECS and implements an interface to them.
 The first parameter is always the codec name.
 """
 
-__version__ = "0.10.13"
+__version__ = "0.10.15"
 
 __all__ = [
     "Image",
-    "Section",
-    "LazySection",
     "InvalidAddressError",
-    "registry",
-    "load",
-    "loads",
+    "LazySection",
+    "Section",
     "dump",
     "dumps",
+    "load",
+    "loads",
     "probe",
     "probes",
+    "registry",
 ]
 
 __copyright__ = """
@@ -76,9 +76,9 @@ import objutils.sig
 import objutils.srec
 import objutils.tek
 import objutils.titxt
-from objutils.image import Image, InvalidAddressError  # noqa: F401
+from objutils.image import Image, InvalidAddressError
 from objutils.registry import registry
-from objutils.section import Section, LazySection  # noqa: F401
+from objutils.section import Section, LazySection
 
 # Optional developer-friendly console and tracebacks; disabled by default for library consumers.
 _ENABLE_RICH = os.getenv("OBJUTILS_RICH", "0").lower() in {"1", "true", "yes"}
@@ -158,7 +158,7 @@ def loads(codec_name: str, data: str | bytes | bytearray, join: bool = True, **k
     return registry.get(codec_name).Reader().loads(data, join=join, **kws)
 
 
-def probe(fp: BinaryIO, **kws: Any) -> Optional[str]:
+def probe(fp: BinaryIO, **kws: Any) -> str | None:
     """Try to guess codec from file.
 
     Returns
@@ -195,7 +195,7 @@ def probe(fp: BinaryIO, **kws: Any) -> Optional[str]:
     return None
 
 
-def probes(data: str | bytes | bytearray, **kws: Any) -> Optional[str]:
+def probes(data: str | bytes | bytearray, **kws: Any) -> str | None:
     """Try to guess codec from bytes.
 
     Returns

{objutils-0.10.13 → objutils-0.10.15}/objutils/ash.py

@@ -44,7 +44,7 @@ import re
 from functools import partial
 from typing import Any
 
-import objutils.hexfile as hexfile
+from objutils import hexfile
 from objutils.checksums import lrc
 
 STX = "\x02"

{objutils-0.10.13 → objutils-0.10.15}/objutils/binfile.py

@@ -26,9 +26,9 @@ __copyright__ = """
 import io
 import zipfile
 from contextlib import closing
-from typing import Any, BinaryIO, Union
+from typing import Any, BinaryIO
 
-import objutils.hexfile as hexfile
+from objutils import hexfile
 from objutils.image import Image
 from objutils.section import Section
 
@@ -42,7 +42,7 @@ class NoContiniousError(Exception):
 
 
 class Reader(hexfile.Reader):
-    def load(self, fp: Union[str, BinaryIO], address: int = 0x0000, **kws: Any) -> Image:
+    def load(self, fp: str | BinaryIO, address: int = 0x0000, **kws: Any) -> Image:
         if isinstance(fp, str):
             fp = open(fp, "rb")
         data = fp.read()
@@ -52,7 +52,7 @@ class Reader(hexfile.Reader):
             fp.close()
         return img
 
-    def loads(self, image: Union[str, bytes, bytearray], address: int = 0x0000, **kws: Any) -> Image:
+    def loads(self, image: str | bytes | bytearray, address: int = 0x0000, **kws: Any) -> Image:
         if isinstance(image, str):
             return self.load(io.BytesIO(bytes(image, "ascii")), address)
         else:
@@ -112,12 +112,12 @@ class BinZipReader(hexfile.Reader):
             except (AttributeError, io.UnsupportedOperation):
                 pass
 
-    def load(self, fp: Union[str, BinaryIO], **kws: Any) -> Image:
+    def load(self, fp: str | BinaryIO, **kws: Any) -> Image:
         """Load from zip file."""
         # TODO: Implementation
         return Image([], valid=True)
 
-    def loads(self, data: Union[str, bytes, bytearray], **kws: Any) -> Image:
+    def loads(self, data: str | bytes | bytearray, **kws: Any) -> Image:
         """Load from zip bytes."""
         return self.load(io.BytesIO(data) if isinstance(data, (bytes, bytearray)) else io.BytesIO(data.encode()))
 

{objutils-0.10.13 → objutils-0.10.15}/objutils/cosmac.py

@@ -40,7 +40,7 @@ __copyright__ = """
 from collections.abc import Sequence
 from typing import Any
 
-import objutils.hexfile as hexfile
+from objutils import hexfile
 
 # Record type identifiers
 DATA0 = 1  # !MAAAA DD
@@ -80,7 +80,7 @@ class Reader(hexfile.Reader):
             Cosmac format has no checksums, validation is minimal.
         """
         # Cosmac has no checksums - nothing to validate
-        return None
+        return
 
     def probe(self, fp: Any, **kws: Any) -> bool:
         """Check if file matches RCA Cosmac format.

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/__init__.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python
-# ruff: noqa: E402
 # Imports come after module docstring
 
 """DWARF 4 debug information parser and processor.
@@ -266,7 +265,7 @@ class Attribute:
 
     encoding: constants.AttributeEncoding
     form: constants.AttributeForm
-    special_value: Optional[Any] = None
+    special_value: Any | None = None
 
     def __iter__(self):
         yield self.encoding
@@ -300,7 +299,6 @@ class Readers:
     Used internally by DwarfReaders to organize parsers.
     """
 
-    pass
 
 
 @dataclass
@@ -531,7 +529,6 @@ class Abbrevations:
                     )
                     continue
                 if attr.attrValue != 0 and attr.formValue != 0:
-                    #
                     try:
                         self.abbrevations[key].attrs.append(
                             Attribute(

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/attrparser.py

@@ -321,7 +321,7 @@ class AttributeParser:
         tag = t.get("tag", "<type>")
         name = ""
         attrs = t.get("attrs", {}) if isinstance(t.get("attrs"), dict) else {}
-        if "name" in attrs and attrs["name"]:
+        if attrs.get("name"):
             try:
                 name = str(attrs["name"])
             except (UnicodeDecodeError, ValueError, TypeError):

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/encoding.py

@@ -63,13 +63,11 @@ class Endianess(IntEnum):
 class ULEBError(ConstructError):
     """Raised when ULEB128 parsing or building encounters an error."""
 
-    pass
 
 
 class SLEBError(ConstructError):
     """Raised when SLEB128 parsing or building encounters an error."""
 
-    pass
 
 
 @singleton
@@ -96,7 +94,7 @@ class ULEB(Construct):
     """
 
     def __init__(self, *args) -> None:
-        super(__class__, self).__init__()
+        super().__init__()
 
     def _parse(self, stream, context, path: str | None = None) -> int:
         """Parse a ULEB128-encoded value from stream.
@@ -171,7 +169,7 @@ class SLEB(Construct):
     """
 
     def __init__(self, *args) -> None:
-        super(__class__, self).__init__()
+        super().__init__()
 
     def _parse(self, stream, context, path: str | None = None) -> int:
         """Parse a SLEB128-encoded value from stream.
@@ -235,7 +233,7 @@ class One(Construct):
     """
 
     def __init__(self, *args) -> None:
-        super(__class__, self).__init__()
+        super().__init__()
 
     def _parse(self, stream, context, path: str | None = None) -> int:
         """Parse returns constant 1."""
@@ -266,7 +264,7 @@ class Block(Construct):
     MASK: str | None = None
 
     def __init__(self, *args) -> None:
-        super(__class__, self).__init__()
+        super().__init__()
 
     def _parse(self, stream, context, path: str | None = None) -> bytes:
         """Parse block data with fixed-size length prefix.
@@ -410,7 +408,7 @@ class Address(Construct):
         Raises:
             ValueError: If size not in (1, 2, 4, 8).
         """
-        super(__class__, self).__init__()
+        super().__init__()
         idx = 0 if endianess == Endianess.Little else 1
         if size not in (1, 2, 4, 8):
             raise ValueError(f"Address size '{size}' not supported.")
@@ -473,7 +471,7 @@ class StrP(Construct):
         self.endianess = endianess
         self.ntype = (Int32ul, Int32ub)[0 if endianess == Endianess.Little else 1]
         self.stype = CString(encoding="utf8")
-        super(__class__, self).__init__()
+        super().__init__()
 
     def _parse(self, stream, context, path: str | None = None) -> str:
         """Parse string pointer and resolve to actual string.

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/readers.py

@@ -68,7 +68,6 @@ class Readers:
         strp, line_strp: String pointer readers.
     """
 
-    pass
 
 
 class DwarfReaders:

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/sm.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python
-# ruff: noqa: E402
 # Imports come after module docstring (standard Python practice)
 
 __copyright__ = """
@@ -370,7 +369,6 @@ class OperationBase:
             Default implementation does nothing (no-op).
             Operations that modify the stack must override this.
         """
-        pass
 
     def __str__(self):
         """Return textual representation of operation with parameters.

{objutils-0.10.13 → objutils-0.10.15}/objutils/dwarf/traverser.py

@@ -117,7 +117,7 @@ from collections import defaultdict
 from dataclasses import dataclass, field
 from functools import lru_cache
 from itertools import groupby
-from typing import Any, Optional, Union
+from typing import Any
 
 from objutils import Image, Section, symbols
 from objutils.dwarf.constants import (
@@ -174,7 +174,7 @@ unions, classes), and special types (typedefs, subroutines, enumerations).
 """
 
 
-def is_type_encoding(encoding: Union[int, AttributeEncoding]) -> bool:
+def is_type_encoding(encoding: int | AttributeEncoding) -> bool:
     """Check if a DWARF tag represents a type definition.
 
     Args:
@@ -359,11 +359,11 @@ class Variable:
     """
 
     name: str
-    section: Optional[str] = field(default=None)
-    elf_location: Optional[int] = field(default=None)
-    dwarf_location: Optional[str] = field(default=None)
+    section: str | None = field(default=None)
+    elf_location: int | None = field(default=None)
+    dwarf_location: str | None = field(default=None)
     static: bool = field(default=False)
-    type_desc: Optional[DIE] = field(default=None)
+    type_desc: DIE | None = field(default=None)
     _allocated: bool = field(default=False, repr=False)
 
 
@@ -400,7 +400,7 @@ Keys are attribute names (str), values are type converters (enum classes or int)
 # 'data_member_location': b'#\x00',
 
 
-def get_attribute(attrs: dict[str, DIEAttribute], key: str, default: Union[int, str]) -> Union[int, str]:
+def get_attribute(attrs: dict[str, DIEAttribute], key: str, default: int | str) -> int | str:
     """Get attribute value from attributes_map with fallback default.
 
     Args:
@@ -417,7 +417,7 @@ def get_attribute(attrs: dict[str, DIEAttribute], key: str, default: Union[int,
         size = get_attribute(die.attributes_map, "byte_size", 0)
         ```
     """
-    attr: Optional[DIEAttribute] = attrs.get(key)
+    attr: DIEAttribute | None = attrs.get(key)
     if attr is None:
         return default
     else:
@@ -760,7 +760,7 @@ class AttributeParser:
             return f"<expr-error:{exc}>"
 
     @lru_cache(maxsize=64 * 1024)
-    def type_tree(self, obj: Union[int, model.DebugInformationEntry, DIEAttribute]) -> dict[str, Any] | CircularReference:
+    def type_tree(self, obj: int | model.DebugInformationEntry | DIEAttribute) -> dict[str, Any] | CircularReference:
         """Resolve and return complete type tree for a DIE, offset, or attribute.
 
         This method accepts multiple input types for convenience:
@@ -810,7 +810,7 @@ class AttributeParser:
         # Case 2: attribute object (expected to be DW_AT_type)
         if isinstance(obj, DIEAttribute):
             # Try to resolve relative ref forms to absolute offset using the parent DIE if available
-            parent: Optional[model.DebugInformationEntry] = getattr(obj, "entry", None)
+            parent: model.DebugInformationEntry | None = getattr(obj, "entry", None)
             off = self._resolve_type_offset(obj, parent)
             if off is None:
                 return {"tag": "<invalid>", "attrs": {}}
@@ -879,7 +879,7 @@ class AttributeParser:
             _allocated=section_name in self.allocated_sections,
         )
 
-    def get_value(self, var: Variable) -> Optional[Any]:
+    def get_value(self, var: Variable) -> Any | None:
         """Extract variable value from ELF section image.
 
         This method resolves the variable's address and extracts its value based
@@ -926,7 +926,7 @@ class AttributeParser:
             # No image for variable, i.e. .bss section and the like.
             return None
         # 1) Resolve address
-        addr: Optional[int] = None
+        addr: int | None = None
         if isinstance(var.elf_location, int):
             addr = var.elf_location
         elif var.dwarf_location is not None:
@@ -948,7 +948,7 @@ class AttributeParser:
             return None
 
         # 2a) Helpers to work with both dict-based and DIE-based nodes
-        def _get_tag(node: Any) -> Optional[str]:
+        def _get_tag(node: Any) -> str | None:
             if node is None:
                 return None
             if isinstance(node, dict):
@@ -1010,7 +1010,7 @@ class AttributeParser:
             return cur
 
         # 2d) Unwrap qualifiers all the way down to base_type
-        def unwrap_to_base(d: Optional[DIE | dict | CircularReference]) -> Optional[DIE]:
+        def unwrap_to_base(d: DIE | dict | CircularReference | None) -> DIE | None:
             # Accept DIE or dict-like from older structures
             seen = 0
             current = d
@@ -1101,7 +1101,7 @@ class AttributeParser:
                     out.append(_reshape(chunk, dims[1:]))
                 return out
 
-            def _element_size(elem: Any) -> Optional[int]:
+            def _element_size(elem: Any) -> int | None:
                 t = _get_tag(elem)
                 attrs = _get_attrs(elem)
                 if t in {"base_type", "pointer_type"}:
@@ -1249,8 +1249,8 @@ class AttributeParser:
     def _resolve_type_offset(
         self,
         type_attr: DIEAttribute,
-        context_die: Optional[model.DebugInformationEntry],
-    ) -> Optional[int]:
+        context_die: model.DebugInformationEntry | None,
+    ) -> int | None:
         """Resolve DW_AT_type attribute value to absolute DIE offset.
 
         Handles CU-relative reference forms (DW_FORM_ref1/2/4/8/udata) by adding