Module:TestModule: Difference between revisions

From Against the Storm Official Wiki
m (Testing)
m (Testing)
 
(12 intermediate revisions by the same user not shown)
Line 20: Line 20:


--region Private constants
--region Private constants
local VALID_SIZE = {
["none"] = true,
["small"] = true,
["medium"] = true,
["large"] = true,
["huge"] = true,
}
local VALID_PLURAL = {
["s"] = true,
["es"] = true,
}


--endregion
--endregion
Line 76: Line 89:
--- @return string wiki markup
--- @return string wiki markup
function BuildingLink.main(frame)
function BuildingLink.main(frame)
local frameargs = frame.args
framegetParentargs = frame:getParent().args
local ret = "frame.args = {<br>"
for k, v in pairs(frameargs) do
ret = ret .. "--[" .. k .. "] = " .. v .. ",<br>"
end
ret = ret .. "}<br>frame:getParent().args = {<br>"
for k, v in pairs(framegetParentargs) do
ret = ret .. "--[" .. k .. "] = " .. v .. ",<br>"
end
ret = ret .. "}<br>"


local name = frame.args.name
local name = frame.args.name
local iconSize = frame.args.size
local iconSize = frame.args.size
local needsPlural = frame.args.plural
local display = frame.args.display
local display = frame.args.display
local needsPlural
-- Initialize the array of unnamed parameters, up to 3, so several may be nil.
local parent = frame:getParent()
if parent then
local parameterStack = { parent.args[1], parent.args[2], parent.args[3], }
-- Then empty the stack and try to assign them as our variables.
for _, nextParameter in ipairs(parameterStack) do
ret = ret .. "nextParameter = " .. tostring(nextParameter) .. "<br>"
if nextParameter and nextParameter ~= "" then
-- Prioritize setting the name first.
if not name or name == "" then
name = nextParameter
ret = ret .. "now name = " .. name .. "<br>"
else
-- These could happen in either order, because their valid values are non-overlapping
ret = ret .. "checking VALID_SIZE[nextParameter] = " .. tostring(VALID_SIZE[nextParameter]) .. "<br>"
if (not iconSize or iconSize == "") and VALID_SIZE[nextParameter] then
iconSize = nextParameter
ret = ret .. "now iconSize = " .. iconSize .. "<br>"
else
ret = ret .. "checking VALID_PLURAL[nextParameter] = " .. tostring(VALID_PLURAL[nextParameter]) .. "<br>"
if not needsPlural and VALID_PLURAL[nextParameter] then
needsPlural = nextParameter
ret = ret .. "now needsPlural = " .. needsPlural .. "<br>"
end
end
end
end
end
end


---- If the iconSize was not specified, but plural was "s", then these will match. We need to unset the iconSize to be default.
-- Validate the name before we continue any further.
--if iconSize == needsPlural and (needsPlural == "s" or needsPlural == "es") then
validatedIcon = validateBuildingName(name)
-- iconSize = nil
 
--end
-- Handle default icon size.
--
if not iconSize or iconSize == "" or not VALID_SIZE[iconSize] then
---- It is valid by now; the above method already threw an error if not.
iconSize = "none"
--validatedIcon = validateBuildingName(name)
end
--
 
---- The only valid value for mustBePlural is "s," so then make on check to see if name ends in a way that we need to add "es" at the end instead of just "s". For names that end in "y", we swap out the last character for "ies" instead. (This will require one-time setup for redirect pages.)
-- The only valid value for mustBePlural is "s," so then make on check to see if name ends in a way that we need to add "es" at the end instead of just "s". For names that end in "y", we swap out the last character for "ies" instead. (This will require one-time setup for redirect pages.)
--if needsPlural == "s" or needsPlural == "es" then
if needsPlural == "s" or needsPlural == "es" then
-- if string.match(name, "y$") then
if string.match(name,"y$") then
-- name = string.sub(name, 1, -2) .. "ies"
name = string.sub(name,1,-2) .. "ies"
-- needsPlural = nil -- unset, since it's incorporated into the name
needsPlural = nil -- unset now, since it's incorporated into the name itself
-- else
else
-- local needsSyllable = string.match(name, "[sxz]$") or string.match(name, "sh$") or string.match(name, "ch$")
local needsSyllable = string.match(name,"[sxz]$") or string.match(name,"sh$") or string.match(name,"ch$")
-- needsPlural = needsSyllable and "es" or "s"
needsPlural = needsSyllable and "es" or "s"
-- end
end
--else
else
-- needsPlural = nil
needsPlural = nil
--end
end
--
--viewParameters = {
-- ["name"] = name,
-- ["plural"] = needsPlural,
-- ["iconfilename"] = validatedIcon,
-- ["iconsize"] = iconSize,
-- ["display"] = display,
--}


local frameargs = frame.args
viewParameters = {
framegetParentargs = frame:getParent().args
["name"] = name,
["plural"] = needsPlural,
["iconfilename"] = validatedIcon,
["iconsize"] = iconSize,
["display"] = display,
}


local ret = "frame.args = {\n\n" ..
ret = ret .. "<br>Finally...<br>name = " .. tostring(name) .. "<br>"
"--name = `" .. frameargs.name or "nil" .. "`\n\n" ..
ret = ret .. "iconSize = " .. tostring(iconSize) .. "<br>"
"--size = `" .. frameargs.size or "nil" .. "`\n\n" ..
ret = ret .. "needsPlural = " .. tostring(needsPlural) .. "<br>"
"--display `= " .. frameargs.display or "nil" .. "`\n\n" ..
"}\n\n" ..
"frame:getParent().args = {\n\n" ..
"__1 = `" .. framegetParentargs[1] or "nil" .. "`\n\n" ..
"--2 = `" .. framegetParentargs[2] or "nil" .. "`\n\n" ..
"--3 = `" .. framegetParentargs[3] or "nil" .. "`\n\n" ..
"}"


return ret
return ret
Line 131: Line 176:
-- args = viewParameters,
-- args = viewParameters,
--}
--}
end
end



Latest revision as of 02:08, 18 October 2024

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

--- @module BuildingLink
local BuildingLink = {}



--region Dependencies

-- This module lazily loads dependencies, since they're expensive but only one is needed, we just don't know which in advance.
local WorkshopsData
local InstitutionsData
local FarmsData
local CampsData
local CollectorsData

local VIEW_TEMPLATE = "Building_link/view"

--endregion



--region Private constants

local VALID_SIZE = {
	["none"] = true,
	["small"] = true,
	["medium"] = true,
	["large"] = true,
	["huge"] = true,
}

local VALID_PLURAL = {
	["s"] = true,
	["es"] = true,
}

--endregion



--region Private methods

local function tryData(name, buildingInterface)

	local buildingID = buildingInterface.getID(name)

	return buildingInterface.getIcon(buildingID)
end



local function validateBuildingName(name)

	-- Lazy-load of external data, since it's expensive. Start with the most likely so that most pages load as fast as possible.
	WorkshopsData = require("Module:WorkshopsData")
	local validatedIcon = tryData(name, WorkshopsData)
	if not validatedIcon then
		InstitutionsData = require("Module:InstitutionsData")
		validatedIcon = tryData(name, InstitutionsData)
		if not validatedIcon then
			FarmsData = require("Module:FarmsData")
			validatedIcon = tryData(name, FarmsData)
			if not validatedIcon then
				CollectorsData = require("Module:CollectorsData")
				validatedIcon = tryData(name, CollectorsData)
				if not validatedIcon then
					CampsData = require("Module:CampsData")
					validatedIcon = tryData(name, CampsData)
					if not validatedIcon then
						error("No building found with name: " .. name .. ". Please see the template documentation for how to use the parameters")
					end
				end
			end
		end
	end

	return validatedIcon
end

--endregion



--region Public methods

---main
--- Extracts parameters, validates the building by getting its icon, and then sends the data to the view template for rendering.
---
--- @param frame table the template's context, with arguments
--- @return string wiki markup
function BuildingLink.main(frame)

local frameargs = frame.args
framegetParentargs = frame:getParent().args
local ret = "frame.args = {<br>"
for k, v in pairs(frameargs) do
	ret = ret .. "--[" .. k .. "] = " .. v .. ",<br>"
end
ret = ret .. "}<br>frame:getParent().args = {<br>"
for k, v in pairs(framegetParentargs) do
	ret = ret .. "--[" .. k .. "] = " .. v .. ",<br>"
end
ret = ret .. "}<br>"

	local name = frame.args.name
	local iconSize = frame.args.size
	local display = frame.args.display
	local needsPlural

	-- Initialize the array of unnamed parameters, up to 3, so several may be nil.
	local parent = frame:getParent()
	if parent then
		local parameterStack = { parent.args[1], parent.args[2], parent.args[3], }
		-- Then empty the stack and try to assign them as our variables.
		for _, nextParameter in ipairs(parameterStack) do
			ret = ret .. "nextParameter = " .. tostring(nextParameter) .. "<br>"
			if nextParameter and nextParameter ~= "" then
				-- Prioritize setting the name first.
				if not name or name == "" then
					name = nextParameter
					ret = ret .. "now name = " .. name .. "<br>"
				else
					-- These could happen in either order, because their valid values are non-overlapping
					ret = ret .. "checking VALID_SIZE[nextParameter] = " .. tostring(VALID_SIZE[nextParameter]) .. "<br>"
					if (not iconSize or iconSize == "") and VALID_SIZE[nextParameter] then
						iconSize = nextParameter
						ret = ret .. "now iconSize = " .. iconSize .. "<br>"
					else
						ret = ret .. "checking VALID_PLURAL[nextParameter] = " .. tostring(VALID_PLURAL[nextParameter]) .. "<br>"
						if not needsPlural and VALID_PLURAL[nextParameter] then
							needsPlural = nextParameter
							ret = ret .. "now needsPlural = " .. needsPlural .. "<br>"
						end
					end
				end
			end
		end
	end

	-- Validate the name before we continue any further.
	validatedIcon = validateBuildingName(name)

	-- Handle default icon size.
	if not iconSize or iconSize == "" or not VALID_SIZE[iconSize] then
		iconSize = "none"
	end

	-- The only valid value for mustBePlural is "s," so then make on check to see if name ends in a way that we need to add "es" at the end instead of just "s". For names that end in "y", we swap out the last character for "ies" instead. (This will require one-time setup for redirect pages.)
	if needsPlural == "s" or needsPlural == "es" then
		if string.match(name,"y$") then
			name = string.sub(name,1,-2) .. "ies"
			needsPlural = nil -- unset now, since it's incorporated into the name itself
		else
			local needsSyllable = string.match(name,"[sxz]$") or string.match(name,"sh$") or string.match(name,"ch$")
			needsPlural = needsSyllable and "es" or "s"
		end
	else
		needsPlural = nil
	end

	viewParameters = {
		["name"] = name,
		["plural"] = needsPlural,
		["iconfilename"] = validatedIcon,
		["iconsize"] = iconSize,
		["display"] = display,
	}

	ret = ret .. "<br>Finally...<br>name = " .. tostring(name) .. "<br>"
	ret = ret .. "iconSize = " .. tostring(iconSize) .. "<br>"
	ret = ret .. "needsPlural = " .. tostring(needsPlural) .. "<br>"

	return ret

	--return frame:expandTemplate{
	--	title = VIEW_TEMPLATE,
	--	args = viewParameters,
	--}

end

--endregion

return BuildingLink