Module:TestModule

From Against the Storm Official Wiki
Revision as of 13:20, 17 October 2024 by Aeredor (talk | contribs) (Testing)

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

--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 name = frame.args.name
	local iconSize = frame.args.size
	local needsPlural = frame.args.plural
	local display = frame.args.display

	---- If the iconSize was not specified, but plural was "s", then these will match. We need to unset the iconSize to be default.
	--if iconSize == needsPlural and (needsPlural == "s" or needsPlural == "es") then
	--	iconSize = nil
	--end
	--
	---- It is valid by now; the above method already threw an error if not.
	--validatedIcon = validateBuildingName(name)
	--
	---- 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, since it's incorporated into the name
	--	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,
	--}

	local frameargs = frame.args
	framegetParentargs = frame:getParent().args

	local ret = "frame.args = {\n" ..
		"  name = " .. frameargs.name or "nil" .. "\n" ..
		"  size = " .. frameargs.size or "nil" .. "\n" ..
		"  display = " .. frameargs.display or "nil" .. "\n" ..
		"}\n" ..
		"frame:getParent().args = {\n" ..
		" 1 = " .. framegetParentargs[1] or "nil" .. "\n" ..
		" 2 = " .. framegetParentargs[2] or "nil" .. "\n" ..
		" 3 = " .. framegetParentargs[3] or "nil" .. "\n" ..
		"}"

	return ret

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

--endregion

return BuildingLink