Modulo:UnitTests

Manipud iti Wikipedia, ti nawaya nga ensiklopedia
Darsen a mapan iti pagdaliasatan Darsen a mapan agbiruk
Dokumentasion ti modulo[kitaen] [urnosen] [pakasaritaan] [purgaen]

Ti UnitTests ket mangited ti pangsubok a pamay-an a mabalin nga usaren dagiti sabali nga eskritu babaen ti panagusar ti require. Kitaen ti Wikipedia:Lua#Panagsubok para kadagiti salaysay. Ti sumaganad ket kas pagarigan manipud ti Modulo:Kumusta/pangsubok:

-- Pangsubok para iti [[Modulo:Kumusta]]. Pinduten ti tungtunganna a panid tapno maipataray ti pangsubok.
local p = require('Modulo:UnitTests')
 
function p:test_kumusta()
    self:preprocess_equals('{{#invoke:Kumusta | kumusta}}', 'Kumusta amin nga Ilokano, iti lubong!')
end
 
return p

Ti tungtungan a panid ti Modulo tungtungan:Kumusta/pangsubok ket mangpataray iti {{#invoke: Kumusta/pangsubok | run_tests}}. Dagiti pamay-an a kas ti test_kumusta dita ngato ket nasken a mangrugi iti "test".

Dagiti pamay-an[urnosen ti taudan]

run_tests[urnosen ti taudan]

  • run_tests(differs_at): Patarayenna amin a pangsubok. No daytoy ket nainaganan ti "differs_at=1", ti maysa a batong ket mainayonto a mangipakpakita ti umuna a puesto ti karakter nga ayan ti paggiddiatan ti manamnama ken ti pudno a resulta. Kadawyan daytoy a maus-usar iti tungtungan a panid ti pagsubokan.
    {{#invoke:Kumusta/pangsubok|run_tests}}

preprocess_equals[urnosen ti taudan]

  • preprocess_equals(text, expected): Mangited ti maysa a pisi iti wikitext tapno maproseso ken ti maysa manamnama a pateg. Dagiti eskritu ken plantilia ket mabalin a maiparuar iti isu met laeng a waya iti maysa met laeng a panid.
    self:preprocess_equals('{{#invoke:Kumusta | kumusta}}', 'Kumusta amin nga Ilokano, iti lubong!')

preprocess_equals_many[urnosen ti taudan]

  • preprocess_equals_many(prefix, suffix, cases): Agaramid kadagiti serie ti preprocess_equals() tawagenna iti maysa nga agsmang iti naited a paris. Automatiko a mangnayon iti naited a prefix ken suffix iti tunggal maysa a teksto.
    self:preprocess_equals_many('{{#invoke:KumustaArgs | add |', '}}', {
        {'2|3', '5'},
        {'-2|2', '0'},
    })

preprocess_equals_preprocess[urnosen ti taudan]

  • preprocess_equals_preprocess(text, expected): Mangited ti dua a pisi iti wikitext tapno maproseso ken mangikeddeng no agpataudda ti isu met laeng a pateg. Naserbi daytoy para iti panangipada kadagiti eskritu kadagiti adda a plantilia.
    self:preprocess_equals_preprocess('{{#invoke:Kumusta | kumusta}}', '{{Kumusta}}')

preprocess_equals_preprocess_many[urnosen ti taudan]

  • preprocess_equals_preprocess_many(prefix, suffix, cases): Agaramid kadagiti serie ti preprocess_equals_preprocess() mangtawag ti maysa nga agasmang kadagiti naited a paris. Ti prefix/suffix a naited para kadagiti dua nga argumento ket automatiko a mainayon. No iti aniaman a kaso a ti maikadua paset ket saan a nainaganan, ti umuna a paset ket isunto ti mausar.
    self:preprocess_equals_preprocess_many('{{#invoke:Foo | spellnum |', '}}', '{{spellnum', '}}', {
        {'2'}, -- equivalent to {'2','2'},
        {'-2', '-2.0'},
    })

equals[urnosen ti taudan]

  • equals(name, actual, expected): Mangited ti maysa a nakarkulo a pateg ken ti nanamnama a pateg, ken kitaenna no dagitoy ket agpadpada segun ti == operator. Naserbi daytoy para iti pangsubok kadagiti modulo a nadaremdem a mausar babaen dagiti sabali a modulo nga imbes nga usaren ti #invoke.
    self:equals('Simple addition', 2 + 2, 4)

equals_deep[urnosen ti taudan]

  • equals_deep(name, actual, expected): Kasla iti equals, ngem mangtengngel kadagiti tabla babaen ti panagaramid ti nauneg a panangipada. Dagiti pateg ket nasken a saan nga aglaon kadagiti nagtimbukel a reperensia, gaputa dagitoy ket saan a tinengtengngel babaen ti agdama nga implementasion ket mabalin nga agresulta iti maysa nga awan patinggana a silo.
    self:equals_deep('Table comparison', createRange(1,3), {1,2,3})

Kitaen pay[urnosen ti taudan]

-- Ti UnitTester ket agited kadagiti pangsubok para kadagiti eskritu ti Lua.
-- Kitaen ti dokumentasionna no kasano ti panagusar.
local UnitTester = {}

local frame, tick, cross
local result_table_header = "{|class=\"wikitable\"\n|+ %s\n! !! Teksto !! Manamnama !! Pudno"

local result_table = { n = 0 }
local result_table_mt = {
	insert = function (self, ...)
		local n = self.n
		for i = 1, select('#', ...) do
			local val = select(i, ...)
			if val ~= nil then
				n = n + 1
				self[n] = val
			end
		end
		self.n = n
	end,
	insert_format = function (self, ...)
		self:insert(string.format(...))
	end,
	concat = table.concat
}
result_table_mt.__index = result_table_mt
setmetatable(result_table, result_table_mt)

local num_failures = 0

function first_difference(s1, s2)
    if s1 == s2 then return '' end
    local max = math.min(#s1, #s2)
    for i = 1, max do
        if s1:sub(i,i) ~= s2:sub(i,i) then return i end
    end
    return max + 1
end

local function return_varargs(...)
	return ...
end

function UnitTester:preprocess_equals(text, expected, options)
    local actual = frame:preprocess(text)
    if actual == expected then
        result_table:insert('| ', tick)
    else
        result_table:insert('| ', cross)
        num_failures = num_failures + 1
    end
    local maybe_nowiki = (options and options.nowiki) and mw.text.nowiki or return_varargs
    local differs_at = self.differs_at and (' \n| ' .. first_difference(expected, actual)) or ''
    result_table:insert(' \n| ', mw.text.nowiki(text), ' \n| ',
    	maybe_nowiki(expected), ' \n| ', maybe_nowiki(actual), differs_at,
    	"\n|-\n")
end

function UnitTester:preprocess_equals_many(prefix, suffix, cases, options)
    for _, case in ipairs(cases) do
        self:preprocess_equals(prefix .. case[1] .. suffix, case[2], options)
    end
end

function UnitTester:preprocess_equals_preprocess(text1, text2, options)
    local actual = frame:preprocess(text1)
    local expected = frame:preprocess(text2)
    
    if options and true == options.templatestyles then						-- when module rendering has templatestyles strip markers, use ID from expected to prevent false test fail
        local pattern = '(\127[^\127]*UNIQ%-%-templatestyles%-)(%x+)(%-QINU[^\127]*\127)';	-- templatestyle stripmarker pattern
        local _, stripmarker_id = expected:match (pattern);					-- get templatestyles strip marker id from expected (the reference); ignore first capture in pattern

        if stripmarker_id then
            actual = actual:gsub (pattern, '%1'..stripmarker_id..'%3');				-- replace actual id with expected id; ignore second capture in pattern
        end
    end
	
    -- option to ignore any strip marker when comparing actual to expected
    if options and true == options.stripmarker then
        local pattern = '(\127[^\127]*UNIQ%-%-%l+%-)(%x+)(%-QINU[^\127]*\127)';
        local _, stripmarker_id = expected:match (pattern);
        if stripmarker_id then
            actual = actual:gsub (pattern, '%1'..stripmarker_id..'%3');
        end
    end

    if actual == expected then
        result_table:insert('| ', tick)
    else
        result_table:insert('| ', cross)
        num_failures = num_failures + 1
    end
    local maybe_nowiki = (options and options.nowiki) and mw.text.nowiki or return_varargs
    local differs_at = self.differs_at and (' \n| ' .. first_difference(expected, actual)) or ''
    result_table:insert(' \n| ', mw.text.nowiki(text1), ' \n| ',
    	maybe_nowiki(expected), ' \n| ', maybe_nowiki(actual), differs_at,
    	"\n|-\n")
end

function UnitTester:preprocess_equals_preprocess_many(prefix1, suffix1, prefix2, suffix2, cases, options)
    for _, case in ipairs(cases) do
        self:preprocess_equals_preprocess(prefix1 .. case[1] .. suffix1, prefix2 .. (case[2] and case[2] or case[1]) .. suffix2, options)
    end
end

function UnitTester:equals(name, actual, expected, options)
    if actual == expected then
        result_table:insert('| ', tick)
    else
        result_table:insert('| ', cross)
        num_failures = num_failures + 1
    end
    local maybe_nowiki = (options and options.nowiki) and mw.text.nowiki or return_varargs
    local differs_at = self.differs_at and (' \n| ' .. first_difference(expected, actual)) or ''
    local display = options and options.display or function(x) return x end
    result_table:insert(' \n| ', name, ' \n| ',
    	maybe_nowiki(tostring(display(expected))), ' \n| ',
    	maybe_nowiki(tostring(display(actual))), differs_at, "\n|-\n")
end

local function deep_compare(t1, t2, ignore_mt)
    local ty1 = type(t1)
    local ty2 = type(t2)
    if ty1 ~= ty2 then return false end
    if ty1 ~= 'table' and ty2 ~= 'table' then return t1 == t2 end

    local mt = getmetatable(t1)
    if not ignore_mt and mt and mt.__eq then return t1 == t2 end

    for k1, v1 in pairs(t1) do
        local v2 = t2[k1]
        if v2 == nil or not deep_compare(v1, v2) then return false end
    end
    for k2, v2 in pairs(t2) do
        local v1 = t1[k2]
        if v1 == nil or not deep_compare(v1, v2) then return false end
    end

    return true
end

function val_to_str(v)
    if type(v) == 'string' then
        v = mw.ustring.gsub(v, '\n', '\\n')
        if mw.ustring.match(mw.ustring.gsub(v, '[^\'"]', ''), '^"+$') then
            return "'" .. v .. "'"
        end
        return '"' .. mw.ustring.gsub(v, '"', '\\"' ) .. '"'
    else
        return type(v) == 'table' and table_to_str(v) or tostring(v)
    end
end

function table_key_to_str(k)
    if type(k) == 'string' and mw.ustring.match(k, '^[_%a][_%a%d]*$') then
        return k
    else
        return '[' .. val_to_str(k) .. ']'
    end
end

function table_to_str(tbl)
    local result, done = {}, {}
    for k, v in ipairs(tbl) do
        table.insert(result, val_to_str(v))
        done[k] = true
    end
    for k, v in pairs(tbl) do
        if not done[k] then
            table.insert(result, table_key_to_str(k) .. '=' .. val_to_str(v))
        end
    end
    return '{' .. table.concat(result, ',') .. '}'
end

function UnitTester:equals_deep(name, actual, expected, options)
    if deep_compare(actual, expected) then
        result_table:insert('| ', tick)
    else
        result_table:insert('| ', cross)
        num_failures = num_failures + 1
    end
    local maybe_nowiki = (options and options.nowiki) and mw.text.nowiki or return_varargs
    local actual_str = val_to_str(actual)
    local expected_str = val_to_str(expected)
    local differs_at = self.differs_at and (' \n| ' .. first_difference(expected_str, actual_str)) or ''
    result_table:insert(' \n| ', name, ' \n| ', maybe_nowiki(expected_str),
    	' \n| ', maybe_nowiki(actual_str), differs_at, "\n|-\n")
end

function UnitTester:iterate(examples, func)
	require 'libraryUtil'.checkType('iterate', 1, examples, 'table')
	if type(func) == 'string' then
		func = self[func]
	elseif type(func) ~= 'function' then
		error(("bad argument #2 to 'iterate' (expected function or string, got %s)")
			:format(type(func)), 2)
	end
	
	for i, example in ipairs(examples) do
		if type(example) == 'table' then
			func(self, unpack(example))
		elseif type(example) == 'string' then
			self:heading(example)
		else
			error(('bad example #%d (expected table, got %s)')
				:format(i, type(example)), 2)
		end
	end
end

function UnitTester:heading(text)
	result_table:insert_format(' ! colspan="%u" style="text-align: left" | %s \n |- \n ',
		self.columns, text)
end

function UnitTester:run(frame_arg)
    frame = frame_arg
    self.frame = frame
    self.differs_at = frame.args['differs_at']
    tick = frame:preprocess('{{Kur-it}}')
    cross = frame:preprocess('{{Ekis}}')

    local table_header = result_table_header
	self.columns = 4
    if self.differs_at then
        table_header = table_header .. ' !! Aggiddiat iti'
        self.columns = self.columns + 1
    end

    -- Sort results into alphabetical order.
    local self_sorted = {}
    for key,value in pairs(self) do
        if key:find('^test') then
            table.insert(self_sorted, key)
        end
    end
    table.sort(self_sorted)
    -- Add results to the results table.
    for i,value in ipairs(self_sorted) do
        result_table:insert_format(table_header .. "\n|-\n", value)
        self[value](self)
        result_table:insert("|}\n")
    end
	
    return (num_failures == 0 and "<b style=\"color:#008000\">Nakapasa amin a pangsubok.</b>" or "<b style=\"color:#800000\">" .. num_failures .. " ti napaay a pangsubok.</b>") .. "\n\n" .. frame:preprocess(result_table:concat())
end

function UnitTester:new()
    local o = {}
    setmetatable(o, self)
    self.__index = self
    return o
end

local p = UnitTester:new()
function p.run_tests(frame) return p:run(frame) end
return p