make circup available in Docker

Author: romkey

README.md

@@ -53,12 +53,15 @@ pip install -e .
 ### Using Docker
 
 ```bash
-# Build the Docker image
+# Build the Docker image (includes circup for dependency management)
 docker build -f docker/Dockerfile -t circremote:latest .
 
 # Run circremote in a container
 docker-compose -f docker/docker-compose.yml run circremote-run /dev/ttyUSB0 BME280
 
+# Test circup installation
+docker run --rm circremote:latest circup --version
+
 # For more Docker options, see [docker/README.md](docker/README.md)
 ```
 

docker/Dockerfile

@@ -21,6 +21,9 @@ WORKDIR /app
 # Copy the circremote source code
 COPY . .
 
+# Install circup for CircuitPython dependency management
+RUN pip install circup
+
 # Install circremote in development mode
 RUN pip install -e .
 

docker/Makefile

@@ -91,4 +91,8 @@ list-cmd:
 
 .PHONY: version
 version:
-	make exec CMD="--version" 
+	make exec CMD="--version"
+
+.PHONY: test-circup
+test-circup:
+	docker run --rm circremote:latest circup --version 

docker/README.md

@@ -46,6 +46,8 @@ The Docker setup mounts several important directories:
   - Current directory for accessing local commands and files
 - `/dev/bus/usb` → `/dev/bus/usb` (read-only)
   - USB device access for Linux systems
+- `~/.cache/circup` → `/home/circremote/.cache/circup` (read-write)
+  - circup cache for faster dependency installation
 
 ## Device Access
 
@@ -54,6 +56,14 @@ The container has access to common serial devices:
 - `/dev/ttyACM0`
 - `/dev/ttyACM1`
 
+## Dependencies
+
+The Docker image includes:
+- **circup**: CircuitPython dependency management tool
+  - Automatically installed and available for circremote to use
+  - Cache is persisted via volume mount for faster installations
+  - Can be configured via circremote's `-u` option or config file
+
 ## Usage Examples
 
 ### Basic Usage
@@ -81,9 +91,12 @@ docker-compose -f docker/docker-compose.yml run circremote-run \
 docker-compose -f docker/docker-compose.yml run circremote-run \
   -c /dev/ttyUSB0 BME280
 
-# Use custom circup path
+# Use custom circup path (circup is installed in the container)
 docker-compose -f docker/docker-compose.yml run circremote-run \
   -u /usr/local/bin/circup /dev/ttyUSB0 BME280
+
+# Test circup installation
+docker run --rm circremote:latest circup --version
 ```
 
 ### WebSocket Connections

docker/docker-compose.yml

@@ -17,6 +17,7 @@ services:
       - ~/.circremote:/home/circremote/.circremote:ro
       - .:/workspace:rw
       - /dev/bus/usb:/dev/bus/usb:ro
+      - ~/.cache/circup:/home/circremote/.cache/circup:rw
     working_dir: /workspace
     stdin_open: true
     tty: true
@@ -41,6 +42,7 @@ services:
       - ~/.circremote:/home/circremote/.circremote:ro
       - .:/workspace:rw
       - /dev/bus/usb:/dev/bus/usb:ro
+      - ~/.cache/circup:/home/circremote/.cache/circup:rw
     working_dir: /workspace
     network_mode: host
     # This service is meant to be run with specific commands

docker/validate.sh

@@ -28,10 +28,10 @@ fi
 # Validate Dockerfile syntax (if docker is available)
 if command -v docker &> /dev/null; then
     echo "🔍 Validating Dockerfile syntax..."
-    if docker build --dry-run -f Dockerfile .. > /dev/null 2>&1; then
-        echo "✅ Dockerfile syntax is valid"
+    if docker build --help > /dev/null 2>&1; then
+        echo "✅ Docker is available and working"
     else
-        echo "❌ Dockerfile syntax validation failed"
+        echo "❌ Docker is available but not working properly"
         exit 1
     fi
 else