add debugpy capability

Author: gilesknap

.vscode/launch.json

@@ -4,6 +4,21 @@
     // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
     "version": "0.2.0",
     "configurations": [
+        {
+            "name": "Python Debugger: Remote Attach",
+            "type": "debugpy",
+            "request": "attach",
+            "connect": {
+                "host": "localhost",
+                "port": 5678
+            },
+            "pathMappings": [
+                {
+                    "localRoot": "${workspaceFolder}",
+                    "remoteRoot": "/venv/lib/python3.13/site-packages/stdio_socket"
+                }
+            ]
+        },
         {
             "name": "Debug Unit Test",
             "type": "debugpy",

Dockerfile

@@ -5,6 +5,7 @@ FROM python:${PYTHON_VERSION} AS developer
 
 # Add any system dependencies for the developer/build environment here
 RUN apt-get update && apt-get install -y --no-install-recommends \
+    gdb \
     graphviz \
     && rm -rf /var/lib/apt/lists/*
 
@@ -22,7 +23,13 @@ RUN touch dev-requirements.txt && pip install -c dev-requirements.txt .[demo]
 
 # The runtime stage copies the built venv into a slim runtime container
 FROM python:${PYTHON_VERSION}-slim AS runtime
-# Add apt-get system dependecies for runtime here if needed
+
+# Add apt-get system dependecies for runtime
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gdb \
+    && rm -rf /var/lib/apt/lists/*
+
+
 COPY --from=build /venv/ /venv/
 ENV PATH=/venv/bin:$PATH
 

pyproject.toml

@@ -14,6 +14,7 @@ classifiers = [
 description = "An example simulation IOC for testing fastCS"
 dependencies = [
     "fastcs",
+    "debugpy",
 ] # Add project dependencies here, e.g. ["click", "numpy"]
 dynamic = ["version"]
 license.file = "LICENSE"