Модуль:Tr/loaddata

Материал из Terraria Wiki
Перейти к навигации Перейти к поиску
Lua.svg Документация Документация, указанная ниже, находится на странице «Модуль:Tr/loaddata/док». (править | история)
См. также этот модуль на английском языке: Module:Tr/loaddata. В нём может содержаться более полная или подробная информация.

Если кэшированные данные шаблона {{Tr}} нужно «пересоздать», очистите кэш Модуль:Tr/loaddata или вызовите {{#invoke:Tr|purge|lang=<языковой код>}} для тех случаев, когда нужно пересоздать данные для конкретного языка.


-- Note: 
-- It seems that objects/lists stored via luacache have a limit on the number of entities, which is about 8k.
-- Any object/list with more than 8k entities or with such a large sub-object/sub-list will be truncated.
-- Therefore, we encode the data into a string to get around this problem.

local cache = mw.ext.LuaCache

return {
	
	load = function(lang)
		local status, result = pcall(function ()
			return mw.text.jsonDecode(cache.get('tr__database-'..lang))
		end)
		if status then
			return result
		else
			-- fallback
			local info = require('Module:Tr/db-'..lang) -- return table of mw.loadData() has a metatable, can not be used for cache.set and mw.loadData.
			
			-- add on wiki language list
			info.onWikiLangList = {}
			local trim = mw.text.trim
			-- "ar, bg, cs, da, el, es" -> {"ar", " bg", " cs", " da", " el", " es"} -> {ar = true, bg = true, cs = true, da = true, el = true, es = true}
			for _,v in ipairs(mw.text.split(mw.getCurrentFrame():expandTemplate{ title = 'langList', args = {'onWiki'}}, ',')) do
				info.onWikiLangList[trim(v)] = true
			end
			
			-- reversed translation db
			reversed = {}
			-- for on-wikis: <English page>/<lang> => <English page> is handled by {{pagename2en}}, no need for db.
			for k,v in pairs(info.main or {}) do
				reversed[v] = k
			end
			-- `pagename` table overrides `main` table
			for k,v in pairs(info.pagename or {}) do
				reversed[v] = k
			end
			-- Manually specified entities have the highest priority
			for k,v in pairs(info.reversed or {}) do
				reversed[k] = v
			end
			info.reversed = reversed
			
			-- cache it. 
			-- This cache can be purged by:
			-- * purge Module:tr/db-<lang> or Module:tr/db-<lang>/doc page
			-- * lua code: require('Module:Tr/loaddata').purge(<lang>)
			-- * template code: {{#invoke:tr|purge|lang=<lang>}}
			cache.set( 'tr__database-'..lang, mw.text.jsonEncode(info))
			return info
		end
	end,
	
	purge = function(lang)
		cache.delete( 'tr__database-'..lang)
	end
}