dtlib: add force DT kwarg

Modeled after dtc's --force option, the idea is this will try harder
and harder over time to produce an object despite malformed input.

Signed-off-by: Martí Bolívar <[email protected]>

Author: mbolivar-nordic

scripts/dts/python-devicetree/src/devicetree/dtlib.py

@@ -709,7 +709,8 @@ class DT:
     # Public interface
     #
 
-    def __init__(self, filename: str, include_path: Iterable[str] = ()):
+    def __init__(self, filename: str, include_path: Iterable[str] = (),
+                 force: bool = False):
         """
         Parses a DTS file to create a DT instance. Raises OSError if 'filename'
         can't be opened, and DTError for any parse errors.
@@ -721,9 +722,14 @@ def __init__(self, filename: str, include_path: Iterable[str] = ()):
           An iterable (e.g. list or tuple) containing paths to search for
           /include/d and /incbin/'d files. By default, files are only looked up
           relative to the .dts file that contains the /include/ or /incbin/.
+
+        force:
+          Try not to raise DTError even if the input tree has errors.
+          For experimental use; results not guaranteed.
         """
         self.filename = filename
         self._include_path = list(include_path)
+        self._force = force
 
         with open(filename, encoding="utf-8") as f:
             self._file_contents = f.read()