Módulo:Yesno

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

Este módulo fornece uma interface consistente para o processamento de strings de entrada booleanas ou de tipo booleano. É um módulo para ser usado por outros módulos, não independentemente. Enquanto Lua permite os valores booleanos true e false, predefinições em código wiki só podem expressar valores booleanos através de strings tais como "sim", "não", etc. Este módulo processa esse tipo de strings e converte-as em entradas booleanas para que Lua possa processá-las. Ele também retorna valores nil como nil, para permitir que haja distinção entre nil e false. O módulo também aceita outras estruturas em Lua como entrada, por exemplo booleanos, números, tabelas, e funções. É possível especificar um valor padrão a ser retornado em todos os casos.

Sintaxe

yesno(valor, padrão)

valor é o valor a ser testado. Entradas booleanas ou de tipo booleano (ver abaixo) são sempre avaliadas como true ou false, e valores nil sempre são avaliados como nil. Outros valores são avaliados como padrão.

Uso

Primeiro, carrega-se o módulo. Note que só pode ser carregado a partir de outros módulos feitos em Lua, não de páginas wiki em outros domínios, como predefinições, domínio principal e/ou páginas de usuário; Para essas, a predefinição {{yesno}} pode servir como substitutivo. Para carregar o módulo, utiliza-se a seguinte linha de comando:

local yesno = require('Module:Yesno')

Alguns valores de entrada sempre retornam true, e alguns sempre retornam false. Valores nil sempre retornam nil.

-- Estes sempre retornam true:
yesno('sim')
yesno('verdadeiro')
yesno('yes')
yesno('y')
yesno('true')
yesno('1')
yesno(1)
yesno(true)

-- Estes sempre retornam false:
yesno('não')
yesno('falso')
yesno('no')
yesno('n')
yesno('false')
yesno('0')
yesno(0)
yesno(false)

-- Valores nil sempre retornam nil:
yesno(nil)

Valores string são convertidos para letras minúsculas antes de serem testados:

-- Estes sempre retornam true:
yesno('Sim')
yesno('SIM')
yesno('sIm')
yesno('vErDaDeIrO')

-- Estes sempre retornam false:
yesno('Não')
yesno('NÃO')
yesno('nÃO')
yesno('fALsO')

É possível especificar um valor padrão para o caso de yesno receber como entrada algo que não esteja listado acima. Se não for fornecido um valor padrão, o módulo retornará nil para tais entradas.

-- Estes retornam nil:
yesno('teste')
yesno({})
yesno(5)
yesno(function() return 'Esta é uma função.' end)

-- Estes retornam true:
yesno('teste', true)
yesno({}, true)
yesno(5, true)
yesno(function() return 'Esta é uma função.' end, true)

-- Estes retornam "padrão":
yesno('teste', 'padrão')
yesno({}, 'padrão')
yesno(5, 'padrão')
yesno(function() return 'Esta é uma função.' end, 'padrão')

Note que a string vazia também funciona deste modo:

yesno('')        -- Retorna nil.
yesno('', true)  -- Retorna true.
yesno('', 'padrão') -- Retorna "padrão".

Embora a string vazia geralmente seja avaliada como false em código wiki, ela é avaliada como true em Lua. Este módulo prefere o comportamento em Lua em vez do comportamento em código wiki. Se para o seu módulo for importante tratar strings vazias como false, você precisará remover os argumentos vazios em um estágio anterior do processamento.

Testes unitários

Abaixo estão listados testes unitários deste módulo, de modo a garantir o funcionamento do módulo em todos os casos que ele se propõe a cobrir e que ao ser atualizado ou modificado, continue a garantir seu funcionamento integral.

Todos os testes passaram.

test_nil

	Texto	Esperado	Atual
Sim	nil	nil	nil
Sim	'teste'	nil	nil
Sim	{}	nil	nil
Sim	5	nil	nil
Sim	'5'	nil	nil
Sim	function() return 'Esta é uma função.' end	nil	nil
Sim	''	nil	nil

test_no

	Texto	Esperado	Atual
Sim	'não'	false	false
Sim	'Não'	false	false
Sim	'NÃO'	false	false
Sim	'nÃo'	false	false
Sim	'falso'	false	false
Sim	'fAlSo'	false	false
Sim	'false'	false	false
Sim	false	false	false
Sim	'f'	false	false
Sim	'no'	false	false
Sim	'n'	false	false
Sim	'0'	false	false
Sim	0	false	false
Sim	'teste' default = false	false	false
Sim	{} default = false	false	false
Sim	5 default = false	false	false
Sim	function() return 'Esta é uma função.' end default = false	false	false
Sim	'' default=false	false	false

test_padrao

	Texto	Esperado	Atual
Sim	'teste' default='padrão'	padrão	padrão
Sim	{} default='padrão'	padrão	padrão
Sim	5 default='padrão'	padrão	padrão
Sim	'5' default='padrão'	padrão	padrão
Sim	function() return 'Esta é uma função.' end default='padrão'	padrão	padrão
Sim	'' default='padrão'	padrão	padrão

test_yes

	Texto	Esperado	Atual
Sim	'sim'	true	true
Sim	'Sim'	true	true
Sim	'SIM'	true	true
Sim	'sIm'	true	true
Sim	'verdadeiro'	true	true
Sim	'vErDaDeIrO'	true	true
Sim	'yes'	true	true
Sim	'y'	true	true
Sim	'true'	true	true
Sim	true	true	true
Sim	't'	true	true
Sim	'1'	true	true
Sim	1	true	true
Sim	'teste' default = true	true	true
Sim	{} default = true	true	true
Sim	5 default = true	true	true
Sim	function() return 'Esta é uma função.' end default = true	true	true
Sim	'' default=true	true	true

A documentação acima é transcluída de Módulo:Yesno/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.

-- Function allowing for consistent treatment of boolean-like wikitext input.
-- It works similarly to the template {{yesno}}.

return function (val, default)
	-- If your wiki uses non-ascii characters for any of "yes", "no", etc., you
	-- should replace "val:lower()" with "mw.ustring.lower(val)" in the
	-- following line.
	val = type(val) == 'string' and mw.ustring.lower(val) or val
	if val == nil then
		return nil
	elseif val == true
		or val == 'sim'
		or val == 's'
		or val == 'verdadeiro'
		or val == 'yes'
		or val == 'y'
		or val == 'true'
		or val == 't'
		or tonumber(val) == 1
	then
		return true
	elseif val == false
		or val == 'não'
		or val == 'nao'
		or val == 'falso'
		or val == 'no'
		or val == 'n'
		or val == 'false'
		or val == 'f'
		or tonumber(val) == 0
	then
		return false
	else
		return default
	end
end