Module:Sandbox/Aurelain/Cargo

Documentation for this module may be created at Module:Sandbox/Aurelain/Cargo/doc

local p = {}
local FACTION_ORDER = {
    human = 1, 
    undead = 2, 
    nature = 3,
    demon = 4, 
    unfrozen = 5, 
    dungeon = 6, 
    neutral = 7,
}
local TRANSLATIONS_PATCH = {
    unit = {
        en = 'Unit',
    },
    faction = {
        en = 'Faction',
    },
    tier = {
        en = 'Tier',
    }
}

--------------------------------------------------------------------------------
-- Detects the current language from the URL
--------------------------------------------------------------------------------
local function getCurrentLang()
    local title = mw.title.getCurrentTitle()
    if title.isSubpage then
        if mw.language.isSupportedLanguage(title.subpageText) then
            return title.subpageText
        end
    end
    return 'en'
end

--------------------------------------------------------------------------------
-- Retrieves the data from Cargo
--------------------------------------------------------------------------------
local function query(lang)
    local tables = 'Unit, Translation'
    local fields = '' .. 
               'Unit.id=id, ' ..
               'Unit.faction=faction, ' ..
               'Unit.tier=tier, ' ..
               'Unit.hp=hp, ' ..
               'Unit.offence=attack, ' ..
               'Unit.base_sid=base, ' ..
               'Unit.upgrade_sid=upgrade, ' ..
               'Translation.language=language, ' ..
               'Translation.name=transName'
    
    -- Get BOTH the English row AND the target language row
    local cargoArgs = {
        join = 'Unit.id = Translation.target_id',
        where = 'Translation.language = "en" OR Translation.language = "' .. lang .. '"',
        orderBy = 'Unit.id ASC',
        limit = 1000 -- Increased limit since each unit will return 2 rows
    }
    
    return mw.ext.cargo.query(tables, fields, cargoArgs)
end

--------------------------------------------------------------------------------
-- Scans the Cargo results and folds the EN and lang rows into a single row
--------------------------------------------------------------------------------
local function consolidateResults(results, lang)
    local units = {}
    for _, row in ipairs(results) do
        local id = row['id']
        
        -- If this is the first time seeing this id, set up its basic stats
        if not units[id] then
        	local base = (row['base'] and row['base'] ~= "") and 1 or 0
        	local upgrade = (row['upgrade'] and row['upgrade'] ~= "") and 1 or 0
            units[id] = {
            	faction=row['faction'],
            	tier=row['tier'],
                hp = row['hp'],
                attack = row['attack'],
                nameEn = nil,
                nameX = nil,
                upgradeRank = base + upgrade
            }
        end
        
        -- Save the names based on which language row we are currently looping over
        if row['language'] == 'en' then
            units[id].nameEn = row['transName']
        end
        if row['language'] == lang then
            units[id].nameX = row['transName']
        end
    end
    
    -- Convert the Dictionary into an Array
    local unitsArray = {}
    for _, unitData in pairs(units) do
        table.insert(unitsArray, unitData)
    end
    
    return unitsArray
end

--------------------------------------------------------------------------------
-- Decides the order between two units, for sorting purposes.
--------------------------------------------------------------------------------
local function sortUnits(unitA, unitB)
    local rankA = FACTION_ORDER[unitA.faction] or 99
    local rankB = FACTION_ORDER[unitB.faction] or 99
    
    if rankA ~= rankB then
        return rankA < rankB
    end
    
    if unitA.tier ~= unitB.tier then
        return unitA.tier < unitB.tier
    end
    
    return unitA.upgradeRank < unitB.upgradeRank
end

--------------------------------------------------------------------------------
-- Main public function
--------------------------------------------------------------------------------
function p.displayOverview()
    local lang = getCurrentLang()
    local results = query(lang)
    local units = consolidateResults(results, lang)
    table.sort(units, sortUnits)

    -- Table
    local htmlTable = mw.html.create('table')
    htmlTable:addClass('wikitable sortable')
        
    -- Header
    local header = htmlTable:tag('tr')
    header:tag('th'):wikitext('Unit Name'):done()
    header:tag('th'):wikitext('Health'):done()
    header:tag('th'):wikitext('Attack'):done()

    -- Body
    for _, u in ipairs(units) do
        local page = u.nameEn .. (lang ~= 'en' and '/' .. lang or '')
        local tr = htmlTable:tag('tr')
        tr:tag('td'):wikitext('[[' .. page .. '|' .. u.nameX .. ']]'):done() 
        tr:tag('td'):wikitext(tostring(u.hp)):done()
        tr:tag('td'):wikitext(tostring(u.attack)):done()
    end

    return tostring(htmlTable)
end

return p