vfox 2026.5.9

Interface to vfox plugins
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

--- Installs bpkg by copying bash scripts to bin directory
--- @param ctx table Context provided by vfox
function PLUGIN:PostInstall(ctx)
    local cmd = require("cmd")

    local sdkInfo = ctx.sdkInfo["bpkg"]
    local path = sdkInfo.path
    local version = sdkInfo.version

    -- The tarball may extract to bpkg-{version}/ or directly to path
    -- Check which case we have
    local srcDir = path .. "/bpkg-" .. version
    local file = io.open(srcDir .. "/bpkg.sh", "r")
    if file then
        file:close()
    else
        -- Files are directly in path
        srcDir = path
    end

    -- Create bin directory
    cmd.exec("mkdir -p '" .. path .. "/bin'")

    -- bpkg uses symlinks to lib/ directory, so we need to:
    -- 1. Copy the lib directory
    -- 2. Copy the main bpkg.sh script
    -- 3. Copy the symlinks (they point to lib/)

    -- Copy lib directory
    cmd.exec("cp -r '" .. srcDir .. "/lib' '" .. path .. "/bin/'")

    -- Copy main script
    cmd.exec("cp -f '" .. srcDir .. "/bpkg.sh' '" .. path .. "/bin/'")

    -- Copy all symlinks (they'll still point to lib/ which we copied)
    local scripts = {
        "bpkg",
        "bpkg-env",
        "bpkg-getdeps",
        "bpkg-init",
        "bpkg-install",
        "bpkg-json",
        "bpkg-list",
        "bpkg-package",
        "bpkg-run",
        "bpkg-show",
        "bpkg-source",
        "bpkg-suggest",
        "bpkg-term",
        "bpkg-update",
        "bpkg-utils",
        "bpkg-realpath",
    }

    for _, script in ipairs(scripts) do
        local src = srcDir .. "/" .. script
        local dst = path .. "/bin/" .. script
        -- Copy symlink as symlink (-P preserves symlinks)
        cmd.exec("cp -P '" .. src .. "' '" .. dst .. "' 2>/dev/null || true")
    end

    -- Make all scripts executable
    cmd.exec("chmod +x '" .. path .. "/bin/bpkg.sh'")
    cmd.exec("find '" .. path .. "/bin/lib' -name '*.sh' -exec chmod +x {} \\;")

    -- Verify main bpkg script was installed
    local file = io.open(path .. "/bin/bpkg.sh", "r")
    if file then
        file:close()
    else
        error("Failed to install bpkg - main script not found at " .. path .. "/bin/bpkg.sh")
    end
end