Add E2E tests for mise users with vfox-erlang plugin

Co-authored-by: yeshan333 <39296814+yeshan333@users.noreply.github.com>

Author: Copilot

.github/workflows/e2e_test_darwin_mise.yaml

@@ -0,0 +1,40 @@
+name: E2E tests on Darwin MacOS (mise)
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    # Runs at 12am UTC
+    - cron: "0 0 * * *"
+
+jobs:
+  e2e_tests:
+    strategy:
+      matrix:
+        # ref: https://github.com/actions/runner-images
+        os: [macos-13]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: install mise
+        run: |
+          curl https://mise.run | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: install Erlang/OTP by mise with vfox-erlang plugin (Darwin)
+        if: runner.os == 'MacOS'
+        run: |
+          brew install --force autoconf libxslt fop wxwidgets openssl
+          export MAKEFLAGS=-j4
+          mise use -g vfox:version-fox/vfox-erlang@26.2.3
+          mise exec -- erl -version
+          echo "===============PATH==============="
+          echo $PATH
+          echo "===============PATH==============="
+          cd assets
+          mise exec -- erlc hello.erl
+          mise exec -- erl -noshell -s hello hello_world -s init stop
+          mise exec -- erl -eval 'erlang:display(shell_docs:get_doc(lists)), halt().' -noshell

.github/workflows/e2e_test_linux_mise.yaml

@@ -0,0 +1,56 @@
+name: E2E tests on Linux (mise)
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    # Runs at 12am UTC
+    - cron: '0 0 * * *'
+
+jobs:
+  e2e_tests:
+    strategy:
+      matrix:
+        # ref: https://github.com/actions/runner-images
+        os: [ubuntu-22.04, ubuntu-24.04]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: install mise
+        run: |
+          curl https://mise.run | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+      
+      - name: prepare Erlang/OTP deps (Linux)
+        if: matrix.os != 'ubuntu-24.04'
+        run: |
+          sudo apt update
+          sudo DEBIAN_FRONTEND=noninteractive apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk
+      
+      - name: prepare Erlang/OTP deps (Linux)
+        if: matrix.os == 'ubuntu-24.04'
+        run: |
+          sudo apt update
+          sudo DEBIAN_FRONTEND=noninteractive apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.2-dev libwxgtk-webview3.2-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk
+
+      - name: install Erlang/OTP by mise with vfox-erlang plugin (Linux)
+        run: |
+          export MAKEFLAGS=-j4
+          mise use -g vfox:version-fox/vfox-erlang@26.2.3
+          mise exec -- erl -version
+          echo "===============PATH==============="
+          echo $PATH
+          echo "===============PATH==============="
+          cd assets
+          mise exec -- erlc hello.erl
+          mise exec -- erl -noshell -s hello hello_world -s init stop
+          docs=$(mise exec -- erl -eval 'erlang:display(shell_docs:get_doc(lists)), halt().' -noshell | grep "List processing functions")
+          if [ -n "$docs" ]; then
+              echo "erlang built with docs chunk"
+          else
+              echo "erlang does not built with docs chunk"
+              exit 1
+          fi

README.md

@@ -2,7 +2,7 @@
 
 ![logo](./assets/vfox-erlang-logo.png)
 
-[![E2E tests on Linux](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml) [![E2E tests on Darwin MacOS](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml) [![E2E tests on Windows](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml) [![E2E tests on Darwin MacOS (Prebuilt release)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_prebuilt.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_prebuilt.yaml) [![E2E tests on Linux (Prebuilt release)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_prebuilt.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_prebuilt.yaml)
+[![E2E tests on Linux](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml) [![E2E tests on Darwin MacOS](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml) [![E2E tests on Windows](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml) [![E2E tests on Darwin MacOS (Prebuilt release)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_prebuilt.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_prebuilt.yaml) [![E2E tests on Linux (Prebuilt release)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_prebuilt.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_prebuilt.yaml) [![E2E tests on Linux (mise)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_mise.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux_mise.yaml) [![E2E tests on Darwin MacOS (mise)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_mise.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin_mise.yaml)
 
 </div>
 
@@ -114,3 +114,21 @@ USE_PREBUILT_OTP=true vfox install erlang@26.2.3
 **USE_PREBUILT_OTP** can be set to any non-empty value (e.g., "1", "true", "macos") to enable prebuilt mode.
 
 Supported architectures: amd64, x86_64, arm64, aarch64. macOS uses a dedicated prebuilt version list that differs from the Ubuntu prebuilt versions.
+
+## Usage with mise
+
+The vfox-erlang plugin can also be used through [mise](https://mise.jdx.dev/), a popular dev tools manager that supports vfox plugins as a backend.
+
+### Installation with mise
+
+```shell
+# Install and activate erlang through mise using vfox backend
+mise use -g vfox:version-fox/vfox-erlang@26.2.3
+
+# Use mise exec to run erlang commands
+mise exec -- erl -version
+mise exec -- erlc hello.erl
+mise exec -- erl -noshell -s hello hello_world -s init stop
+```
+
+For more information about mise and vfox backend support, see the [mise documentation](https://mise.jdx.dev/dev-tools/backends/vfox.html).