Add CMake, LLVM, and sccache feature installers with configuration options

Author: chapterjason

src/cmake/devcontainer-feature.json

@@ -0,0 +1,14 @@
+{
+  "id": "cmake",
+  "version": "1.0.0",
+  "name": "cmake",
+  "description": "Installs CMake from Kitware's official GitHub release binaries (distro-agnostic), symlinking cmake/ctest/cpack/ccmake into /usr/local/bin. Supports x86_64 and aarch64.",
+  "documentationURL": "https://github.com/SoureCode/devcontainer-features/tree/master/src/cmake",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "latest",
+      "description": "CMake release to install. `latest` resolves to the most recent tag from Kitware/CMake GitHub releases. Otherwise a specific version like `3.30.5`."
+    }
+  }
+}

src/cmake/install.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# cmake feature installer.
+# https://cmake.org/
+set -e
+
+CMAKE_VERSION="${VERSION:-latest}"
+
+if ! command -v curl >/dev/null 2>&1 || ! command -v tar >/dev/null 2>&1; then
+  apt-get update
+  apt-get install -y --no-install-recommends curl ca-certificates tar
+  rm -rf /var/lib/apt/lists/*
+fi
+
+if [ "$CMAKE_VERSION" = "latest" ]; then
+  CMAKE_VERSION="$(curl -fsSL https://api.github.com/repos/Kitware/CMake/releases/latest \
+    | sed -n 's/^.*"tag_name": *"v\([^"]*\)".*$/\1/p')"
+fi
+
+ARCH="$(uname -m)"
+case "$ARCH" in
+  x86_64)  CM_ARCH=x86_64 ;;
+  aarch64) CM_ARCH=aarch64 ;;
+  *) echo "cmake feature: unsupported arch: $ARCH" >&2; exit 1 ;;
+esac
+
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+curl -fsSL -o "$TMPDIR/cmake.tar.gz" \
+  "https://github.com/Kitware/CMake/releases/download/v${CMAKE_VERSION}/cmake-${CMAKE_VERSION}-linux-${CM_ARCH}.tar.gz"
+tar -xzf "$TMPDIR/cmake.tar.gz" -C "$TMPDIR"
+
+INSTALL_DIR="/usr/local/cmake-${CMAKE_VERSION}"
+rm -rf "$INSTALL_DIR"
+mv "$TMPDIR/cmake-${CMAKE_VERSION}-linux-${CM_ARCH}" "$INSTALL_DIR"
+
+for bin in cmake ctest cpack ccmake; do
+  [ -x "$INSTALL_DIR/bin/$bin" ] || continue
+  ln -sf "$INSTALL_DIR/bin/$bin" "/usr/local/bin/$bin"
+done

src/llvm/devcontainer-feature.json

@@ -0,0 +1,23 @@
+{
+  "id": "llvm",
+  "version": "1.0.0",
+  "name": "llvm",
+  "description": "Installs LLVM / Clang on Debian / Ubuntu via the official apt.llvm.org repository. Major-version binaries (clang, clang++, lld, lldb, clangd, clang-format, clang-tidy, etc.) are symlinked into /usr/local/bin without the version suffix.",
+  "documentationURL": "https://github.com/SoureCode/devcontainer-features/tree/master/src/llvm",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "22",
+      "description": "LLVM major version to install. Passed directly to apt.llvm.org's llvm.sh."
+    },
+    "all": {
+      "type": "boolean",
+      "default": true,
+      "description": "Install the full LLVM toolchain (clang, lld, lldb, libc++, polly, compiler-rt, …). Disable to get the default minimal set."
+    }
+  },
+  "containerEnv": {
+    "CC": "/usr/local/bin/clang",
+    "CXX": "/usr/local/bin/clang++"
+  }
+}

src/llvm/install.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# llvm feature installer (uses apt.llvm.org's llvm.sh).
+# https://apt.llvm.org/
+set -e
+
+LLVM_VERSION="${VERSION:-22}"
+LLVM_ALL="${ALL:-true}"
+
+apt-get update
+apt-get install -y --no-install-recommends \
+  ca-certificates curl gnupg lsb-release software-properties-common wget
+rm -rf /var/lib/apt/lists/*
+
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+curl -fsSL -o "$TMPDIR/llvm.sh" https://apt.llvm.org/llvm.sh
+chmod +x "$TMPDIR/llvm.sh"
+
+EXTRA_ARGS=()
+if [ "$LLVM_ALL" = "true" ]; then
+  EXTRA_ARGS+=("all")
+fi
+
+"$TMPDIR/llvm.sh" "$LLVM_VERSION" "${EXTRA_ARGS[@]}"
+
+# Symlink versioned binaries to unsuffixed names so generic tooling finds them.
+for bin in \
+    clang clang++ clang-cpp \
+    clang-format clang-tidy clangd \
+    lld ld.lld lld-link \
+    lldb lldb-server \
+    llvm-config llvm-symbolizer llvm-ar llvm-nm llvm-objdump llvm-objcopy \
+    llvm-ranlib llvm-readelf llvm-strip llvm-cov llvm-profdata; do
+  if [ -x "/usr/bin/${bin}-${LLVM_VERSION}" ]; then
+    ln -sf "/usr/bin/${bin}-${LLVM_VERSION}" "/usr/local/bin/${bin}"
+  fi
+done

src/sccache/devcontainer-feature.json

@@ -0,0 +1,14 @@
+{
+  "id": "sccache",
+  "version": "1.0.0",
+  "name": "sccache",
+  "description": "Installs Mozilla sccache from GitHub release binaries into /usr/local/bin. Distro-agnostic (musl-linked). Supports x86_64 and aarch64. Pair with SCCACHE_DIR / SCCACHE_CACHE_SIZE env vars in devcontainer.json to persist the cache across rebuilds.",
+  "documentationURL": "https://github.com/SoureCode/devcontainer-features/tree/master/src/sccache",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "latest",
+      "description": "sccache release to install. `latest` resolves to the most recent tag from mozilla/sccache GitHub releases. Otherwise a specific version like `0.8.2`."
+    }
+  }
+}

src/sccache/install.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# sccache feature installer.
+# https://github.com/mozilla/sccache
+set -e
+
+SCCACHE_VERSION="${VERSION:-latest}"
+
+if ! command -v curl >/dev/null 2>&1 || ! command -v tar >/dev/null 2>&1; then
+  apt-get update
+  apt-get install -y --no-install-recommends curl ca-certificates tar
+  rm -rf /var/lib/apt/lists/*
+fi
+
+if [ "$SCCACHE_VERSION" = "latest" ]; then
+  SCCACHE_VERSION="$(curl -fsSL https://api.github.com/repos/mozilla/sccache/releases/latest \
+    | sed -n 's/^.*"tag_name": *"v\([^"]*\)".*$/\1/p')"
+fi
+
+ARCH="$(uname -m)"
+case "$ARCH" in
+  x86_64)  SC_ARCH=x86_64-unknown-linux-musl ;;
+  aarch64) SC_ARCH=aarch64-unknown-linux-musl ;;
+  *) echo "sccache feature: unsupported arch: $ARCH" >&2; exit 1 ;;
+esac
+
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+curl -fsSL -o "$TMPDIR/sccache.tar.gz" \
+  "https://github.com/mozilla/sccache/releases/download/v${SCCACHE_VERSION}/sccache-v${SCCACHE_VERSION}-${SC_ARCH}.tar.gz"
+tar -xzf "$TMPDIR/sccache.tar.gz" -C "$TMPDIR"
+
+install -m 0755 "$TMPDIR/sccache-v${SCCACHE_VERSION}-${SC_ARCH}/sccache" /usr/local/bin/sccache