dbrownell-parserlib 0.4.0__tar.gz → 0.5.0__tar.gz

{dbrownell_parserlib-0.4.0 → dbrownell_parserlib-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dbrownell-parserlib
-Version: 0.4.0
+Version: 0.5.0
 Summary: Functionality useful when creating parsers.
 Author: Dave Brownell
 Author-email: Dave Brownell <github@DavidBrownell.com>
@@ -10,6 +10,7 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: dbrownell-common>=0.16.8
 Requires-Python: >=3.14
 Project-URL: Homepage, https://github.com/davidbrownell/dbrownell_ParserLib
 Project-URL: Documentation, https://github.com/davidbrownell/dbrownell_ParserLib

{dbrownell_parserlib-0.4.0 → dbrownell_parserlib-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dbrownell-parserlib"
-version = "0.4.0"
+version = "0.5.0"
 #          ^^^^^
 # Wheel names will be generated according to this value. Do not manually modify this value; instead
 # update it according to committed changes by running this command from the root of the repository:
@@ -13,7 +13,9 @@ authors = [
     { name = "Dave Brownell", email = "github@DavidBrownell.com" }
 ]
 requires-python = ">= 3.14"
-dependencies = []
+dependencies = [
+    "dbrownell-common>=0.16.8",
+]
 classifiers = [
     "Operating System :: MacOS",
     "Operating System :: Microsoft :: Windows",

{dbrownell_parserlib-0.4.0 → dbrownell_parserlib-0.5.0}/src/dbrownell_ParserLib/__init__.py

@@ -2,12 +2,15 @@
 
 from importlib.metadata import version
 
+from dbrownell_ParserLib.antlr import BuildAntlrGrammar
 from dbrownell_ParserLib.errors import Error, PythonError
 from dbrownell_ParserLib.location import Location
 from dbrownell_ParserLib.region import Region
 
+
 # ----------------------------------------------------------------------
 __all__ = [
+    "BuildAntlrGrammar",
     "Error",
     "Location",
     "PythonError",

dbrownell_parserlib-0.5.0/src/dbrownell_ParserLib/antlr/__init__.py

@@ -0,0 +1,8 @@
+# noqa: D104
+from dbrownell_ParserLib.antlr.build_antlr_grammar import BuildAntlrGrammar
+
+
+# ----------------------------------------------------------------------
+__all__ = [
+    "BuildAntlrGrammar",
+]

dbrownell_parserlib-0.5.0/src/dbrownell_ParserLib/antlr/build_antlr_grammar/__init__.py

@@ -0,0 +1,45 @@
+# noqa: D104
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from dbrownell_Common import SubprocessEx
+
+if TYPE_CHECKING:
+    from dbrownell_Common.Streams.DoneManager import DoneManager
+
+
+# ----------------------------------------------------------------------
+def BuildAntlrGrammar(
+    dm: DoneManager,
+    antlr_grammar_filename: Path,
+    output_dir: Path,
+    *,
+    create_init_file: bool = True,
+    create_gitignore_file: bool = True,
+) -> None:
+    """Build the Antlr grammar; note that java must be available on the command line."""
+
+    with dm.Nested(f"Generating '{antlr_grammar_filename.name}'...") as generate_dm:
+        jar_filename = Path(__file__).parent / "antlr-4.13.2-complete.jar"
+        assert jar_filename.is_file(), jar_filename
+
+        command_line = f'java -jar "{jar_filename}" -Dlanguage=Python3 -o "{output_dir}" -no-listener -visitor "{antlr_grammar_filename}"'
+
+        generate_dm.WriteVerbose(f"Command line: {command_line}\n\n")
+
+        with generate_dm.YieldStream() as stream:
+            generate_dm.result = SubprocessEx.Stream(command_line, stream)
+            if generate_dm.result != 0:
+                return
+
+        if create_init_file:
+            init_filename = output_dir / "__init__.py"
+
+            if not init_filename.is_file():
+                init_filename.touch()
+
+        if create_gitignore_file:
+            gitignore_filename = output_dir / ".gitignore"
+
+            if not gitignore_filename.is_file():
+                gitignore_filename.write_text("*\n")