devcontainer.json

{
  "name": "khs-python-example",
  "image": "mcr.microsoft.com/devcontainers/python:1-3.12-bookworm",

  // Install uv on container create, then sync deps. Subsequent rebuilds
  // are cached. The Airflow deps install fine here because the container
  // is Linux — no Windows caveat to worry about.
  "postCreateCommand": "curl -LsSf https://astral.sh/uv/install.sh | sh && /home/vscode/.local/bin/uv sync",

  // After dep install, source uv onto PATH for every new shell.
  "postStartCommand": "echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.bashrc",

  // Expose the FastAPI port to your host browser.
  "forwardPorts": [8000],

  "customizations": {
    "vscode": {
      "extensions": [
        "ms-python.python",
        "charliermarsh.ruff",
        "tamasfe.even-better-toml",
        "hashicorp.terraform"
      ],
      "settings": {
        "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
        "[python]": {
          "editor.defaultFormatter": "charliermarsh.ruff",
          "editor.formatOnSave": true,
          "editor.codeActionsOnSave": {
            "source.organizeImports": "explicit"
          }
        }
      }
    }
  },

  // Run as the non-root `vscode` user that the base image ships with.
  "remoteUser": "vscode"
}