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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

--- Utility functions for the clickhouse vfox plugin

local util = {}

--- Fetch content from a URL using curl
--- @param url string The URL to fetch
--- @return string|nil content The response body or nil on error
function util.fetch(url)
    local handle = io.popen(string.format('curl -sfL "%s"', url))
    if not handle then
        return nil
    end
    local content = handle:read("*a")
    handle:close()
    if content == "" then
        return nil
    end
    return content
end

--- Get all version tags from GitHub releases (only lts and stable)
--- @return table versions List of version strings
function util.get_versions()
    local versions = {}
    local url = "https://api.github.com/repos/ClickHouse/ClickHouse/releases?per_page=100"
    local content = util.fetch(url)
    if not content then
        return versions
    end

    -- Parse JSON to extract tag names (versions)
    for tag in content:gmatch('"tag_name"%s*:%s*"v([^"]+)"') do
        -- Only include lts and stable releases
        if tag:match("%-lts$") or tag:match("%-stable$") then
            table.insert(versions, tag)
        end
    end

    return versions
end

--- Compare version strings for sorting (descending - newest first)
--- @param a string First version
--- @param b string Second version
--- @return boolean true if a > b
function util.version_compare(a, b)
    local function parse_version(v)
        local parts = {}
        for num in v:gmatch("(%d+)") do
            table.insert(parts, tonumber(num))
        end
        return parts
    end

    local pa = parse_version(a)
    local pb = parse_version(b)

    for i = 1, math.max(#pa, #pb) do
        local na = pa[i] or 0
        local nb = pb[i] or 0
        if na ~= nb then
            return na > nb
        end
    end
    return false
end

--- Get architecture string
--- @return string arch Architecture (amd64 or arm64)
function util.get_arch()
    local handle = io.popen("uname -m")
    if not handle then
        return "amd64"
    end
    local arch = handle:read("*l")
    handle:close()

    if arch == "x86_64" or arch == "amd64" then
        return "amd64"
    elseif arch == "aarch64" or arch == "arm64" then
        return "arm64"
    end
    return "amd64"
end

--- Trim version suffix (remove -lts, -stable, -prestable)
--- @param version string The version string
--- @return string trimmed The trimmed version
function util.trim_version_suffix(version)
    local trimmed = version:gsub("%-lts$", "")
    trimmed = trimmed:gsub("%-stable$", "")
    trimmed = trimmed:gsub("%-prestable$", "")
    return trimmed
end

return util