container-superposition 0.1.1

package/overlays/python/devcontainer.patch.json

@@ -0,0 +1,41 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "features": {
+        "./features/cross-distro-packages": {
+            "apt": "build-essential python3-dev",
+            "apk": "build-base python3-dev"
+        },
+        "ghcr.io/devcontainers/features/python:1": {
+            "version": "3.12",
+            "installTools": true
+        }
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-python.python",
+                "ms-python.vscode-pylance",
+                "ms-python.black-formatter",
+                "charliermarsh.ruff"
+            ],
+            "settings": {
+                "[python]": {
+                    "editor.defaultFormatter": "ms-python.black-formatter",
+                    "editor.formatOnSave": true,
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": "explicit"
+                    }
+                },
+                "python.defaultInterpreterPath": "/usr/local/bin/python",
+                "files.exclude": {
+                    "**/__pycache__": true,
+                    "**/.pytest_cache": true
+                }
+            }
+        }
+    },
+    "remoteEnv": {
+        "PATH": "${containerEnv:HOME}/.local/bin:${containerEnv:PATH}",
+        "PYTHONPATH": "${containerWorkspaceFolder}"
+    }
+}

package/overlays/python/overlay.yml

@@ -0,0 +1,12 @@
+id: python
+name: Python
+description: Python 3.12 with linting and formatting
+category: language
+supports: []
+requires: []
+suggests: []
+conflicts: []
+tags:
+    - language
+    - python
+ports: []

package/overlays/python/requirements-overlay.txt

@@ -0,0 +1,13 @@
+# Python overlay default packages
+# Customize this file to add or remove packages for your project
+
+# Core development tools (already installed, listed for reference)
+# pip
+# setuptools
+# wheel
+
+# Add your project dependencies here
+# Example:
+# requests>=2.31.0
+# pytest>=7.4.0
+# black>=23.0.0

package/overlays/python/setup.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Python setup script - Install Python packages
+
+set -e
+
+# Extract overlay name from script filename (setup-<overlay>.sh -> <overlay>)
+OVERLAY_NAME=$(basename "$0" | sed 's/setup-//;s/\.sh$//')
+
+echo "🐍 Setting up Python environment..."
+
+# Install overlay-specific packages (if requirements-overlay.txt exists)
+if [ -f ".devcontainer/requirements-overlay-${OVERLAY_NAME}.txt" ]; then
+    echo "📦 Installing overlay packages from requirements-overlay-${OVERLAY_NAME}.txt..."
+    pip install --user -r .devcontainer/requirements-overlay-${OVERLAY_NAME}.txt
+    echo "✓ Overlay packages installed"
+fi
+
+# Check if requirements.txt exists (project dependencies)
+if [ -f "requirements.txt" ]; then
+    echo "📦 Found requirements.txt, installing dependencies..."
+    pip install --user -r requirements.txt
+    echo "✓ Dependencies installed from requirements.txt"
+elif [ -f "requirements-dev.txt" ]; then
+    echo "📦 Found requirements-dev.txt, installing dev dependencies..."
+    pip install --user -r requirements-dev.txt
+    echo "✓ Dev dependencies installed from requirements-dev.txt"
+fi
+
+# Check if pyproject.toml exists (modern Python projects)
+if [ -f "pyproject.toml" ]; then
+    echo "📦 Found pyproject.toml, installing project..."
+    pip install --user -e .
+    echo "✓ Project installed in editable mode"
+fi
+
+# Check if setup.py exists (legacy Python projects)
+if [ -f "setup.py" ] && [ ! -f "pyproject.toml" ]; then
+    echo "📦 Found setup.py, installing project..."
+    pip install --user -e .
+    echo "✓ Project installed in editable mode"
+fi
+
+# Upgrade pip, setuptools, and wheel
+echo "⬆️  Upgrading pip, setuptools, and wheel..."
+pip install --user --upgrade pip setuptools wheel
+
+echo "✓ Python setup complete"

package/overlays/python/verify.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# Verification script for Python overlay
+# Confirms Python and pip are installed
+
+set -e
+
+echo "🔍 Verifying Python overlay..."
+echo ""
+
+# Check python is installed
+echo "1️⃣ Checking Python..."
+if command -v python3 &> /dev/null; then
+    python3 --version
+    echo "   ✅ Python found"
+else
+    echo "   ❌ Python not found"
+    exit 1
+fi
+
+# Check pip is installed
+echo ""
+echo "2️⃣ Checking pip..."
+if command -v pip3 &> /dev/null; then
+    pip3 --version
+    echo "   ✅ pip found"
+else
+    echo "   ❌ pip not found"
+    exit 1
+fi
+
+echo ""
+echo "✅ Python overlay verification complete"

package/overlays/rabbitmq/.env.example

@@ -0,0 +1,7 @@
+# RabbitMQ Configuration
+RABBITMQ_VERSION=3-management
+RABBITMQ_USER=guest
+RABBITMQ_PASSWORD=guest
+RABBITMQ_VHOST=/
+RABBITMQ_PORT=5672
+RABBITMQ_MANAGEMENT_PORT=15672