Add empty Python protobuf generation tool (#5)

* Bootstrapped with "poetry new --src grpc_generator"
* Set minimum Python version to 3.11
* Use a namespaced name for the package

Author: jfriedri-ni

tools/grpc_generator/README.md

@@ -0,0 +1,5 @@
+# About
+
+`grpc_generator` is a Python tool that generates gRPC stubs from proto files.
+
+It supports emitting stubs into namespace packages, transforming them as necessary from submodules to subpackages.

tools/grpc_generator/poetry.lock

@@ -0,0 +1,2 @@
+[virtualenvs]
+in-project = true

tools/grpc_generator/poetry.toml

@@ -0,0 +1,51 @@
+[tool.poetry]
+name = "ni-apis-grpc-generator"
+version = "0.1.0"
+license = "MIT"
+description = "Python generator for NI gRPC APIs"
+authors = ["NI <opensource@ni.com>"]
+readme = "README.md"
+packages = [{include = "grpc_generator", from = "src"}]
+
+[tool.poetry.scripts]
+grpc-generator = "grpc_generator.__main__:cli"
+
+[tool.poetry.dependencies]
+python = "^3.11"
+click = "^8.2.1"
+
+[tool.poetry.group.lint.dependencies]
+bandit = { version = ">=1.7", extras = ["toml"] }
+ni-python-styleguide = ">=0.4.1"
+mypy = ">=1.0"
+pyright = { version = ">=1.1.400", extras = ["nodejs"] }
+
+[tool.poetry.group.test.dependencies]
+pytest = ">=7.2"
+pytest-cov = ">=4.0"
+pytest-mock = ">=3.0"
+
+[build-system]
+requires = ["poetry-core>=1.8"]
+build-backend = "poetry.core.masonry.api"
+
+
+[tool.bandit]
+skips = [
+  "B101", # assert_used
+]
+
+[tool.black]
+line-length = 100
+
+[tool.mypy]
+files = "src/,tests/"
+namespace_packages = true
+strict = true
+
+[tool.pyright]
+include = ["src/", "tests/"]
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers"
+testpaths = ["tests"]

tools/grpc_generator/pyproject.toml

@@ -0,0 +1 @@
+"""grpc_generator package."""

tools/grpc_generator/src/grpc_generator/__init__.py

@@ -0,0 +1,22 @@
+"""grpc_generator entry points."""
+
+import logging
+
+import click
+
+from . import generator
+
+
+_logger = logging.getLogger(__name__)
+_logger.addHandler(logging.NullHandler())
+
+
+@click.command()
+@click.help_option()
+def cli() -> None:
+    """Generate gRPC Python stubs from proto files."""
+    generator.handle_cli()
+
+
+if __name__ == "__main__":
+    cli()

tools/grpc_generator/src/grpc_generator/__main__.py

@@ -0,0 +1,22 @@
+"""Generate gRPC Python stubs from proto files."""
+
+import logging
+
+import click
+
+
+_logger = logging.getLogger(__name__)
+_logger.addHandler(logging.NullHandler())
+
+
+def handle_cli() -> None:
+    """Handle the command line interface invocation."""
+    color_world = {
+        "W": "red",
+        "o": "yellow",
+        "r": "green",
+        "l": "blue",
+        "d": "magenta",
+    }
+    message = "".join([click.style(text, color) for text, color in color_world.items()])
+    click.echo(f"Hello {message}!")

tools/grpc_generator/src/grpc_generator/generator.py

@@ -0,0 +1 @@
+"""Tests for grpc_generator."""

tools/grpc_generator/tests/__init__.py

@@ -0,0 +1,12 @@
+"""Tests for the command line interface."""
+
+from click.testing import CliRunner
+
+from grpc_generator import __main__
+
+
+def test_console() -> None:
+    """Does it invoke the base command group?"""
+    runner = CliRunner()
+    result = runner.invoke(__main__.cli)
+    assert result.exit_code == 0