Module:Outils

local Outil = { }

-- trim nettoie un paramètre non nommé (supprime les espaces et retours ligne au début et à la fin) -- retourne nil si le texte est vide ou n'est pas du texte. Les nombres ne sont PAS considérés comme du texte. function Outil.trim( texte )

   if type( texte ) == "string" and texte ~= "" then
       return mw.text.trim( texte )
   end

end

-- validArg renvoit le premier paramètre chaine non vide -- Paramètre : -- 1 - tableau contenant tous paramètres -- 2, ... - les noms des paramètres qui doivent êtres testés. function Outil.validTextArg( args, name, ... )

   local texte = Outil.trim( args[name] )
   if texte then
       return texte
   end
   if select( '#', ... ) > 0 then
       return Outil.validTextArg( args, ... )
   end

end

-- validArg renvoie le premier paramètre non vide ou nul. -- Paramètre : -- 1 - tableau contenant tous paramètres -- 2, ... - les noms des paramètres qui doivent êtres testés. function Outil.validArg( args, name, ... )

   local arg = args[name]
   local targ = type( arg )
   if targ == "string" and arg ~= "" then
       return mw.text.trim( arg )
   end
   if targ == 'number' and arg ~= 0
       or targ == 'table' and #arg > 0
       or arg == true
   then
       return arg
   end
   if select( '#', ... ) > 0 then
       return Outil.validArg( args, ... )
   end

end

-- extractArgs permet de récupérer les arguements du modèle, -- ou la table transmise à la fonction par une autre fonction d'un module -- Paramètres : -- 1 - un objet frame ou une table contenant les paramètre -- 2, ... - une liste de nom de paramètre pour déterminé si les paramètres sont transmis par #invoke: -- le premier paramètre sera systématiquement testé. function Outil.extractArgs ( frame, ... )

   if type( frame ) == 'table' then
       if type( frame.getParent ) == 'function' then
           if Outil.validArg( frame.args, 1, ...) then
               return frame.args
           else
               return frame.getParent()
           end
       else
           return frame 
       end
   else
       return { frame }
   end

end

-- fonction abréviation discrète, abréviation (discrète par défaut) -- paramètres : 1 = abréviation, 2 = texte, 3 = langue, visible = abréviation simple function Outil.abr( frame )

   local args = extractArgs( frame )
   if args[2] == nil then 
       return args[1] or                  -- retoune l'abréviation ou au minimum une chaine vide s'il n'y a pas de texte
   end

   local wikiText = { '<abbr' }
   if not args.visible then
       table.insert( wikiText, ' class="abbr"' )
   end
   table.insert( wikiText, ' title="' )
   table.insert( wikiText, args[2] )
   if args[3] then 
       table.insert( wikiText, '" lang="' )
       table.insert( wikiText, args[3] )
   end
   table.insert( wikiText, '">' )
   table.insert( wikiText, args[1] )
   table.insert( wikiText, '' )

   return table.concat( wikiText )

end

return Outil