Initial commit: vfox plugin for chezscheme

Author: jdx

.github/workflows/test.yaml

@@ -0,0 +1,29 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        # Windows requires .exe installer, not source compilation
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install mise
+        uses: jdx/mise-action@v2
+
+      - name: List available versions
+        run: mise ls-remote "vfox:${{ github.repository }}" | head -20
+
+      - name: Install and test chezscheme
+        run: |
+          mise install "vfox:${{ github.repository }}@10.0.0"
+          mise exec "vfox:${{ github.repository }}@10.0.0" -- scheme --version

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 mise-plugins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,49 @@
+# vfox-chezscheme
+
+[vfox](https://github.com/version-fox/vfox) plugin for [Chez Scheme](https://github.com/cisco/ChezScheme).
+
+Chez Scheme is both a programming language and an implementation of that language, with supporting tools and documentation.
+
+**Note:** This plugin compiles Chez Scheme from source. You will need a C compiler (gcc or clang) and make installed on your system.
+
+## Usage with mise
+
+```bash
+# Install a specific version (compiles from source)
+mise install chezscheme@10.0.0
+
+# Use in current shell
+mise use chezscheme@10.0.0
+
+# Run scheme
+scheme --version
+```
+
+## Usage with vfox
+
+```bash
+# Add the plugin
+vfox add chezscheme
+
+# Install a version (compiles from source)
+vfox install chezscheme@10.0.0
+
+# Use the version
+vfox use chezscheme@10.0.0
+```
+
+## Requirements
+
+- C compiler (gcc or clang)
+- make
+- Basic build tools
+
+On Ubuntu/Debian:
+```bash
+apt-get install build-essential
+```
+
+On macOS:
+```bash
+xcode-select --install
+```

hooks/available.lua

@@ -0,0 +1,41 @@
+local http = require("http")
+local json = require("json")
+
+--- Returns all available versions of Chez Scheme from GitHub tags.
+--- @param ctx table Context
+--- @return table Available versions
+function PLUGIN:Available(ctx)
+    local results = {}
+
+    -- Fetch releases from GitHub API (tags show up as releases)
+    local resp, err = http.get({
+        url = "https://api.github.com/repos/cisco/ChezScheme/tags?per_page=100"
+    })
+
+    if err ~= nil then
+        error("Failed to fetch versions: " .. err)
+    end
+
+    if resp.status_code ~= 200 then
+        error("Failed to fetch versions: HTTP " .. resp.status_code)
+    end
+
+    local tags = json.decode(resp.body)
+
+    for _, tag in ipairs(tags) do
+        local version = tag.name
+        -- Remove 'v' prefix if present
+        if version:sub(1, 1) == "v" then
+            version = version:sub(2)
+        end
+        -- Only include version-like tags (e.g., 10.3.0, 9.5.8)
+        if version:match("^%d+%.%d+") then
+            table.insert(results, {
+                version = version,
+                note = ""
+            })
+        end
+    end
+
+    return results
+end

hooks/env_keys.lua

@@ -0,0 +1,12 @@
+--- Returns environment variables to set for this tool.
+--- @param ctx table
+--- @field ctx.path string Installation path
+--- @return table Environment variables
+function PLUGIN:EnvKeys(ctx)
+    return {
+        {
+            key = "PATH",
+            value = ctx.path .. "/bin"
+        }
+    }
+end

hooks/post_install.lua

@@ -0,0 +1,49 @@
+--- Called after extraction to compile Chez Scheme from source.
+--- @param ctx table
+--- @field ctx.rootPath string Installation root path
+function PLUGIN:PostInstall(ctx)
+    local os_type = RUNTIME.osType
+
+    -- Windows uses the .exe installer, not source compilation
+    if os_type == "windows" then
+        print("Windows installation requires the ChezScheme.exe installer from GitHub releases")
+        print("Please download and run it manually from:")
+        print("https://github.com/cisco/ChezScheme/releases")
+        return
+    end
+
+    local root_path = ctx.rootPath
+
+    -- The tarball extracts with contents at root level (no top-level directory to strip)
+    -- We need to run configure and make install
+    print("Compiling Chez Scheme from source...")
+
+    -- Configure with install prefix
+    local configure_cmd = "cd " .. root_path .. " && ./configure --installprefix=" .. root_path
+    print("Running: " .. configure_cmd)
+    local result = os.execute(configure_cmd)
+    if result ~= 0 and result ~= true then
+        error("Configure failed")
+    end
+
+    -- Build
+    local make_cmd = "cd " .. root_path .. " && make"
+    print("Running: make")
+    result = os.execute(make_cmd)
+    if result ~= 0 and result ~= true then
+        error("Make failed")
+    end
+
+    -- Install to the prefix directory
+    local install_cmd = "cd " .. root_path .. " && make install"
+    print("Running: make install")
+    result = os.execute(install_cmd)
+    if result ~= 0 and result ~= true then
+        error("Make install failed")
+    end
+
+    -- Clean up build artifacts to save space (optional)
+    os.execute("cd " .. root_path .. " && rm -rf boot c examples mats s unicode workarea Makefile configure LOG NOTICE 2>/dev/null")
+
+    print("Chez Scheme compilation complete!")
+end

hooks/pre_install.lua

@@ -0,0 +1,16 @@
+--- Called before installation to return the download URL.
+--- Chez Scheme only provides source tarballs, which need to be compiled.
+--- @param ctx table
+--- @field ctx.version string Version to install
+--- @return table File info with URL
+function PLUGIN:PreInstall(ctx)
+    local version = ctx.version
+
+    -- Source tarball URL pattern: csv{version}.tar.gz
+    local url = "https://github.com/cisco/ChezScheme/releases/download/v" .. version .. "/csv" .. version .. ".tar.gz"
+
+    return {
+        url = url,
+        version = version
+    }
+end

metadata.lua

@@ -0,0 +1,9 @@
+PLUGIN = {}
+
+PLUGIN.name = "chezscheme"
+PLUGIN.version = "0.1.0"
+PLUGIN.homepage = "https://github.com/mise-plugins/vfox-chezscheme"
+PLUGIN.license = "MIT"
+PLUGIN.description = "Chez Scheme - a programming language and implementation"
+PLUGIN.minRuntimeVersion = "0.3.0"
+PLUGIN.notes = { "Compiles from source - requires C compiler (gcc/clang) and make" }