Module:DataFetch

Documentation for this module may be created at Module:DataFetch/doc

-- Written with ❤️ by fshark

local NOT_APPLICABLE = "N/A"

local title = mw.title.new("Module:DataFetch/data.json")
local data = title and title.exists and mw.text.jsonDecode(title:getContent())

assert(data, "Data failed to load. Please check \"Module:DataFetch/data.json\" exists.")

local abbreviations = {
    -- biomes
    wood = "w",
    stone = "s",
    earth = "e",
    arctic = "a",
    -- crops
    empty = "e",
    potato = "p",
    grain = "g",
    maize = "m",
    sheep = "s",
    goat = "b",
    cow = "c",
}

-- for example: if the biome argument is the name of the biome rather than its letter, return the corresponding letter
local function getAbbreviation(biomeName)
    return abbreviations[string.lower(biomeName)] or biomeName
end

-- returns first argument that is not an empty string
local function getValidArg(...)
    for i = 1, select("#", ...) do
        local arg = select(i, ...)
        if arg and arg ~= "" then
            return string.lower(arg)
        end
    end
    -- if no args; should not happen unless Template:BuildingData has not been updated yet.
    return ""
end

local function valueFind(t, ...)
    for i = 1, select("#", ...) do
        local k = select(i, ...)
        local v = t[k]
        if type(v) == "table" then
            return valueFind(v, ...)
        end
        if v ~= nil then
            return v
        end
    end
    return NOT_APPLICABLE
end

return {
    -- Universal getter for any property, for use with Template:BuildingData
    GetBuildingData = function(f)
        local args = f.args
        local section = getValidArg(args.section)
        local name = getValidArg(args.name)

        local source
        if section ~= "" then
            source = data[section]
        else
            source = data["buildings"] or data
        end

        if not source then
            return NOT_APPLICABLE
        end

        local buildingData = source[name]

        if not buildingData then
            return NOT_APPLICABLE
        end

        local targetData = getValidArg(args.data)
        local biome = getAbbreviation(getValidArg(args.biome))
        local resource = getValidArg(args.resource, args.res)
        local crop = getAbbreviation(getValidArg(args.crop))

        return valueFind(buildingData, targetData, resource, biome, crop)
    end
}