모듈:GameJSONParser

모듈 설명문서[보기] [편집] [역사] [새로 고침]

아래 설명 내용은 모듈:GameJSONParser/설명문서에서 가져와서 보여주고 있습니다. (편집 | 역사)

getGameInfo

이 부분의 본문은 틀:게임 정보입니다.

getGamecard

이 부분의 본문은 틀:게임카드입니다.

getFeaturedCard

이 부분의 본문은 틀:추천평카드입니다.

도보시오

• 리버티게임:게임 메타데이터/스키마.json : 메타데이터 스키마
• 모듈:GameJSONParser/연구소

local p = {}
local table = require('table')
-- 테이블 유틸리티 함수
t = {
    -- js의 find
    find = function(tb, func)
        for _, value in ipairs(tb) do
            if func(value) then
                return value
            end
        end
        return nil
    end,
    -- js의 map
    map = function(tb, func)
        local newTable = {}
        for i, value in ipairs(tb) do
            newTable[i] = func(value)
        end
        return newTable
    end,
    -- js의 필터
    filter = function(tb, func)
        local newTable = {}
        for _, value in ipairs(tb) do
            if func(value) then
                table.insert(newTable, value)
            end
        end
        return newTable
    end,
    --t.walk(gameMeta, {"rating","libertygame","age"})를 호출 시 
    --gameMeta.rating.libertygame.age로 들어가다가 도중에 들어갈 수 없는 구조를 만나면 nil 반환하는 함수
    walk = function(tbl, keys)
        local value = tbl
        for i, key in ipairs(keys) do
            value = value[key]
            if value == nil or type(value) == 'number' or type(value) == 'string' then
                return value
            end
        end
        return value
    end,
}


-- 게임 메타데이터를 파싱하여 각 속성에 대해 적절한 포맷터를 사용하는 함수
function p._manualParser(scheme, propertyCases, gameMeta)
    local results = {}

    -- 각 속성 케이스를 순회합니다.
    for _, propertyCase in ipairs(propertyCases) do
        -- 현재 속성의 유효성을 확인합니다.
        local validatedGroup = propertyCase.validate(gameMeta,scheme)

        if validatedGroup ~= false and validatedGroup ~= nil then
            -- 배열이 아닌 경우 기본 배열로 변환 
            if type(validatedGroup) ~= 'table' then
                validatedGroup = {}
            end            
            
            -- 2단계 배열이 아닌 경우 한번 더 감싸기(하위 테이블에 "key"라는 키가 있을 때)
            if #validatedGroup ~= 0 and validatedGroup[1].key ~= nil then
                validatedGroup = {validatedGroup}
            end

            for _, validated in ipairs(validatedGroup) do
                local resultString = propertyCase.formatter
                for _, v in ipairs(validated) do
                    local key = v.key
                    local value = v.value
                    resultString = resultString:gsub("$" .. key, value)
                end
                table.insert(results, resultString)
            end
        end
    end

    return results
end

-- 첫번째 파라미터에 리버티게임:게임 메타데이터/스키마.json, 
-- 두번째 파라미터에 game.json 넣어서 게임 자동분류 사용 가능 
-- 아직 테스트되지 않음
function p.manualParse(frame)
    local scheme = mw.text.jsonDecode(frame.args[1])
    local gameMeta = mw.text.jsonDecode(frame.args[2])

    -- 속성 케이스 검사할 값, 발견시 반환할 값 정의
    local propertyCases = {
        {
            key = "platform",
            formatter = "[[분류:$title 게임]]",
            validate = function(gameMeta, scheme)
                local platform = t.walk(gameMeta, {"platform"})
                if platform == nil then return false end
                local platFormDef = t.walk(scheme, {"$defs", "platform", "oneOf"})
                local platFormData = t.find(platFormDef, function(p)
                    return p.const == platform
                end)
                if platFormData == nil then return false end
                return {{key = "title", value = platFormData.title}}
            end
        },
        {
            key = "abandon",
            formatter = "{{뱃지|버려진 게임}}",
            validate = function(gameMeta, scheme)
                return t.walk(gameMeta, {"abandon"}) or false
            end
        },
        {
            key = "construction",
            formatter = "{{뱃지|공사중|$value}}",
            validate = function(gameMeta, scheme)
                local construction = t.walk(gameMeta, {"construction"})
                if not construction then return false end
                if construction == true then return {{key = "value", value = ""}} end
                return {{key = "value", value = construction}}
            end
        },
        {
            key = "progress",
            formatter = "[[분류:$title]]",
            validate = function(gameMeta, scheme)
                local progress = t.walk(gameMeta, {"progress"})
                if progress == nil then return false end
                local progressDef = t.walk(scheme, {"properties", "progress", "oneOf"})
                local progressData = t.find(progressDef, function(p)
                    return p.const == progress
                end)
                if progressData == nil then return false end
                return {{key = "title", value = progressData.title}}
            end
        },
        {
            key = "rating",
            formatter = "[[분류:$title 게임]]",
            validate = function(gameMeta, scheme)
                local age = t.walk(gameMeta, {"rating", "libertygame", "age"})
                if age == nil then return false end
                local ageDef = t.walk(scheme, {"properties", "rating", "oneOf", 2, "properties", "libertygame", "properties", "age", "oneOf"})
                local ageData = t.find(ageDef, function(a)
                    return a.const == age
                end)
                if ageData == nil then return false end
                return {{key = "title", value = ageData.title}}
            end
        },
        {
            key = "repair",
            formatter = "{{뱃지|수리중}}",
            validate = function(gameMeta, scheme)
                local repair = t.walk(gameMeta, {"repair"})
                if not repair then return false end
                if repair == true then return {{key = "value", value = ""}} end
                return {{key = "value", value = repair}}
            end
        },
        {
            key = "genre",
            formatter = "[[분류:$title 게임]]",
            validate = function(gameMeta, scheme)
                local genres = t.walk(gameMeta, {"genre"})
                if genres == nil then return false end
                if type(genres) == "string" then genres = {genres} end
                local genreDef = t.walk(scheme, {"$defs", "genre", "oneOf"})
                local genreData = t.filter(t.map(genres, function(genre)
                    return t.find(genreDef, function(genreData)
                        return genreData.const == genre
                    end)
                end), function(genreData)
                    return genreData ~= nil
                end)
    
                return t.map(genreData, function(genreData)
                    return {key = "title", value = genreData.title}
                end)
            end
        }
    }

    local parsed = p._manualParser(scheme, propertyCases, gameMeta)
    --return mw.text.jsonEncode(parsed)
    return table.concat(parsed)
end