feat(cli): add post-build argument

Author: e-roux

README.rst

@@ -67,6 +67,7 @@ which can seen by running ``sphinx-autobuild --help``:
      --delay DELAY         how long to wait before opening the browser
      --watch DIR           additional directories to watch
      --pre-build COMMAND   additional command(s) to run prior to building the documentation
+     --post-build COMMAND  additional command(s) to run after building the documentation (default: [])
 
 Using with Makefile
 -------------------
@@ -126,6 +127,14 @@ all pages are built from the same state of the HTML theme.
 It also works around a `known issue in Sphinx <relevant sphinx bugs_>`__
 which causes significant problems during theme development.
 
+Post-build resources can be processed by passing a user-defined command to
+``--post-build``.
+
+.. code-block:: bash
+   
+   --post-build "npx tailwindcss -i ./src/input.css -o ./src/output.css"
+
+
 Working on multiple projects
 ----------------------------
 

sphinx_autobuild/__main__.py

@@ -49,11 +49,12 @@ def main(argv=()):
     url_host = f"{host_name}:{port_num}"
 
     pre_build_commands = list(map(shlex.split, args.pre_build))
-
+    post_build_commands = list(map(shlex.split, args.post_build))
     builder = Builder(
         build_args,
         url_host=url_host,
         pre_build_commands=pre_build_commands,
+        post_build_commands=post_build_commands,
     )
 
     watch_dirs = [src_dir] + args.additional_watched_dirs
@@ -233,6 +234,13 @@ def _add_autobuild_arguments(parser):
         default=[],
         help="additional command(s) to run prior to building the documentation",
     )
+    group.add_argument(
+        "--post-build",
+        action="append",
+        metavar="COMMAND",
+        default=[],
+        help="additional command(s) to run after building the documentation",
+    )
     return group
 
 

sphinx_autobuild/build.py

@@ -15,9 +15,10 @@
 
 
 class Builder:
-    def __init__(self, sphinx_args, *, url_host, pre_build_commands):
+    def __init__(self, sphinx_args, *, url_host, pre_build_commands, post_build_commands):
         self.sphinx_args = sphinx_args
         self.pre_build_commands = pre_build_commands
+        self.post_build_commands = post_build_commands
         self.uri = f"http://{url_host}"
 
     def __call__(self, *, changed_paths: Sequence[Path]):
@@ -70,5 +71,20 @@ def __call__(self, *, changed_paths: Sequence[Path]):
                 "Please fix the cause of the error above or press Ctrl+C to stop the "
                 "server."
             )
+        else:
+            # Run the post-build commands only if the build was successful
+            try:
+                for command in self.post_build_commands:
+                    show_message("post-build")
+                    show_command(command)
+                    subprocess.run(command, check=True)
+            except subprocess.CalledProcessError as e:
+                print(f"Post-build command exited with exit code: {e.returncode}")
+                print(
+                    "Please fix the cause of the error above or press Ctrl+C to stop"
+                    " the server."
+                )
+                raise
+
         # Remind the user of the server URL for convenience.
         show_message(f"Serving on {self.uri}")