feat: add new command "ap serve" and an empty faq.yml

Author: softwareentrepreneer

afterpython/faq.yml

@@ -0,0 +1,29 @@
+import subprocess
+
+import click
+from click.exceptions import Exit
+
+
+@click.command()
+@click.pass_context
+def serve(ctx):
+    """Serve the production build of the project website"""
+    from afterpython.utils import find_node_env, is_website_initialized
+
+    if not is_website_initialized():
+        click.echo(
+            "Website has not been initialized. Skipping serve.\n"
+            "Run 'ap update website' to initialize the website."
+        )
+        return
+
+    paths = ctx.obj["paths"]
+    node_env = find_node_env()
+    click.echo(
+        "Serving the production build of the project website (including myst's builds)..."
+    )
+    result = subprocess.run(
+        ["pnpm", "serve"], cwd=paths.website_path, env=node_env, check=False
+    )
+    if result.returncode != 0:
+        raise Exit(result.returncode)

src/afterpython/cli/commands/serve.py

@@ -25,6 +25,7 @@
 from afterpython.cli.commands.preview import preview
 from afterpython.cli.commands.release import release
 from afterpython.cli.commands.remove import remove
+from afterpython.cli.commands.serve import serve
 from afterpython.cli.commands.start import blog, doc, example, guide, start, tutorial
 from afterpython.cli.commands.sync import sync
 from afterpython.cli.commands.update import update
@@ -118,6 +119,7 @@ def afterpython_group(ctx):
 afterpython_group.add_command(example)
 afterpython_group.add_command(guide)
 afterpython_group.add_command(preview)
+afterpython_group.add_command(serve)
 afterpython_group.add_command(clean)
 afterpython_group.add_command(pre_commit)
 afterpython_group.add_command(pre_commit, name="pc")