Module:MOS scalesig

Revision as of 21:11, 8 March 2025 by Ganaram inukshuk (talk | contribs) (remove preprocessing function, as expected input will always be unparsed scalesigs)
Module documentation[view] [edit] [history] [purge]
This module should not be invoked directly; use its corresponding template instead: Template:MOS scalesig.

Module:MOS scalesig formats a string into a mos scale signature, with non-breaking spaces and, if non-octave, the appropriate brackets. Scale signatures can optionally be formatted as a link to the scale's wiki page.

Introspection summary for Module:MOS scalesig 
Functions provided (3)
Line Function Params
12 _mos_scalesig (main) (input_mos, is_link, is_long)
24 mos_scalesig (invokable) (frame)
34 tester none
Lua modules required (3)
Variable Module Functions used
getArgs Module:Arguments getArgs
mos Module:MOS as_long_link
as_link
as_long_string
as_string
parse
new
yesno Module:Yesno yesno

No function descriptions were provided. The Lua code may have further information.


local mos = require("Module:MOS")
local yesno = require("Module:Yesno")
local getArgs = require("Module:Arguments").getArgs
local p = {}

-- Function to format a string into a mos scalesig, with nonbreaking spaces.
-- Options are:
-- - is_long - Whether to use "xL ys<p/q>" or "xL ys (p/q-equivalent)". Only
--   applies for nonoctave mosses, as a scalesig without an equave is assumed to
--   be 2/1-equivalent.
-- - is_link - Whether the scalesig is a link to its wiki page.
function p._mos_scalesig(input_mos, is_link, is_long)
	local is_link = yesno(is_link, false)
	local is_long = yesno(is_long, false)
	
	if is_link then
		return is_long and mos.as_long_link(input_mos) or mos.as_link(input_mos)
	else
		return is_long and mos.as_long_string(input_mos) or mos.as_string(input_mos)
	end
end

-- Wrapper function for use with a template
function p.mos_scalesig(frame)
	local args = getArgs(frame)
	
	local input_mos = mos.parse(args["scalesig"])
	local is_link = yesno(args["link"], false)
	local is_long = yesno(args["long"], false)
	
	return p._mos_scalesig(unparsed, is_link, is_long)
end

function p.tester()
	local input_mos = mos.new(5,2)
	return p._mos_scalesig(input_mos, true, true)
end

return p