v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Module:Versions

From Dwarf Fortress Wiki
Jump to navigation Jump to search

Version/namespace helpers.

For use in templates, see module:versions/parserFunctions


local env = {}

local namespaces = {
	{
		-- namespace is the canonical namespace name (not an alias), e.g. the list at Special:AllPages
		namespace = '23a',
		-- versions are sorted in ascending order 
		versions = {'0.21', '0.22', '0.23'},
	},
	{
		namespace = '40d',
		versions = {'0.27', '0.28'},
	},
	{
		namespace = 'v0.31',
		versions = {'0.31'},
		aliases = {'DF2010'},
	},
	{
		namespace = 'v0.34',
		versions = {'0.34'},
		aliases = {'DF2012'},
	},
	{
		namespace = 'DF2014',
		versions = {'0.40', '0.42', '0.43', '0.44', '0.47'},
	},
	{
		namespace = 'Main',
		versions = {'50'},
		aliases = {'cv', ''},
	},
	-- mods: use the canonical name for the namespace index too, because they aren't sequenced
	Masterwork = {
		namespace = 'Masterwork',
		versions = {},
	},
}
local namespace_to_data = {}
local version_to_namespace = {}
local alias_to_namespace = {}
for i, data in pairs(namespaces) do
	if tonumber(i) ~= nil then
		data.index = i
	end
	data.canonical_version = data.versions[#data.versions]
	namespace_to_data[data.namespace] = data
	namespace_to_data[string.lower(data.namespace)] = data
	if not data.category_prefix then
		data.category_prefix = data.namespace
	end
	for _, version in pairs(data.versions or {}) do
		version_to_namespace[version] = data.namespace
	end
	for _, alias in pairs(data.aliases or {}) do
		alias_to_namespace[alias] = data.namespace
		alias_to_namespace[string.lower(alias)] = data.namespace
	end
end

function env.normalizeNamespace(ns, default)
	ns = string.lower(ns)
	ns = alias_to_namespace[ns] or ns
	ns = string.lower(ns)
	if namespace_to_data[ns] then
		return namespace_to_data[ns].namespace
	elseif default then
		return default
	else
		error('Unknown namespace: ' .. ns)
	end
end

function env.isNamespaceKnown(ns)
	if namespace_to_data[env.normalizeNamespace(ns, '')] then
		return true
	end
end

function env.isNamespaceVersioned(ns)
	if env.getIndexForNamespace(ns, '') ~= '' then
		return true
	end
end

function env.versionToNamespace(version, default)
	local parts = mw.text.split(version:gsub('^v', ''), '.', true)
	local key = ''
	while #parts > 0 do
		if key ~= '' then
			key = key .. '.'
		end
		key = key .. table.remove(parts, 1)
		if version_to_namespace[key] then
			return version_to_namespace[key]
		end
	end
	if default then
		return default
	end
	error('Unknown version: ' .. version)
end

function env.getNamespaceByIndex(i, default)
	local data = namespaces[tonumber(i)]
	if data then
		return data.namespace
	elseif default then
		return default
	else
		error('Unknown namespace index: ' .. tostring(i))
	end
end

function env.getIndexForNamespace(ns, default)
	local data = namespace_to_data[env.normalizeNamespace(ns, '')]
	if data then
		return data.index
	elseif default then
		return default
	else
		error('Unknown namespace: ' .. tostring(ns))
	end
end

function env.getIndexForVersion(v, default)
	return env.getIndexForNamespace(env.versionToNamespace(v, default), default)
end

function env.getIndexFor(key, default)
	local res = env.getIndexForNamespace(key, '')
	if res ~= '' then
		return res
	end
	return env.getIndexForVersion(key, default)
end

return env