Preparing API rework

Author: Sven Siegmund

src/rtfparse/entities.py

@@ -183,7 +183,7 @@ def __init__(self, config: config_loader.Config, file: io.BufferedReader) -> Non
             else:
                 self.structure.append(Plain_Text(self.config, file))
         # name the group like its first Control Word
-        # this way the renderer will be able to ignore entire groups
+        # this way the renderer will be able to ignore entire groups based on their first control word
         try:
             if isinstance(self.structure[0], Control_Word):
                 self.name = self.structure[0].control_name

src/rtfparse/minimal.py

@@ -1,17 +1,18 @@
 #!/usr/bin/env python
 
 
-def tc(val, nbits):
-    """Compute the 2's complement of int value val. Credit: https://stackoverflow.com/a/37075643/9235421"""
-    if val < 0:
-        if (val + 1).bit_length() >= nbits:
-            raise ValueError(f"Value {val} is out of range of {nbits}-bit value.")
-        val = (1 << nbits) + val
-    else:
-        if val.bit_length() > nbits:
-            raise ValueError(f"Value {val} is out of range of {nbits}-bit value.")
-        # If sign bit is set.
-        if (val & (1 << (nbits - 1))) != 0:
-            # compute negative value.
-            val = val - (1 << nbits)
-    return val
+import pathlib
+from rtfparse.parsers import Rtf_Parser
+from rtfparse.renderers import encapsulated_html
+
+
+parser = Rtf_Parser()
+renderer = encapsulated_html.Encapsulated_HTML()
+source_file = pathlib.Path(r"D:\trace\email\test_mail_sw_release.rtf")
+target_file = pathlib.Path(r"D:\trace\email\extracted_with_rtfparse.html")
+
+
+with open(source_file, mode="rb") as rtf_file:
+    parser.parse_file(rtf_file, default_encoding="cp1252")
+    with open(target_file, mode="w", encoding="utf-8") as html_file:
+        renderer.render(parser.parsed, target_file)