feat: plugin update command

Author: makkus

pyproject.toml

@@ -204,8 +204,7 @@ default = "kiara:find_renderer_classes"
 
 [project.optional-dependencies]
 dev_utils = [
-    "kiara_plugin.core_types",
-    "kiara_plugin.develop",
+    "kiara_plugin.dev",
     "build",
     "ipython",
     "just-bin; sys_platform != 'win32'",

src/kiara/interfaces/cli/plugin/commands.py

@@ -3,6 +3,7 @@
 #
 #  Mozilla Public License, version 2.0 (see LICENSE or https://www.mozilla.org/en-US/MPL/2.0/)
 import os
+import sys
 from pathlib import Path
 from typing import Union
 
@@ -27,8 +28,21 @@ def plugin_group(ctx):
     required=False,
 )
 @click.option("--template", "-t", help="The template to use.", required=False)
+@click.option(
+    "--vcs-ref",
+    "-r",
+    help="The VCS ref to use, use 'HEAD' for latest dev template.",
+    required=False,
+    hidden=True,
+)
 @click.pass_context
-def create_plugin(ctx, name: str, path: Union[None, str], template: Union[None, str]):
+def create_plugin(
+    ctx,
+    name: str,
+    path: Union[None, str],
+    template: Union[None, str],
+    vcs_ref: Union[None, str] = None,
+):
     """Create a new kiara plugin."""
 
     import sys
@@ -67,6 +81,63 @@ def create_plugin(ctx, name: str, path: Union[None, str], template: Union[None,
 
     if not template:
         template = "gh:DHARPA-Project/kiara_plugin_template.git"
-    run_copy(template, full_path, data=data, unsafe=True)
+    run_copy(template, full_path, data=data, unsafe=True, vcs_ref=vcs_ref)
 
     terminal_print(f"Created new plugin '{name}' in: {full_path}")
+
+
+@plugin_group.command(name="update")
+@click.argument("path", nargs=1, required=False)
+@click.option(
+    "--template", "-t", help="The template to use.", required=False, hidden=True
+)
+@click.option(
+    "--vcs-ref",
+    "-r",
+    help="The VCS ref to use, use 'HEAD' for latest dev template.",
+    required=False,
+    hidden=True,
+)
+@click.pass_context
+def update_plugin(
+    ctx: click.Context,
+    path: Union[str, None],
+    template: Union[str, None],
+    vcs_ref: Union[str, None],
+):
+    """Update a kiara plugin."""
+
+    from copier import run_update
+
+    if not path:
+        _path = Path.cwd()
+    else:
+        _path = Path(path)
+
+    if not _path.exists():
+        terminal_print(f"Path '{path}' does not exist.")
+        sys.exit(1)
+
+    if not _path.is_dir():
+        terminal_print(f"Path '{path}' is not a directory.")
+        sys.exit(1)
+
+    copier_choice_file = _path / ".copier-answers.yml"
+    if not copier_choice_file.exists():
+        terminal_print(f"No .copier-answers.yml file found in '{path}'.")
+        sys.exit(1)
+
+    if not copier_choice_file.is_file():
+        terminal_print(f"Copier answers file '{path}' is not a file.")
+        sys.exit(1)
+
+    run_update(
+        src_path=template,
+        dst_path=_path,
+        vcs_ref=vcs_ref,
+        unsafe=True,
+        skip_answered=True,
+        overwrite=True,
+    )
+
+    terminal_print(f"Updating plugin in: {_path}")