Add elixir-project Feature

Author: jgarber623-cargosense

src/elixir-project/README.md

@@ -0,0 +1,17 @@
+# elixir-project
+
+An opinionated, batteries-included Dev Container Feature for Elixir projects.
+
+## Usage
+
+```json
+"features": {
+  "ghcr.io/CargoSense/devcontainer-features/elixir-project:1": {}
+}
+```
+
+## OS Support
+
+This Feature should work on recent versions of Debian/Ubuntu and Linux distributions.
+
+`bash` is required to execute the `install.sh` script.

src/elixir-project/devcontainer-feature.json

@@ -0,0 +1,57 @@
+{
+  "id": "elixir-project",
+  "version": "1.0.0",
+  "name": "elixir-project",
+  "description": "An opinionated, batteries-included Dev Container Feature for Elixir projects.",
+  "documentationURL": "https://github.com/CargoSense/devcontainer-features/tree/main/src/elixir-project",
+  "licenseURL": "https://github.com/CargoSense/devcontainer-features/blob/main/LICENSE",
+  "containerEnv": {
+    "LESS": "-FMR",
+    "PAGER": "less"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ExpertLSP.expert"
+      ],
+      "settings": {
+        "[elixir]": {
+          "editor.formatOnSave": true
+        },
+        "editor.tabSize": 2,
+        "files": {
+          "insertFinalNewline": true,
+          "trimFinalNewlines": true,
+          "trimTrailingWhitespace": true
+        }
+      }
+    }
+  },
+  "dependsOn": {
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "installZsh": false,
+      "username": "vscode",
+      "userUid": 1000,
+      "userGid": 1000
+    }
+  },
+  "mounts": [
+    {
+      "source": "build-cache-${devcontainerId}",
+      "target": "${containerWorkspaceFolder}/_build",
+      "type": "volume"
+    },
+    {
+      "source": "dependency-cache-${devcontainerId}",
+      "target": "${containerWorkspaceFolder}/deps",
+      "type": "volume"
+    },
+    {
+      "source": "expert-cache-${devcontainerId}",
+      "target": "${containerWorkspaceFolder}/.expert",
+      "type": "volume"
+    }
+  ],
+  "onCreateCommand": "CONTAINER_WORKSPACE_FOLDER=${containerWorkspaceFolder} /opt/cargosense/elixir-project/onCreateCommand.sh",
+  "postCreateCommand": "sudo /opt/cargosense/elixir-project/postCreateCommand.sh"
+}

src/elixir-project/install.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+set -e
+
+FEATURE_SCRIPTS_PATH="/opt/cargosense/elixir-project"
+
+mkdir -p "${FEATURE_SCRIPTS_PATH}"
+
+cp "${PWD}"/scripts/*.sh "${FEATURE_SCRIPTS_PATH}"
+chmod +x "${FEATURE_SCRIPTS_PATH}"/*.sh

src/elixir-project/scripts/onCreateCommand.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+set -e
+
+# Set permissions on volume mounts
+sudo chown -R "${USER}":"${USER}" "${CONTAINER_WORKSPACE_FOLDER:?}"/{_build,deps,.expert}
+
+# Create user Bash configuration directory
+BASHRC_DIR="${HOME}/.bashrc.d"
+
+mkdir -p "${BASHRC_DIR}"
+chmod 700 "${BASHRC_DIR}"
+
+# Configure environment variables that rely on `CONTAINER_WORKSPACE_FOLDER`
+cat << EOF > "${BASHRC_DIR}/elixir-project.bashrc"
+export HISTFILE="${CONTAINER_WORKSPACE_FOLDER}/.bash_history"
+export ERL_AFLAGS="-kernel shell_history enabled -kernel shell_history_path '\\"${CONTAINER_WORKSPACE_FOLDER}/.iex_history\\"'"
+EOF
+
+chmod +x "${BASHRC_DIR}/elixir-project.bashrc"
+
+BASHRC_FILE="${HOME}/.bashrc"
+BASHRC_LINE="for file in \"\${HOME}\"/.bashrc.d/*.bashrc; do source \"\${file}\"; done"
+
+grep -qxF "${BASHRC_LINE}" "${BASHRC_FILE}" || echo "${BASHRC_LINE}" >> "${BASHRC_FILE}"
+
+# Configure workspace `.gitignore`
+GITIGNORE_FILE="${CONTAINER_WORKSPACE_FOLDER}/.gitignore"
+GITIGNORE_LINES=(.bash_history /_build /.expert /.iex_history /deps)
+
+touch "${GITIGNORE_FILE}"
+
+for line in "${GITIGNORE_LINES[@]}"; do
+  grep -qxF "${line}" "${GITIGNORE_FILE}" || echo "${line}" >> "${GITIGNORE_FILE}"
+done

src/elixir-project/scripts/postCreateCommand.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+set -e
+
+FEATURE_SCRIPTS_PATH="/opt/cargosense/elixir-project"
+
+rm -rf "${FEATURE_SCRIPTS_PATH}"
+rmdir --ignore-fail-on-non-empty "$(dirname "${FEATURE_SCRIPTS_PATH}")"