fix: raise min required copier version to 3.6.0 (#623)

* fix: raise min required copier version to 3.6.0

* refactor: fix failing tests; add verbose mode for doctor command

* chore: addressing pr comments

Author: aorumbayev

.vscode/launch.json

@@ -10,8 +10,21 @@
       "cwd": "${workspaceFolder}",
       "request": "launch",
       "module": "debug",
-      "justMyCode": true,
+      "justMyCode": false,
       "console": "integratedTerminal"
+    },
+    {
+      "name": "Python: Debug Pytest",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "purpose": ["debug-test"],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src",
+        "PYTEST_ADDOPTS": "--no-cov"
+      }
     }
   ]
 }

docs/features/doctor.md

@@ -8,6 +8,8 @@ The AlgoKit Doctor allows you to make sure that your system has the correct depe
 
 Please run this command to if you are facing an issue running AlgoKit. It is recommended to run it before [submitting an issue to AlgoKit](https://github.com/algorandfoundation/algokit-cli/issues/new). You can copy the contents of the Doctor command message (in Markdown format) to your clipboard by providing the `-c` flag to the command as follows `algokit doctor -c`.
 
+> NOTE: You can also use the `--verbose` or `-v` flag to show additional information including package dependencies of the AlgoKit CLI: `algokit -v doctor`. This only works when `algokit` is installed as a Python package (e.g., via `pipx install algokit`).
+
 # Examples
 
 For example, running `algokit doctor` with all prerequisites installed will result in output similar to the following:
@@ -37,11 +39,13 @@ Please include this output, if you want to populate this message in your clipboa
 The doctor command will indicate if there is any issues to address, for example:
 
 If AlgoKit detects a newer version, this will be indicated next to the AlgoKit version
+
 ```
 AlgoKit: 1.2.3 (latest: 4.5.6)
 ```
 
 If the detected version of docker compose is unsupported, this will be shown:
+
 ```
 docker compose: 2.1.3
   Docker Compose 2.5.0 required to run `algokit localnet command`;

poetry.lock

@@ -10,7 +10,7 @@ readme = "README.md"
 python = ">=3.10,<3.14"
 click = "^8.1.3"
 httpx = "^0.23.1"
-copier = "^9.2.0"
+copier = "^9.6.0"
 questionary = "^1.10.0"
 pyclip = "^0.7.0"
 shellingham = "^1.5.4"

pyproject.toml

@@ -9,10 +9,12 @@
 from algokit.core.conf import get_current_package_version
 from algokit.core.config_commands.version_prompt import get_latest_github_version
 from algokit.core.doctor import DoctorResult, check_dependency
+from algokit.core.log_handlers import CONSOLE_LOG_HANDLER_NAME
 from algokit.core.sandbox import (
     COMPOSE_VERSION_COMMAND,
     get_min_compose_version,
 )
+from algokit.core.utils import is_binary_mode
 from algokit.core.utils import is_windows as get_is_windows
 
 logger = logging.getLogger(__name__)
@@ -35,13 +37,20 @@
     is_flag=True,
     default=False,
 )
-def doctor_command(*, copy_to_clipboard: bool) -> None:
+def doctor_command(*, copy_to_clipboard: bool) -> None:  # noqa: C901, PLR0912
     """Diagnose potential environment issues that may affect AlgoKit.
 
     Will search the system for AlgoKit dependencies and show their versions, as well as identifying any
     potential issues."""
     from algokit.core.config_commands.container_engine import get_container_engine
 
+    # Check if we're in verbose mode by examining the console log handler level
+    verbose = False
+    for handler in logging.getLogger().handlers:
+        if handler.name == CONSOLE_LOG_HANDLER_NAME and handler.level <= logging.DEBUG:
+            verbose = True
+            break
+
     os_type = platform.system()
     is_windows = get_is_windows()
     container_engine = get_container_engine()
@@ -119,6 +128,15 @@ def doctor_command(*, copy_to_clipboard: bool) -> None:
             msg += f"\n  {ln}"
         logger.info(msg)
 
+    # Get dependencies info if in verbose mode and not running from a binary
+    dependencies = {}
+    if verbose and not is_binary_mode():
+        # Add package dependencies section
+        logger.info("\nCLI package dependencies:")
+        dependencies = _get_production_dependencies()
+        for package, version in dependencies.items():
+            logger.info(f"{package}: {version}")
+
     # print end message anyway
     logger.info(
         "\n"
@@ -128,12 +146,19 @@ def doctor_command(*, copy_to_clipboard: bool) -> None:
     )
 
     if copy_to_clipboard:
-        pyclip.copy(
-            "\n".join(
-                f"* {key}: " + "\n  ".join([value.output, *(value.extra_help or [])])
-                for key, value in service_outputs.items()
-            )
-        )
+        output_lines = []
+
+        # Add service outputs
+        for key, value in service_outputs.items():
+            output_lines.append(f"* {key}: " + "\n  ".join([value.output, *(value.extra_help or [])]))
+
+        # Add package dependencies if verbose
+        if verbose:
+            output_lines.append("\n* Package dependencies:")
+            for package, version in dependencies.items():
+                output_lines.append(f"  * {package}: {version}")
+
+        pyclip.copy("\n".join(output_lines))
 
     if any(not value.ok for value in service_outputs.values()):
         raise click.exceptions.Exit(code=1)
@@ -151,3 +176,28 @@ def _get_algokit_version_output() -> DoctorResult:
     else:
         output = click.style(current, fg=WARNING_COLOR) + f" (latest: {latest})"
     return DoctorResult(ok=True, output=output)
+
+
+def _get_production_dependencies() -> dict[str, str]:
+    """Gets versions of all direct production dependencies."""
+    try:
+        import importlib.metadata
+        import re
+
+        # Get package dependencies from metadata
+        dist = importlib.metadata.distribution("algokit")
+        requires = dist.requires or []
+
+        result = {}
+        for req in requires:
+            if match := re.match(r"^([A-Za-z0-9_\-\.]+)", req):
+                dep = match.group(1)
+                try:
+                    result[dep] = importlib.metadata.version(dep)
+                except importlib.metadata.PackageNotFoundError:
+                    result[dep] = "Not installed"
+
+        return result
+
+    except Exception:
+        return {"Error": "Could not retrieve dependencies"}

src/algokit/cli/doctor.py

@@ -357,6 +357,9 @@ def init_command(  # noqa: PLR0913, C901, PLR0915
     expected_answers_file = project_path / ".algokit" / ".copier-answers.yml"
     relative_answers_file = expected_answers_file.relative_to(project_path) if expected_answers_file.exists() else None
 
+    # Ensure target directory exists (`copier` >=9.6.0 not creating parent directories during copy automatically)
+    project_path.mkdir(parents=True, exist_ok=True)
+
     with Worker(
         src_path=template.url,
         dst_path=project_path,

src/algokit/cli/init.py

@@ -63,12 +63,13 @@ def typescript_test_dir(tmp_path_factory: pytest.TempPathFactory) -> Path:
     test_dir = tmp_path_factory.mktemp("ts_test", numbered=True)
 
     # Create package.json with required dependencies
+    # TODO: update to use latest versions once they are released out of beta
     package_json_content = """{
         "name": "algokit-test",
         "version": "1.0.0",
         "dependencies": {
-            "@algorandfoundation/puya-ts": "^1.0.0-beta.48",
-            "@algorandfoundation/algorand-typescript": "^1.0.0-beta.25"
+            "@algorandfoundation/puya-ts": "~1.0.0-beta.48 <1.0.0",
+            "@algorandfoundation/algorand-typescript": "~1.0.0-beta.25 <1.0.0"
         }
     }"""
 

tests/compile/test_typescript.py

@@ -39,6 +39,10 @@ def _mock_doctor_dependencies(mocker: MockerFixture) -> None:
     sys_module = mocker.patch("algokit.cli.doctor.sys")
     sys_module.version = "3.6.2"
     sys_module.prefix = "/home/me/.local/pipx/venvs/algokit"
+    # Mock enable binary mode to ignore outputting package information to
+    # simplify snapshot diffs - otherwise each new run may fail whenever main prod
+    # dependencies are updated
+    mocker.patch("algokit.cli.doctor.is_binary_mode").return_value = True
 
 
 @pytest.fixture(autouse=True)