plain 0.48.0__tar.gz → 0.49.0__tar.gz

{plain-0.48.0 → plain-0.49.0}/.gitignore

@@ -6,8 +6,8 @@ __pycache__
 *.DS_Store
 .coverage
 
-# Personal workspace
-/*.code-workspace
+# Symlinks to personal packages
+/ext
 
 # Test apps
 plain*/tests/.plain

{plain-0.48.0 → plain-0.49.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.48.0
+Version: 0.49.0
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE

{plain-0.48.0 → plain-0.49.0}/plain/cli/README.md

@@ -30,6 +30,12 @@ Run a Python script in the context of your app.
 
 View the runtime value of a named setting.
 
+### `plain help`
+
+Print help for all available commands and subcommands.
+Each command's help output is prefixed with the full command name for
+readability.
+
 ### `plain shell`
 
 Open a Python shell with the Plain loaded.

{plain-0.48.0 → plain-0.49.0}/plain/cli/core.py

@@ -10,6 +10,7 @@ from .build import build
 from .chores import chores
 from .docs import docs
 from .formatting import PlainContext
+from .help import help_cmd
 from .preflight import preflight_checks
 from .registry import cli_registry
 from .scaffold import create
@@ -34,6 +35,7 @@ plain_cli.add_command(urls)
 plain_cli.add_command(setting)
 plain_cli.add_command(shell)
 plain_cli.add_command(run)
+plain_cli.add_command(help_cmd)
 
 
 class CLIRegistryGroup(click.Group):

plain-0.49.0/plain/cli/help.py

@@ -0,0 +1,27 @@
+import click
+from click.core import MultiCommand
+
+
+@click.command("help")
+@click.pass_context
+def help_cmd(ctx):
+    """Show help for all commands and subcommands."""
+
+    root = ctx.parent.command
+    info_name = ctx.parent.info_name or "plain"
+
+    def print_help(cmd, prog, parent=None):
+        sub_ctx = click.Context(cmd, info_name=prog, parent=parent)
+
+        title = sub_ctx.command_path
+        click.secho(title, fg="green", bold=True)
+        click.secho("-" * len(title), fg="green")
+        click.echo(sub_ctx.get_help())
+
+        if isinstance(cmd, MultiCommand):
+            for name in cmd.list_commands(sub_ctx):
+                click.echo()
+                sub_cmd = cmd.get_command(sub_ctx, name)
+                print_help(sub_cmd, name, sub_ctx)
+
+    print_help(root, info_name)

{plain-0.48.0 → plain-0.49.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain"
-version = "0.48.0"
+version = "0.49.0"
 description = "A web framework for building products with Python."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"

{plain-0.48.0 → plain-0.49.0}/tests/test_cli.py

@@ -15,3 +15,11 @@ def test_plain_cli_build():
     result = runner.invoke(cli, ["build"], prog_name="plain")
     assert result.exit_code == 0
     assert "Compiled 0 assets into 0 files" in result.output
+
+
+def test_plain_help_command():
+    runner = CliRunner()
+    result = runner.invoke(cli, ["help"], prog_name="plain")
+    assert result.exit_code == 0
+    assert "Usage: plain build" in result.output
+    assert "Usage: plain shell" in result.output