La documentazione per questo modulo può essere creata in Modulo:FictionTV/man

--[[
* Modulo a supporto del template FictionTV.
]]--

require('Modulo:No globals')
local getArgs = require('Modulo:Arguments').getArgs
local errorCategory = 'Errori di compilazione del template FictionTV'
local p = {}

-- Parsifica il parametro anno prima visione
local function annoprimavisione(anno)
	local inizio, produzione, fine, err
	
	-- fiction trasmesse in un solo anno, esempio "[[2010]]" (con o senza wikilink)
	if anno:match('^%[?%[?%d%d%d%d%]?%]?$') then
		inizio = anno:match('^%[?%[?(%d%d%d%d)%]?%]?$')
		fine = inizio
	-- fiction trasmesse su più anni, esempio "[[2010]]-[[2015]]" (con o senza wikilink)
	elseif mw.ustring.match(anno, '^%[?%[?%d%d%d%d%]?%]?%s*[–-]%s*%[?%[?%d%d%d%d%]?%]?$') then
		inizio, fine = mw.ustring.match(anno, '^%[?%[?(%d%d%d%d)%]?%]?%s*[–-]%s*%[?%[?(%d%d%d%d)%]?%]?$')
	-- fiction in corso "[[2010]] - in produzione/corso" (con o senza wikilink)
	elseif mw.ustring.match(anno, '^%[?%[?%d%d%d%d%]?%]?%s*[–-]%s*in produzione$') or
		   mw.ustring.match(anno, '^%[?%[?%d%d%d%d%]?%]?%s*[–-]%s*in corso$') then 
		inizio = anno:match('^%[?%[?(%d%d%d%d)%]?%]?')
		produzione = ' – in produzione'
	end

	-- verifica l'anno di debutto sia rilevato e gli anni di inizio e fine siano compresi tra 1900 e 2050
	inizio = tonumber(inizio)
	fine = tonumber(fine)
	if not inizio or inizio <= 1900 or inizio >= 2050 or 
	   (fine and (fine <= 1900 or fine >= 2050)) then
		err = true
	end

	return inizio, produzione, fine, err
end

-- Funzione per {{#invoke:FictionTV|categorie_anno}}
-- Restituisce un formato standard per il parametro anno prima visione e le categorie
function p.categorie_anno(frame)
	local args, inizio, produzione, fine, tipofiction, err, cat, finecat
	local ret = {}

	args = getArgs(frame)

	-- con il parametro nocatperanno restituisce direttamente anno prima visione
	if args.nocatperanno == 'sì' then
		return args['anno prima visione']
	end

	-- anno prima visione e tipo fiction sono obbligatori
	if args['anno prima visione'] and args['tipo fiction'] then
		inizio, produzione, fine, err = annoprimavisione(args['anno prima visione'])
		tipofiction = args['tipo fiction']:lower()
	else
		err = true
	end

	if err then
		cat = errorCategory
	elseif tipofiction == 'webserie' then
		-- per le webserie non sono generate categorie
	elseif tipofiction == 'miniserie tv' then
		cat = 'Miniserie televisive del ' .. inizio
	elseif tipofiction == 'film tv' then
		cat = 'Film per la televisione del ' .. inizio
	elseif tipofiction == 'serie tv' then
		if inizio then
			cat = 'Serie televisive iniziate nel ' .. inizio
		end
		if produzione then
			finecat = 'Serie televisive in produzione'
		elseif fine then
			finecat = 'Serie televisive terminate nel ' .. fine
		end
	elseif tipofiction == 'serial tv' then
		if inizio then
			cat = 'Serial televisivi iniziati nel ' .. inizio
		end
		if produzione then
			finecat = 'Serial televisivi in produzione'
		elseif fine then
			finecat = 'Serial televisivi terminati nel ' .. fine
		end
	end

	if mw.title.getCurrentTitle().namespace == 0 or args.debug then
		if cat then
			table.insert(ret, string.format('[[Categoria:%s]]', cat))
		end
		if finecat then
			table.insert(ret, string.format('[[Categoria:%s]]', finecat))
		end
	end
	if inizio then
		table.insert(ret, string.format('[[%s]]', inizio))
	end
	if fine and fine ~= inizio then
		table.insert(ret, string.format('-[[%s]]', fine))
	end
	if produzione then
		table.insert(ret, produzione)
	end

	return args.debug and table.concat(ret):gsub('%[%[Cat(.-)%]%]', '[[:Cat%1]]<br />') or
		   table.concat(ret)
end

return p