Use entrypoints for dev and compile tailwind

Author: davegaeddert

plain-dev/plain/dev/cli.py

@@ -3,6 +3,7 @@
 import platform
 import subprocess
 import sys
+from importlib.metadata import entry_points
 from importlib.util import find_spec
 from pathlib import Path
 
@@ -16,7 +17,9 @@
 from .pid import Pid
 from .poncho.manager import Manager as PonchoManager
 from .services import Services
-from .utils import has_pyproject_toml, plainpackage_installed
+from .utils import has_pyproject_toml
+
+ENTRYPOINT_GROUP = "plain.dev"
 
 
 @click.group(invoke_without_command=True)
@@ -46,6 +49,24 @@ def services():
     Services().run()
 
 
+@cli.command()
+@click.option(
+    "--list", "-l", "show_list", is_flag=True, help="List available entrypoints"
+)
+@click.argument("entrypoint", required=False)
+def entrypoint(show_list, entrypoint):
+    f"""Entrypoints registered under {ENTRYPOINT_GROUP}"""
+    if not show_list and not entrypoint:
+        click.secho("Please provide an entrypoint name or use --list", fg="red")
+        sys.exit(1)
+
+    for entry_point in entry_points().select(group=ENTRYPOINT_GROUP):
+        if show_list:
+            click.echo(entry_point.name)
+        elif entrypoint == entry_point.name:
+            entry_point.load()()
+
+
 class Dev:
     def __init__(self, *, port):
         self.poncho = PonchoManager()
@@ -82,7 +103,7 @@ def run(self):
 
             # Processes for poncho to run simultaneously
             self.add_gunicorn()
-            self.add_tailwind()
+            self.add_entrypoints()
             self.add_pyproject_run()
             self.add_services()
 
@@ -230,11 +251,11 @@ def add_gunicorn(self):
 
         self.poncho.add_process("plain", runserver_cmd, env=self.plain_env)
 
-    def add_tailwind(self):
-        if not plainpackage_installed("tailwind"):
-            return
-
-        self.poncho.add_process("tailwind", "plain tailwind compile --watch")
+    def add_entrypoints(self):
+        for entry_point in entry_points().select(group=ENTRYPOINT_GROUP):
+            self.poncho.add_process(
+                f"plain dev entrypoint {entry_point.name}", env=self.plain_env
+            )
 
     def add_pyproject_run(self):
         if not has_pyproject_toml(APP_PATH.parent):

plain-dev/plain/dev/utils.py

@@ -1,14 +1,5 @@
-import importlib
 from pathlib import Path
 
 
-def plainpackage_installed(name: str) -> bool:
-    try:
-        importlib.import_module(f"plain.{name}")
-        return True
-    except ImportError:
-        return False
-
-
 def has_pyproject_toml(target_path):
     return (Path(target_path) / "pyproject.toml").exists()

plain-tailwind/plain/tailwind/entrypoints.py

@@ -0,0 +1,9 @@
+from .cli import compile
+
+
+def run_dev_compile():
+    compile(["--watch"])
+
+
+def run_compile():
+    compile([])

plain-tailwind/pyproject.toml

@@ -14,6 +14,12 @@ homepage = "https://plainframework.com"
 documentation = "https://plainframework.com/docs/"
 repository = "https://github.com/dropseed/plain"
 
+[tool.poetry.plugins."plain.dev"]
+"tailwind" = "plain.tailwind.entrypoints:run_dev_compile"
+
+[tool.poetry.plugins."plain.assets.compile"]
+"tailwind" = "plain.tailwind.entrypoints:run_compile"
+
 [tool.poetry.dependencies]
 python = "^3.11"
 plain = "<1.0.0"

plain/plain/cli/cli.py

@@ -5,6 +5,7 @@
 import subprocess
 import sys
 import traceback
+from importlib.metadata import entry_points
 from importlib.util import find_spec
 from pathlib import Path
 
@@ -286,17 +287,10 @@ def compile(keep_original, fingerprint, compress):
         )
         sys.exit(1)
 
-    # TODO make this an entrypoint instead
-    # Compile our Tailwind CSS (including templates in plain itself)
-    if find_spec("plain.tailwind") is not None:
-        click.secho("Compiling Tailwind CSS", bold=True)
-        result = subprocess.run(["plain", "tailwind", "compile", "--minify"])
+    for entry_point in entry_points(group="plain.assets.compile"):
+        click.secho(f"Running {entry_point.name}", bold=True)
+        result = entry_point.load()()
         print()
-        if result.returncode:
-            click.secho(
-                f"Error compiling Tailwind CSS (exit {result.returncode})", fg="red"
-            )
-            sys.exit(result.returncode)
 
     # TODO also look in [tool.plain.compile.run]