Add a feature that installs dependencies from an Aptfile.dev file

src/apt/NOTES.md

@@ -0,0 +1,5 @@
+# OS Support
+
+This feature supports recent versions of Debian and Ubuntu distributions with the `apt` package manager. It works with any base image using these distributions, like `ubuntu:focal` or `debian:buster`.
+
+`bash` is required to execute the `install.sh` script.

src/apt/README.md

@@ -0,0 +1,42 @@
+# Aptfile Dependencies (apt)
+
+Install apt dependencies defined in an `Aptfile.dev` file. This feature is inspired by the approach found in [heroku-buildpack-apt](https://github.com/heroku/heroku-buildpack-apt) and [Aptfile Buildpack on App Platform](https://docs.digitalocean.com/products/app-platform/reference/buildpacks/aptfile/). It simplifies the process of managing and installing apt packages required for a development environment by specifying them in one file.
+
+## Example Usage
+
+```json
+"features": {
+  "ghcr.io/viktorianer/features/apt:1": {
+    "devFile": "../Aptfile.dev"
+  }
+}
+```
+
+## Options
+
+| Options Id | Description | Type   | Default Value |
+|------------|-------------|--------|---------------|
+| devFile    | Path to the Aptfile.dev file. This is where the list of apt packages is defined. | string | `../Aptfile.dev` |
+
+## How It Works
+
+- The feature reads the list of packages from the `Aptfile.dev` file and installs them during the container setup.
+- The default path is `Aptfile.dev`, but this can be customized using the `devFile` option.
+- It removes any commented or empty lines before installing the packages with `apt-get install`.
+
+Example `Aptfile.dev`:
+
+```bash
+# Video thumbnails
+ffmpeg
+libvips
+
+# PDF thumbnails
+poppler-utils
+# mupdf
+# mupdf-tools
+
+# PostgreSQL
+libpq-dev
+postgresql-client
+```

src/apt/devcontainer-feature.json

@@ -0,0 +1,16 @@
+{
+  "id": "apt",
+  "version": "1.0.0",
+  "name": "Aptfile Dependencies",
+  "description": "Installs apt dependencies defined in an Aptfile.dev file.",
+  "options": {
+    "devFile": {
+      "type": "string",
+      "description": "Optional custom Aptfile.dev path",
+      "default": "../Aptfile.dev"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils"
+  ]
+}

src/apt/install.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+set -e
+
+# Exit script if any command fails
+set -o errexit
+
+# Debugging (optional, comment out if not needed)
+# set -x
+
+# Use the DEVFILE environment variable to find the Aptfile.dev
+if [ -f "$DEVFILE" ]; then
+  echo "Aptfile.dev detected at $DEVFILE. Installing dependencies..."
+
+  apt-get update -y
+  grep -Ev "^\s*#" "$DEVFILE" | xargs apt-get install --no-install-recommends -y
+  rm -rf /var/lib/apt/lists/*
+
+  echo "Dependencies from $DEVFILE have been installed."
+else
+  echo "No Aptfile.dev found at $DEVFILE, skipping apt dependencies installation."
+fi

test/apt/install_ffmpeg.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+set -e
+
+# Optional: Import test library
+source dev-container-features-test-lib
+
+# Definition specific tests
+check "ffmpeg" ffmpeg -version
+
+# Report result
+reportResults

test/apt/install_ffmpeg/Aptfile.dev

@@ -0,0 +1 @@
+ffmpeg

test/apt/install_ffmpeg/Dockerfile

@@ -0,0 +1,5 @@
+# Builds an image with a preconfigured SUDOERS file
+# Used to test the install script for JupyterLab which modifies this file
+FROM mcr.microsoft.com/devcontainers/base:debian
+
+COPY --chown=vscode Aptfile.dev /tmp/dev-container-features/apt_0/Aptfile.dev

test/apt/scenarios.json

@@ -0,0 +1,14 @@
+{
+  "install_ffmpeg": {
+    "build": {
+      "dockerfile": "Dockerfile"
+    },
+    "remoteUser": "vscode",
+    "features": {
+      "apt": {
+        "version": "1",
+        "devFile": "Aptfile.dev"
+      }
+    }
+  }
+}

test/apt/test.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+set -e