Module:Utils

From Halopedia, the Halo wiki

Revision as of 15:38, April 24, 2021 by Dab1001 (talk | contribs)

Documentation for this module may be created at ModuleDoc:Utils

local utils = {}

function utils.defaultIfEmpty( val, default )
	if val == nil or val == '' then
		return default
	else
		return val
	end
end

function utils.loadDataIfExists( name )
	local success, data = pcall( mw.loadData, name )
	if success then
		return data
	else
		return nil
	end
end

function utils.error( ... )
	-- Collect necessary information to display error
	local message = tostring( utils.defaultIfEmpty( select( 1, ... ), 'There was an error with a template. Are the parameters all correct?' ) )
	local etype = tostring( utils.defaultIfEmpty( select( 2, ... ), 'Template' ) )
	local category = tostring( utils.defaultIfEmpty( select( 3, ... ), 'Pages containing template errors' ) )
	local template = utils.defaultIfEmpty( select( 4, ... ), nil )
	
	-- Style data 
	etype = string.upper( etype )
	template = tostring( template )
	
	-- Add a warning to the edit preview
	if template == nil then
		mw.addWarning( "'''" .. etype .. " ERROR:''' " .. message )
	else
		mw.addWarning( "'''" .. etype .. " ERROR:''' " .. message .. ' (Template: [[Template:' .. template .. '|' .. template .. ']])' )
	end
	
	-- Create and return the text to display on the page itself
	return [[<span class="error halopedia-template-error" style="color: red;">''']]
		.. etype
		.. [[ ERROR:''' ]]
		.. message
		.. '(Template: [[Template:'
		.. template
		.. '|'
		.. template
		.. ']]</span> [[Category:'
		.. category
		.. ']]'
end

function utils.warning( ... )
	-- Collect necessary information to display warning
	local message = tostring( utils.defaultIfEmpty( select( 1, ... ), 'This template issued a warning. Are the parameters all correct?' ) )
	local wtype = tostring( utils.defaultIfEmpty( select( 2, ... ), 'Template' ) )
	local category = tostring( utils.defaultIfEmpty( select( 3, ... ), 'Pages containing template warnings' ) )
	local template = utils.defaultIfEmpty( select( 4, ... ), nil )
	
	-- Style data 
	wtype = string.upper( wtype )
	
	-- Add a warning to the edit preview
	if template == nil then
		mw.addWarning( "'''" .. wtype .. " WARNING:''' " .. message )
	else
		mw.addWarning( "'''" .. wtype .. " WARNING:''' " .. message .. ' (Template: [[Template:' .. template .. '|' .. template .. ']])' )
	end
	
	-- Create and return the text to add to the page. In this case, we only add
	-- the category - no message, as warnings should be silent to the reader
	return '[[Category:' .. category .. ']]'
end

return utils