Module:Param Parse

From Brighter Shores Wiki
Revision as of 05:00, 28 October 2024 by Gau Cho (talk | contribs)
Jump to navigation Jump to search
Module documentation
This documentation is transcluded from Module:Param Parse/doc. [edit] [history] [purge]
Module:Param Parse requires Module:Infobox.
Module:Param Parse is required by .

These params and functions are used to validate and format information passed into an Infobox. See Module:Infobox for details and instructions on creating an Infobox. If the information is missing or not valid, the functions here should return nil.

Here is a summary of all the params:

param explanation
parse.actions Actions listed in the action menu
parse.name Title
parse.description Description of the entity in its card
parse.image [[File:IMAGE.png]]. Use the class infobox-image in the table
parse.image_size300 [[File:IMAGE.png|300x300px]] by default unless overridden. Use the class infobox-image in the table
parse.episode Episode name
parse.additional_episode Episode name
parse.premium Premium (Yes, No, N/A)
parse.release Release Date in the format YYYY-MM-DD
parse.value Shows the value as a denomination of coins
parse.profession TODO
parse.profession_bubble_a, parse.profession_bubble_b Takes parameters profession_a + profession_a_level, or profession_b + profession_b_level
parse.profession_a_smw, parse.profession_a_level_smw, parse.profession_b_smw, parse.profession_b_level_smw Exports the data from profession_bubble_a and profession_bubble_b to smw
parse.variant TODO - Which category the subject is a variant of
parse.passive Passiveness (Yes, No, N/A)
parse.duration Number of hours to complete the venture
parse.aggressive Aggressive (Yes, No, N/A)
parse.difficulty Quest difficulty (0-5)
parse.quest Quest name (or No)
parse.unlock_level Unlocked at
parse.knowledge Knowledge

Here are some general use functions that can be used for custom or new params:

function name explanation
has_content(arg) Returns arg if any non-whitespace character is found in the string.
number(num) Removes any commas and parses the string as a number
yes_no(text) Only accepts "Yes", "No" and "N/A"
yes_no_smw(text) Maps "Yes", "No" to true and false respectively

Creating New Params

Ideally, params should be defined here so that they can be reused between different Infoboxes. Here is how to create a new param: 

parse.paramname = {
	name = <param>,
    func = <func>,
    empty = 'empty', -- optional
    category_never = 'category', -- optional
    category_partial = 'category', -- optional
    category_incomplete = 'category', -- optional
    category_complete = 'category', -- optional
    smw_property = 'Property', -- optional
    smw_func = <func>, -- optional
}


key value
name parameter name as used in the Template
func A function in Module:Param Parse to validate and process the Template argument. You can also use a local function, but this is not recommended.

If func is a function, will call func(Infobox.raw_param(name)): 

	{name = <param>, func = <func>, ... },

If func is a table, it takes the following parameters: 

	{name = <param>, func = { name = <func>, params = <func_params>}, ... },
name function in Module:Param Parse
params a list of parameters to pass the the function, in the form of constants, or Infobox.raw_param(name), Infobox.param(name), Infobox.smw_param(name)
empty (optional) text to display in the infobox if func returns nil; defaults to "? (edit)"
category_never (optional) category to add if func returns nil for all versions
category_partial (optional) category to add if func returns nil for some versions, but a value for other versions
category_incomplete (optional) category to add if func returns nil for at least 1 version (i.e. category_never and category_partial combined)
category_complete (optional) category to add if func returns a value for all versions
smw_property (optional) if this string is defined, the parameter will be saved into SMW
smw_func (optional) function to validate and process the Template argument to save into SMW. func is used by default if smw_func is not defined 
--[=[
-- Standardized functions to parse Infobox params
--]=]
-- <nowiki>
local Infobox = require('Module:Infobox')

local parse = {}

-- Generic functions --
-----------------------

-- Standardized "has content" function
function parse.has_content(arg)
	-- Return arg if any non-whitespace character is found
	return string.match(arg or '', '%S') and arg or nil
end

-- Standardized numbers
function parse.number(num)
	num = string.gsub(num or '',',','')
	return tonumber(num)
end

-- Yes/No
local yes_no = {
	['Yes'] = 'true',
	['No'] = 'false',
	['N/A'] = 'NIL',
}
function parse.yes_no(text)
	if yes_no[text] ~= nil then
		return text
	end
	return nil
end
function parse.yes_no_smw(text)
	if text == 'N/A' then
		return nil
	end
	local bool = yes_no[text]
	if bool ~= nil then
		return bool
	end
	return nil
end

-- Premade Params --
--------------------

-- Standardized name function
parse.name = {
	name = 'name',
	func = parse.has_content,
	smw_property = 'Name',
	category_incomplete = 'Needs name',
}
-- Standardized examine function
parse.examine = {
	name = 'examine',
	func = parse.has_content,
	smw_property = 'Examine',
	category_incomplete = 'Needs examine',
}

-- Standardized image function
function parse.image_name(img)
	if img then
		return string.match(img, '%[%[(File:.+%.%w%w%w)|?%d*x?%d*p?x?%]%]')
	end
	return nil
end
function parse.image_height(img, default)
	if img then
		return string.match(img, '%[%[File:.+%.%w%w%w|%d*x(%d*)px%]%]') or default
	end
	return default
end
function parse.image_width(img, default)
	if img then
		return string.match(img, '%[%[File:.+%.%w%w%w|(%d*)x?%d*px%]%]') or default
	end
	return default
end
function parse.image_func(img, default_width, default_height)
	local name = parse.image_name(img)
	local width = parse.image_width(img, default_width)
	local height = parse.image_height(img, default_height)
	local size = ''
	if width and height then
		size = '|'..width..'x'..height..'px'
	elseif width then
		size = '|'..width..'px'
	elseif height then
		size = '|x'..height..'px'
	end
	if name then
		return '[['..name..size..']]'
	end
	return nil
end
function parse.image_smw(img)
	return parse.image_name(img)
end

parse.image = {
	name = 'image',
	func = parse.image_func,
	smw_property = 'Image',
	smw_func = parse.image_smw,
	empty = '[[Special:Upload|Please upload an image!]]',
	category_incomplete = 'Needs image',
}
parse.image_size300 = {
	name = 'image',
	func = {name = parse.image_func, params = {Infobox.raw_param('image'), 300, 300}},
	smw_property = 'Image',
	smw_func = parse.image_smw,
	empty = '[[Special:Upload|Please upload an image!]]',
	category_incomplete = 'Needs image',
}


-- Episode
local valid_episodes = {
	['hopeport'] = 'Hopeport',
	['hopeforest'] = 'Hopeforest',
	['mine of mantuban'] = 'Mine of Mantuban',
	['crenopolis'] = 'Crenopolis'
}
function parse.episode_func(episode)
	local valid_episode = valid_episodes[string.lower(episode or '')]
	if valid_episode then
		return '[[File:'..valid_episode..' episode icon.png|18px]] [['..valid_episode..']]'
	end
	return nil
end
function parse.episode_smw(episode)
	local valid_episode = valid_episodes[string.lower(episode or '')]
	if valid_episode then
		return valid_episode
	end
	return nil
end
parse.episode = {
	name = 'episode',
	func = parse.episode_func,
	smw_property = 'Episode',
	smw_func = parse.episode_smw,
	category_incomplete = 'Needs episode',
}

-- Premium
parse.premium = {
	name = 'premium',
	func = parse.yes_no,
	smw_property = 'Premium',
	smw_func = parse.yes_no_smw,
	category_incomplete = 'Needs premium status',
}

-- Release
function unix_time(date)
	-- Convert a time to unix time
	if date == nil then
		return nil
	end
	local year, month, day = string.match(date, '(%d+)-(%d+)-(%d+)')
	if year == nil or month == nil or day == nil then
		return nil
	end
	return os.time{year=year, month=month, day=day}
end
function parse.release_func(date)
	local time = unix_time(date)
	if time == nil then
		return nil
	end
	local formatted_date = os.date('%Y %B %d', time) -- 2024 January 01
	formatted_date = string.gsub(formatted_date, ' 0', ' ') -- Convert 2024 January 01 to 2024 January 1
	return formatted_date
end
function parse.release_smw(date)
	local time = unix_time(date)
	if time == nil then
		return nil
	end
	local formatted_date = os.date('%Y-%m-%d') -- 2024-01-01
	return formatted_date
end
parse.release = {
	name = 'release',
	func = parse.release_func,
	category_incomplete = 'Needs release date',
	smw_property = 'Release Date',
	smw_func = parse.release_smw,
}

-- Profession (TODO)
parse.profession = {
	name = 'profession',
	func = parse.has_content,
	category_incomplete = 'Needs profession',
	smw_property = 'Profession' -- TODO - Need to create property page
}

parse.variant = {
	name = 'variant',
	func = parse.has_content,
	category_incomplete = 'Needs variant details',
	smw_property = 'Variant of' -- TODO - Need to create property page
}

parse.passive = {
	name = 'passive',
	func = parse.yes_no,
	smw_property = 'Passive',
	smw_func = parse.yes_no_smw,
	category_incomplete = 'Needs passiveness'
}

return parse
-- </nowiki>
Retrieved from ‘https://brightershoreswiki.org/w/Module:Param_Parse?oldid=3298’