feat: basic devcontainer setup for local builds

run as a non-root user

Author: thekaveman

.devcontainer/Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.11
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    USER=compiler
+
+RUN apt-get update
+RUN apt-get install -y ruby-full && gem install bundler
+RUN python -m pip install --upgrade pip
+
+RUN useradd --create-home --shell /bin/bash $USER && \
+    chown -R $USER /home/$USER
+
+WORKDIR /home/$USER/site
+
+COPY Gemfile Gemfile
+COPY Gemfile.lock Gemfile.lock
+RUN bundle install
+
+USER $USER
+ENV PATH "$PATH:/home/$USER/.local/bin"
+
+COPY .devcontainer/requirements.txt .devcontainer/requirements.txt
+RUN pip install --no-cache-dir -r .devcontainer/requirements.txt

.devcontainer/compose.yml

@@ -0,0 +1,8 @@
+services:
+  site:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    command: sleep infinity
+    volumes:
+      - ..:/home/compiler/site

.devcontainer/devcontainer.json

@@ -0,0 +1,27 @@
+{
+  "name": "compiler/datadonuts.la",
+  "dockerComposeFile": "compose.yml",
+  "service": "site",
+  "workspaceFolder": "/home/compiler/site",
+  "postAttachCommand": ["/bin/bash", ".devcontainer/postAttach.sh"],
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash",
+        "terminal.integrated.profiles.linux": {
+          "bash": {
+            "path": "/bin/bash"
+          }
+        }
+      },
+      "extensions": [
+        "eamodio.gitlens",
+        "esbenp.prettier-vscode",
+        "mhutchie.git-graph",
+        "redhat.vscode-xml",
+        "sissel.shopify-liquid",
+        "tamasfe.even-better-toml"
+      ]
+    }
+  }
+}

.devcontainer/postAttach.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -eu
+
+git config --global --add safe.directory /home/compiler/site
+
+# initialize hook environments
+pre-commit install --install-hooks --overwrite
+
+# manage commit-msg hooks
+pre-commit install --hook-type commit-msg

.devcontainer/requirements.txt

@@ -0,0 +1 @@
+pre-commit

.gitignore

@@ -2,4 +2,4 @@
 .jekyll-metadata
 .idea/
 _site/
-.DS_Store
+.DS_Store

.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+ci:
+  autofix_commit_msg: "chore(pre-commit): autofix run"
+  autoupdate_commit_msg: "chore(pre-commit): autoupdate hooks"
+
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+
+repos:
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: mixed-line-ending
+      - id: end-of-file-fixer
+      - id: requirements-txt-fixer
+      - id: check-yaml
+        args: ["--unsafe"]
+      - id: check-added-large-files

.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "files.encoding": "utf8",
+  "files.eol": "\n",
+  "files.insertFinalNewline": true,
+  "files.trimFinalNewlines": true,
+  "files.trimTrailingWhitespace": true,
+  "editor.tabSize": 2,
+  "files.associations": {
+    "*.html": "liquid"
+  },
+  "[liquid]": {
+    "editor.defaultFormatter": "sissel.shopify-liquid"
+  }
+}

.vscode/tasks.json

@@ -0,0 +1,24 @@
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Jekyll: Build Dev",
+      "type": "shell",
+      "command": ["bundle", "exec", "jekyll serve --force_polling --livereload"],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared",
+        "showReuseMessage": true,
+        "clear": false
+      }
+    }
+  ]
+}