devcontainer.json

// For format details, see https://containers.dev/implementors/json_reference/
{
    "name": "Python 3 Developer Container",
    "build": {
        "dockerfile": "../Dockerfile",
        "target": "developer"
    },
    "containerEnv": {
        "OTEL_EXPORTER_OTLP_TRACES_PROTOCOL": "http/protobuf",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "http://127.0.0.1:4318",
    },
    "remoteEnv": {
        // Allow X11 apps to run inside the container
        "DISPLAY": "${localEnv:DISPLAY}",
    },
    "customizations": {
        "vscode": {
            // Set *default* container specific settings.json values on container create.
            "settings": {
                "python.defaultInterpreterPath": "/venv/bin/python"
            },
            // Add the IDs of extensions you want installed when the container is created.
            "extensions": [
                "ms-python.python",
                "github.vscode-github-actions",
                "tamasfe.even-better-toml",
                "redhat.vscode-yaml",
                "ryanluker.vscode-coverage-gutters",
                "charliermarsh.ruff",
                "ms-pyright.pyright",
                "ms-azuretools.vscode-docker",
                "ms-kubernetes-tools.vscode-kubernetes-tools"
            ]
        }
    },
    "mounts": [
        {
            "source": "${localEnv:HOME}/.cache/uv",
            "target": "/.cache/uv",
            "type": "bind"
        },
        {
            "target": "/workspaces/${localWorkspaceFolderBasename}/.venv",
            "type": "volume"
        }
    ],
    "features": {
        // add in eternal history and other bash features
        "ghcr.io/diamondlightsource/devcontainer-features/bash-config:1": {}
    },
    // Create the config folder for the bash-config feature
    "initializeCommand": "mkdir -p ${localEnv:HOME}/.config/bash-config ${localEnv:HOME}/.cache/uv",
    "runArgs": [
        // Allow the container to access the host X11 display and EPICS CA
        "--net=host",
        // Make sure SELinux does not disable with access to host filesystems like tmp
        "--security-opt=label=disable"
    ],
    // Mount the parent as /workspaces so we can pip install peers as editable
    "workspaceMount": "source=${localWorkspaceFolder}/..,target=/workspaces,type=bind",
    // After the container is created, install the python project in editable form
    "postCreateCommand": "uv sync --frozen && uvx pre-commit install && SHELL=bash uv tool update-shell"
}