feat: support install erlang/otp from Bob prebuilt release in ubuntu linux (#8), close #7 [no ci]

* feat: support install erlang/otp from Bob prebuilt release

* feat: vfox search prebuilt version

* chore: test prebuilt release install

* fix: env keys

* refactor: impl for prebuilt release

* fix: prebuilt release bin search

* fix: vofx search prebuilt version

* feat: download prebuilt version ca

* ci: fix prebuilt test

Author: yeshan333

.github/workflows/e2e_test_linux_prebuilt.yaml

@@ -0,0 +1,48 @@
+name: E2E tests on Linux (Prebuilt release)
+
+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-20.04]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: install vfox (Linux)
+        run: |
+          echo "deb [trusted=yes] https://apt.fury.io/versionfox/ /" | sudo tee /etc/apt/sources.list.d/versionfox.list
+          sudo apt-get update
+          sudo apt-get install vfox
+
+      - name: add vfox-erlang plugin (Unix-like) 
+        run: |
+          vfox add --source https://github.com/version-fox/vfox-erlang/archive/${GITHUB_REF}.zip erlang
+      
+      - name: prepare Erlang/OTP deps (Linux)
+        run: |
+          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: install Erlang/OTP by vfox-erlang plugin (Linux)
+        run: |
+          export MAKEFLAGS=-j4
+          export USE_PREBUILT_OTP="ubuntu-20.04"
+          vfox install erlang@maint-27
+          vfox use -g erlang@maint-27
+          eval "$(vfox activate bash)"
+          echo "===============PATH==============="
+          echo $PATH
+          echo "===============PATH==============="
+          cd assets
+          erlc hello.erl
+          erl -noshell -s hello hello_world -s init stop

DEVELOPMENT.md

@@ -0,0 +1,7 @@
+# Developer Guide
+
+## How vfox-erlang plugin work
+
+- download & compile Erlang/OTP from GitHub Release: https://github.com/erlang/otp/releases
+- download prebuilt Erlang/OTP from hexpm/bob: https://github.com/hexpm/bob?tab=readme-ov-file#erlang-builds
+

README.md

@@ -82,3 +82,18 @@ Invoke-Expression "$(vfox activate pwsh)"
 ```
 
 You can reference the E2E test in in windows-2022: [.github/workflows/e2e_test_windows.yaml](.github/workflows/e2e_test_windows.yaml)
+
+## install a prebuilt Erlang/OTP version
+
+After vfox-erlang v1.1.0, you can also install a prebuilt Erlang/OTP version in Ubuntu linux system. 
+
+**Before install, you must disable vfox search cache.** Reference: [https://vfox.lhan.me/guides/configuration.html#cache-settings](https://vfox.lhan.me/guides/configuration.html#cache-settings)
+
+This is an installation example in Bash Shell:
+
+```shell
+# install an available version, you can also a avaliable version in: https://bobs-list.kobrakai.de/
+USE_PREBUILT_OTP="ubuntu-20.04" vfox search erlang
+```
+
+**USE_PREBUILT_OTP** var value is one of: ["ubuntu-14.04", "ubuntu-16.04", "ubuntu-18.04", "ubuntu-20.04", "ubuntu-22.04", "ubuntu-24.04"].

assets/erlang_otp_versions_from_gtihub_api.json

@@ -49,6 +49,16 @@
         },
         "node_id": "MDM6UmVmMzc0OTI3OnJlZnMvdGFncy9SMTZCMDJfeWllbGRpbmdfYmluYXJ5X3RvX3Rlcm0="
     },
+    {
+        "name": "OTP-27.2.1",
+        "zipball_url": "https://api.github.com/repos/erlang/otp/zipball/refs/tags/OTP-27.2.1",
+        "tarball_url": "https://api.github.com/repos/erlang/otp/tarball/refs/tags/OTP-27.2.1",
+        "commit": {
+            "sha": "4726e39654c7a7412f7c2f66c7eb567c978a9947",
+            "url": "https://api.github.com/repos/erlang/otp/commits/4726e39654c7a7412f7c2f66c7eb567c978a9947"
+        },
+        "node_id": "MDM6UmVmMzc0OTI3OnJlZnMvdGFncy9PVFAtMjcuMi4x"
+    },
     {
         "name": "OTP-27.2",
         "zipball_url": "https://api.github.com/repos/erlang/otp/zipball/refs/tags/OTP-27.2",

assets/get_all_otp_versions.py

@@ -18,6 +18,21 @@ def update_all_version_from_github_api():
     with open("erlang_otp_versions_from_gtihub_api.json", 'w', encoding="utf-8") as file:
         json.dump(all_version, file, indent=4)
 
+def get_all_prebuilt_version_from_bob():
+    # ALLOW_OS_RELEASE = ["ubuntu-14.04", "ubuntu-16.04", "ubuntu-18.04", "ubuntu-20.04", "ubuntu-22.04", "ubuntu-24.04"]
+    ALLOW_OS_RELEASE = ["ubuntu-20.04"]
+    all_version_info = []
+    for release in ALLOW_OS_RELEASE:
+        url = f"https://builds.hex.pm/builds/otp/{release}/builds.txt"
+        response = requests.get(url)
+        all_version_info = response.text.split("\n")
+    
+    all_prebuilt_versions = []
+    for version in all_version_info:
+        if version.split(" ")[0]:
+            all_prebuilt_versions.append(version.split(" ")[0])
+    return all_prebuilt_versions
+
 def get_all_version():
     version_set = set()
     with open("erlang_otp_versions_from_gtihub_api.json", 'r', encoding="utf-8") as file:
@@ -33,7 +48,12 @@ def get_all_version():
     update_all_version_from_github_api()
     versions = list(get_all_version())
     versions.sort(reverse=True)
-    print(versions)
+    # print(versions)
     with open("versions.txt", 'w') as file:
         for version in versions:
+            file.write(version + '\n')
+    with open("prebuilt_versions.txt", 'w') as file:
+        prebuilt_versions = get_all_prebuilt_version_from_bob()
+        prebuilt_versions.sort(reverse=True)
+        for version in prebuilt_versions:
             file.write(version + '\n')