add debug mode for start and stop

devservices/commands/start.py

@@ -1,9 +1,11 @@
 from __future__ import annotations
 
+import logging
 from argparse import _SubParsersAction
 from argparse import ArgumentParser
 from argparse import Namespace
 
+from devservices.constants import LOGGER_NAME
 from devservices.exceptions import DependencyError
 from devservices.exceptions import DockerComposeError
 from devservices.utils.console import Console
@@ -18,6 +20,12 @@ def add_parser(subparsers: _SubParsersAction[ArgumentParser]) -> None:
     parser.add_argument(
         "service_name", help="Name of the service to start", nargs="?", default=None
     )
+    parser.add_argument(
+        "--debug",
+        help="Enable debug mode",
+        action="store_true",
+        default=False,
+    )
     parser.set_defaults(func=start)
 
 
@@ -36,6 +44,10 @@ def start(args: Namespace) -> None:
     mode_to_start = "default"
     mode_dependencies = modes[mode_to_start]
 
+    if args.debug:
+        logger = logging.getLogger(LOGGER_NAME)
+        logger.setLevel(logging.DEBUG)
+
     with Status(
         lambda: console.warning(f"Starting {service.name}"),
         lambda: console.success(f"{service.name} started"),

devservices/commands/stop.py

@@ -1,9 +1,11 @@
 from __future__ import annotations
 
+import logging
 from argparse import _SubParsersAction
 from argparse import ArgumentParser
 from argparse import Namespace
 
+from devservices.constants import LOGGER_NAME
 from devservices.exceptions import DependencyError
 from devservices.exceptions import DockerComposeError
 from devservices.utils.console import Console
@@ -18,6 +20,12 @@ def add_parser(subparsers: _SubParsersAction[ArgumentParser]) -> None:
     parser.add_argument(
         "service_name", help="Name of the service to stop", nargs="?", default=None
     )
+    parser.add_argument(
+        "--debug",
+        help="Enable debug mode",
+        action="store_true",
+        default=False,
+    )
     parser.set_defaults(func=stop)
 
 
@@ -35,6 +43,11 @@ def stop(args: Namespace) -> None:
     # TODO: allow custom modes to be used
     mode_to_stop = "default"
     mode_dependencies = modes[mode_to_stop]
+
+    if args.debug:
+        logger = logging.getLogger(LOGGER_NAME)
+        logger.setLevel(logging.DEBUG)
+
     state = State()
     started_services = state.get_started_services()
     if service.name not in started_services:

devservices/constants.py

@@ -24,3 +24,4 @@
 DEVSERVICES_DOWNLOAD_URL = "https://github.com/getsentry/devservices/releases/download"
 BINARY_PERMISSIONS = 0o755
 MAX_LOG_LINES = "100"
+LOGGER_NAME = "devservices"

devservices/main.py

@@ -2,6 +2,7 @@
 
 import argparse
 import atexit
+import logging
 import os
 from importlib import metadata
 
@@ -27,6 +28,7 @@
 )
 
 disable_sentry = os.environ.get("DISABLE_SENTRY", default=False)
+logging.basicConfig(level=logging.INFO)
 
 if not disable_sentry:
     sentry_sdk.init(

devservices/utils/dependencies.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import logging
 import os
 import shutil
 import subprocess
@@ -18,6 +19,7 @@
 from devservices.constants import DEPENDENCY_GIT_PARTIAL_CLONE_CONFIG_OPTIONS
 from devservices.constants import DEVSERVICES_DEPENDENCIES_CACHE_DIR
 from devservices.constants import DEVSERVICES_DIR_NAME
+from devservices.constants import LOGGER_NAME
 from devservices.exceptions import ConfigNotFoundError
 from devservices.exceptions import ConfigParseError
 from devservices.exceptions import ConfigValidationError
@@ -436,4 +438,6 @@ def _has_remote_config(remote_config: RemoteConfig | None) -> TypeGuard[RemoteCo
 def _run_command(
     cmd: list[str], cwd: str, stdout: int | TextIO | None = subprocess.DEVNULL
 ) -> None:
+    logger = logging.getLogger(LOGGER_NAME)
+    logger.debug(f"Running command: {' '.join(cmd)}")
     subprocess.run(cmd, cwd=cwd, check=True, stdout=stdout, stderr=subprocess.DEVNULL)

devservices/utils/docker_compose.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import logging
 import os
 import platform
 import re
@@ -17,6 +18,7 @@
 from devservices.constants import DEVSERVICES_DIR_NAME
 from devservices.constants import DOCKER_COMPOSE_DOWNLOAD_URL
 from devservices.constants import DOCKER_USER_PLUGIN_DIR
+from devservices.constants import LOGGER_NAME
 from devservices.constants import MINIMUM_DOCKER_COMPOSE_VERSION
 from devservices.exceptions import BinaryInstallError
 from devservices.exceptions import DockerComposeError
@@ -272,6 +274,8 @@ def run_docker_compose_command(
     cmd_outputs = []
     for cmd in docker_compose_commands:
         try:
+            logger = logging.getLogger(LOGGER_NAME)
+            logger.debug(f"Running command: {' '.join(cmd)}")
             cmd_outputs.append(
                 subprocess.run(
                     cmd, check=True, capture_output=True, text=True, env=current_env