Módulo:Fmtn

De Grupo Voalle

A documentação para este módulo pode ser criada em Módulo:Fmtn/doc

local p = {}

-- Padrões de construção conhecidos, com uma transformação para que se torne
-- um padrão válido.
-- O padrão não precisa ser perfeito, pois ele é validado como número
-- após a transformação.  Então não há problemas se ele eventualmente puder
-- produzir números inválidos.  Há apenas de tomar o cuidado para que não
-- produza números incorretos.
-- Obs.: Observar que muitos REGEXes não são válidos em Lua.
--       Veja a documentação em:
--       https://www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Patterns
local padroes_conhecidos = {
    {   "^[%d,]*%.%d*$",     -- formato 1,123,123.123
        false,                 -- não necessita de revisão
        {
        	{ ",", "" },           -- remove vírgulas
        }
    },
    {   "^[%d.]*,%d*$",      -- formato 1.123.123,123 ou 1123123,123
        false,                 -- não marcar para revisão
        {
        	{ "%.", "" },          -- remove pontos
        	{ ",", "."},           -- substitui vírgula por ponto
        }
    },
    {	"^[%d%s]*[,.]%d*$",  -- formato 1 123 123,123 ou 1 123 123.123
        false,                 -- não marcar para revisão
        {
        	{ "%s", "" },          -- remove espaços
        	{ ",", "."},           -- substitui vírgula por ponto, se houver
        }
    },
    {   "^[%d,]*,%d%d%d$",   -- formato 1,123,123
        false,                 -- não marcar para revisão
        {
        	{ ",", "" },           -- remove vírgulas
        }
    },
	{   "^[%d.]*%.%d%d%d$",   -- formato 1.123.123 (três dígitos no último bloco)
        false,                  -- não marcar para revisão
        {
        	{ ",", "" },            -- remove pontos
        }
    },
    {   "^[%d,]*,%d%d%d$",   -- formato 1,123,123 (três dígitos no último bloco)
        false,                 -- não marcar para revisão
        {
        	{ ",", "" },           -- remove vírgulas
        }
    },
	{   "^[%d%s]*%s%d%d%d$", -- formato 1 123 123 (três dígitos no último bloco)
        false,                -- não marcar para revisão
        {
        	{ "%s", "" },         -- remove espaços
        }
    },
    {   "^[%d.]*%.%d%d$",   -- formato 1.123.12 (dois dígitos no último bloco)
        true,                 -- marcar para revisão
        {
        	{ ".", "" },          -- remove pontos
        	{ "(%d%d)$", ".%1" }, -- insere um ponto antes dos dois últimos dígitos
        }
    },
    {   "^[%d,]*,%d%d$",    -- formato 1,123,12 (dois dígitos no último bloco)
        true,                 -- marcar para revisão
        {
        	{ ",", "" },          -- remove vírgulas
        	{ "(%d%d)$", ".%1" }, -- insere um ponto antes dos dois últimos dígitos
        }
    },
    {   "^[%d%s]%s%d%d$",    -- formato 1 123 12 (dois dígitos no último bloco)
        true,                 -- marcar para revisão
        {
        	{ "%s", "" },          -- remove espaços
        	{ "(%d%d)$", ".%1" }, -- insere um ponto antes dos dois últimos dígitos
        }
    },
}

function p.fmtn(frame)
	local param1 = frame.args[1] or ""
	local param2 = frame.args[2] or ""
	local param3 = frame.args[3] or ""
	
	num1, isnumber1, needcheck1 = reconhece_numero(param1)
	num2, isnumber2, needcheck2 = reconhece_numero(param2)
	num3, isnumber3, needcheck3 = reconhece_numero(param3)
	
	isarticle = mw.title.getCurrentTitle().namespace == 0
	
	prefixo = ''
	sufixo = ''
	if isnumber1 and not isnumber2 and not isnumber3 then
		-- somente o primeiro número é válido
		mynum = num1
		needcheck = needcheck1
		if param2 ~= '' then sufixo = sufixo .. ' ' .. param2 end
		if param3 ~= '' then sufixo = sufixo .. ' ' .. param3 end
	elseif not isnumber1 and isnumber2 and not isnumber3 then
		-- somente o segundo número é válido
		mynum = num2
		needcheck = needcheck2
		if param1 ~= '' then prefixo = prefixo .. param1 .. ' ' end
		if param3 ~= '' then sufixo = sufixo .. ' ' .. param3 end
	elseif not isnumber1 and not isnumber2 and isnumber3 then
		-- somente o terceiro número é válido
		mynum = num3
		needcheck = needcheck3
		if param1 ~= '' then prefixo = prefixo .. param1 .. ' ' end
		if param2 ~= '' then prefixo = prefixo .. param2 .. ' ' end
	else
		-- ERRO: existem mais de dois números válidos, ou nenhum é válido
		-- Nesse caso, faz o que já era feito antes, tenta formatar da forma
		-- que for possível e retorna os parâmetros na ordem que foram
		-- apresentados
		
		-- Aqui usa-se o "callParserFunction" para copiar o comportamento que já
		-- era presenciado antes desse módulo existir e evitar que erros sejam
		-- impressos nos artigos
		res = ''
		if param1 ~= '' then
			res = res .. formatnum(param1)
		end
		if param2 ~= '' then
			if res ~= '' then res = res .. ' ' end
			res = res .. formatnum(param2)
		end
		if param3 ~= '' then
			if res ~= '' then res = res .. ' ' end
			res = res .. formatnum(param3)
		end
		if isarticle then
			res = res .. '[[Categoria:!Páginas com erro de uso da predefinição Fmtn]]'
		end
		return res
	end
	
  	res = prefixo .. formatnum(mynum) .. sufixo
  	if needcheck and isarticle then
  		res = res .. '[[Categoria:!Páginas cujo uso da predefinição Fmtn deve ser revisado]]'
  	end
  	return res
end

function formatnum(num)
	frame = mw.getCurrentFrame()
	return frame:callParserFunction{ name = 'formatnum', args = { num } }
	
	-- Não é utilizado pois não preserva o número de dígitos após a casa decimal
	-- lang = mw.language.getContentLanguage()
	-- return lang:formatNum(mynum)
end

function reconhece_numero(num)
	if tonumber(num) then
		-- já é um número válido, não precisa fazer nada
		isnumber = true
		needcheck = false
	else
		isnumber = false
		needcheck = true
		-- não é um número válido, observa os padrões para ver
		-- se pode ser convertido em um padrão válido
		for _, rule in pairs(padroes_conhecidos) do
			checkpattern = rule[1]
			if string.find(num, checkpattern) then
				newneedcheck = rule[2]
				substitutions = rule[3]
				
				newstr = num
				for _, subs in pairs(substitutions) do
					-- aplica a substituição na string
					newstr = string.gsub(newstr, subs[1], subs[2])
				end
				
				if tonumber(newstr) then
					-- verifica se a transformação produziu um número válido
					-- caso positivo, encerra o loop
					num = newstr
					isnumber = true
					needcheck = newneedcheck
					break
				end
			end
		end
		-- se nenhum padrão bateu, então deve ser inválido
		-- deixa o código retornar o mesmo número passado e deixa que
		-- o chamador faça o seu trabalho
	end
	return num, isnumber, needcheck
end

return p