interface for releasing parser resources

Author: telmomenezes

src/hyperbase/parsers/parser.py

@@ -116,6 +116,16 @@ def install_repl(self, session: Any) -> None:  # noqa: ANN401
         object. The default implementation is a no-op.
         """
 
+    def close(self) -> None:
+        """Release any resources held by this parser (subprocess pools, open
+        files, GPU contexts, ...).
+
+        The default is a no-op. Drivers that run to completion and then exit
+        hard (e.g. via ``os._exit``, which skips atexit and ``__del__``) should
+        call this first, so a parser's worker subprocesses are shut down rather
+        than orphaned. Implementations must be idempotent.
+        """
+
     def get_sentences(self, text: str) -> list[str]:
         raise NotImplementedError