Módulo:Expiração efetiva de proteção

Documentação do módulo[ver] [editar] [histórico] [purgar]

Este módulo fornece uma maneira de recuperar a expiração de uma restrição sobre uma determinada ação em uma página.

Uso

Este módulo usará até 1 chamada de função de analisador cara toda vez que for executado. Ele não usará nenhuma se Módulo:Nível efetivo de proteção já tiver sido chamado.

A partir de outros módulos

Para carregar este módulo:

local effectiveProtectionExpiry = require('Módulo:Expiração efetiva de proteção')._main

A função aceita dois parâmetros. O primeiro é uma sequência contendo a ação a ser verificada, que deve ser um dos seguintes: "edit", "create", "move", "upload", ou "autoreview". O segundo é opcional e pode ser o nome da página a ser verificada ou um título retornado das funções "mw.title". Se o segundo parâmetro for omitido, a página que está sendo mostrada é a verificada.

O valor de retorno é uma sequência de data no formato YY-MM-DDThh:mm:ss ou uma das seguintes sequências:

• infinity - para páginas protegidas indefinidamente ou páginas que existem e não estão protegidas
• unknown - para páginas onde a expiração é desconhecida, ou páginas que não existem e não estão protegidas

Observe que, se uma página existente não estiver protegida para a ação solicitada, isso retornará "infinity". Você precisa verificar separadamente com Módulo:Nível efetivo de proteção.

A partir de texto wiki

Os parâmetros são os mesmos de quando é chamado diretamente.

{{#invoke:Expiração efetiva de proteção|ação|título}}

Ver também

• Módulo:Nível efetivo de proteção

Nota

A documentação acima é transcluída de Módulo:Expiração efetiva de proteção/doc. (editar | histórico)
Editores podem experimentar nas páginas de teste (editar | dif) e de exemplos para testes (criar) deste módulo.
Subpáginas deste módulo.

local p = {}

-- Retorna a expiração de uma restrição de uma ação em um determinado título ou desconhecido ('unknown') se não puder ser conhecido.
-- Se nenhum título for especificado, o título da página que está sendo mostrada será usado.
function p._main(action, pagename)
	local title
	if type(pagename) == 'table' and pagename.prefixedText then
		title = pagename
	elseif pagename then
		title = mw.title.new(pagename)
	else
		title = mw.title.getCurrentTitle()
	end
	pagename = title.prefixedText
	if action == 'autoreview' then
		local stabilitySettings = mw.ext.FlaggedRevs.getStabilitySettings(title)
		return stabilitySettings and stabilitySettings.expiry or 'unknown'
	elseif action ~= 'edit' and action ~= 'move' and action ~= 'create' and action ~= 'upload' then
		error( 'O primeiro parâmetro deve ser um dos seguintes: edit, move, create, upload, ou autoreview.', 2 )
	end
	local rawExpiry = mw.getCurrentFrame():callParserFunction('PROTECTIONEXPIRY', action, pagename)
	if rawExpiry == 'infinity' then
		return 'infinity'
	elseif rawExpiry == '' then
		return 'unknown'
	else
		local year, month, day, hour, minute, second = rawExpiry:match(
			'^(%d%d%d%d)(%d%d)(%d%d)(%d%d)(%d%d)(%d%d)$'
		)
		if year then
			return string.format(
				'%s-%s-%sT%s:%s:%s',
				year, month, day, hour, minute, second
			)
		else
			error('erro interno em Módulo:Expiração efetiva de proteção; carimbo de data/hora de expiração malformado')
		end
	end
end

setmetatable(p, { __index = function(t, k)
	return function(frame)
		return t._main(k, frame.args[1])
	end
end })

return p