Difference between revisions of "Module:Test"

From RimWorld Wiki
Jump to navigation Jump to search
m (case insensitive getDefName)
m
 
(70 intermediate revisions by the same user not shown)
Line 1: Line 1:
----------------------------------------------
+
DefInfo = {}
-- deal with differences in the environment --
+
local wiki = {}
----------------------------------------------
+
 
 +
local function runTime()
 +
  return string.format("%i", os.clock() * 1000)
 +
end
 +
 
 +
------------------------------------------------------------------
 +
-- deal with differences between MediaWiki and dev environments --
 +
------------------------------------------------------------------
  
 
if mw then
 
if mw then
  ENV = "wiki"
+
 
  INFO = false
 
 
   log = mw.log
 
   log = mw.log
 +
  logObject = mw.logObject
  
   util = require("Module:Test/lib/util")
+
   local timeDataStart = runTime()
   search = require("Module:Test/lib/search")
+
 
 +
  Data  = mw.loadData('Module:Test/data')
 +
 
 +
  local timeDataEnd = runTime()
 +
  log(string.format('@%ims, data loaded in %ims', timeDataEnd, timeDataEnd - timeDataStart))
 +
 
 +
  Util  = require("Module:Test/lib/util")
 +
   Search = require("Module:Test/lib/search")
 +
  VF    = require("Module:Test/data/virtual")
 +
 
 +
  log(string.format('@%ims, modules loaded', runTime()))
  
  function pinspect() end
 
 
else
 
else
  ENV = "dev"
 
  INFO = true
 
 
  mw = {}
 
  log = {}
 
  
   inspect = require './lib/inspect'
+
   logDevStore = {}
  util = require("./lib/util")
 
  search = require("./lib/search")
 
  
   function pinspect(tbl, title)
+
   log = function(str)
     if INFO then
+
     table.insert(logDevStore, str)
      util.hl(title)
 
      print(inspect(tbl))
 
    end
 
 
   end
 
   end
  
   -- define used mw functions that don't exist
+
   logObject = function(obj, prefix)
  mw.logObject = function(obj, prefix)
 
 
     if prefix then
 
     if prefix then
 
       assert(type(prefix) == "string")
 
       assert(type(prefix) == "string")
       table.insert(log, prefix .. " = " .. inspect(obj))
+
       table.insert(logDevStore, prefix .. " = " .. Inspect(obj))
 
     else
 
     else
       table.insert(log, inspect(obj))
+
       table.insert(logDevStore, Inspect(obj))
 
     end
 
     end
 
   end
 
   end
  
   mw.dumpObject = function(arg)
+
   function pp(tbl, title) -- pretty print tables
     return inspect(arg)
+
    Util.hl(title)
 +
     print(Inspect(tbl))
 
   end
 
   end
  
   mw.log = function(arg)
+
   local timeDataStart = runTime()
    table.insert(log, arg)
 
  end
 
end
 
  
---------------
+
  Data    = require "data/data"
-- load data --
 
---------------
 
  
data = {}
+
  local timeDataEnd = runTime()
 +
  log(string.format('@%ims, data loaded in %ims', timeDataEnd, timeDataEnd - timeDataStart))
  
if ENV == "dev" then
+
  Util    = require "lib/util"
   data["Biomes"] = loadfile("./data/BiomeDefs.lua")()
+
   Search  = require "lib/search"
   data["Races"] = loadfile("./data/ThingDefs_Races.lua")()
+
   Inspect = require "lib/inspect"
elseif ENV == "wiki" then
+
  VF      = require "data/virtual"
  data["Biomes"] = mw.loadData('Module:Test/data/biomes')
 
  data["Races"] = mw.loadData('Module:Test/data/races')
 
end
 
  
------------------
+
  log(string.format('@%ims, modules loaded', runTime()))
-- virtual keys --
 
------------------
 
  
-- this could be implemented with metatable events
+
end
-- they get added in get(id_pair)
 
 
 
local virtual_keys = {
 
  ["Races"] = {
 
    ["lives_in"] = function (race, biomes)
 
      local list = {}
 
      for biome_key, biome in pairs(biomes) do
 
        for _,animal in ipairs(biome.wildAnimals) do
 
          if race.defName == animal then
 
            table.insert(list, biome_key)
 
          end
 
        end
 
      end
 
      return list
 
    end
 
  }
 
}
 
 
 
-------------
 
-- private --
 
-------------
 
  
local function vardefine(name, value)
+
-----------------------
  local f_name = "vardefine"
+
-- private functions --
  assert(var_name, string.format("bad argument #1 to '%s' (argument missing, name of variable to define)", f_name))
+
-----------------------
  assert(var_name == "string", string.format("bad argument #1 to '%s' (string expected, got %s)", f_name, type(var_name)))
 
  assert(var_value, string.format("bad argument #2 to '%s' (argument missing, value to assign to variable)", f_name))
 
  assert(var_value == "string" or var_value == "number", string.format("bad argument #2 to '%s' (string or number expected, got %s)", f_name, type(var_value)))
 
  
   frame:callParserFunction('#vardefine', var_name, var_value)
+
function DefInfo.vardefine(name, value, frame)
 +
  assert(name, "vardefine: missing argument #1 (variable to definePrefix)")
 +
  assert(type(name) == "string", string.format("vardefine: bad argument #1 (string expected, got %s)", type(name)))
 +
  assert(value, "vardefine: missing argument #2 (value to assign)")
 +
  assert(type(value) == "string" or type(value) == "number" or type(value) =="boolean", string.format("vardefine: bad argument #2 (string, number or boolean expected, got %s)", type(value)))
 +
  assert(frame, "vardefine: 'frame' missing")
 +
   frame:callParserFunction('#vardefine', name, value)
 
end
 
end
  
 
+
function DefInfo.expandDef(def, runMe)
local function search_parent_def_table(key, def_table)
+
   if not runMe then return nil end
  local ParentName = getParentName(def_table)
+
   local vFuncs = VF
   if not ParentName then return nil end
+
  for fName,func in pairs(vFuncs) do
   local parentdef_table = search_table_recursive(ParentName, data)
+
    if func(def) then
  if not parentdef_table then return nil end
+
      log(string.format('@%ims, expandDef: %s expanded with %s', runTime(), def.defName, fName))
 
+
     end
  local found = search_table_recursive(key, parentdef_table)
 
  if found then return found
 
  else
 
    found = search_parent_def_table(key, parentdef_table)
 
     if found then return found end
 
 
   end
 
   end
 
end
 
end
  
 +
function DefInfo.mergeParents(baseDef, ignoreKeys)
 +
  local ancestorIDs = {}
 +
  local mergedDef = {}
 +
  local def = baseDef
  
local function merge_def(base_def_table, def_category, ignore_keys)
+
   while def._.ParentName do
 
+
    local parentID = def._.DefCategory .. ":" .. def._.ParentName
   local ancestors = {}
+
     table.insert(ancestorIDs, parentID)
  local parent_name = base_def_table["ParentName"]
+
     def = Data[parentID]
  local parent_table = data[def_category][parent_name]
 
 
 
  while parent_name do
 
     table.insert(ancestors, parent_name)
 
     parent_name = parent_table["ParentName"]
 
    parent_table = data[def_category][parent_name]
 
 
   end
 
   end
  
   local inheritance_chain = util.shallowcopy(util.reverse_numeric_table(ancestors))
+
   ancestorIDs = Util.table.reverse(ancestorIDs)
   table.insert(inheritance_chain, base_def_table.defName)
+
   table.insert(ancestorIDs, baseDef._.DefCategory .. ":" .. baseDef.defName)
  
  local merged = {}
+
   for _,parentID in ipairs(ancestorIDs) do
   for i,v in ipairs(inheritance_chain) do
+
     Util.table.overwrite(mergedDef, Data[parentID], ignoreKeys)
     util.overwrite_first_table_with_second(merged, data[def_category][inheritance_chain[i]], ignore_keys)
 
 
   end
 
   end
  
   return merged
+
   return mergedDef
 
end
 
end
  
 +
function DefInfo.getDef(defID, expandVF)
 +
  if expandVF ~= false then expandVF = true end
 +
 +
  local ignoreKeys = {"Abstract", "Name", "ParentName"}
 +
  local baseDef
 +
  local def
  
function get_def(defName)
+
   if not defID then return nil end
   local base_def_table
 
  local def_category
 
  
   for catK,_ in pairs(data) do
+
   for _,def in pairs(Data) do
    for defK,def in pairs(data[catK]) do
+
    if def.defName == defID then
      if defK == defName then
+
      baseDef = def
        base_def_table = def
+
      break
        def_category = catK
+
    elseif string.upper(def.label or '') == string.upper(defID) then
       end
+
      baseDef = def
 +
       break
 
     end
 
     end
 
   end
 
   end
  
   if not base_def_table then return nil end
+
   if not baseDef then return nil end
  
   local def = merge_def(base_def_table, def_category, {"ParentName", "Abstract"})
+
   def = DefInfo.mergeParents(baseDef, ignoreKeys)
  
   -- add virtual keys
+
   DefInfo.expandDef(def, expandVF)
  if virtual_keys[def_category] then
 
    def._virtual = {}
 
    for k,func in pairs(virtual_keys[def_category]) do
 
      def._virtual[k] = func(def, data.Biomes)
 
    end
 
  end
 
  
--~  mw.logObject(def, "def")
 
 
   return def
 
   return def
 
end
 
end
  
------------
+
local function setPrefix(tbl, parentKey)
-- public --
+
  local mt = getmetatable(tbl) or {}
------------
 
  
local p = {}
+
  for k,v in pairs(tbl) do
 +
    local prefix = parentKey .. "_" .. k
 +
    if type(v) == 'table' then
 +
      setPrefix(v, prefix)
 +
    else
 +
      mt[k] = prefix
 +
    end
 +
  end
  
 +
  setmetatable(tbl, mt)
 +
end
  
-- will check frame.args[1] for the label
+
local function definePrefixed(tbl, frame)
function p.getDefName(frame)
+
   for k,v in pairs(tbl) do
  local defName
+
     if type(v) ~= 'table' then
   for catK,_ in pairs(data) do
+
       local mt = getmetatable(tbl)
     for defK,def in pairs(data[catK]) do
+
      log(string.format('%s = %s', mt[k], tostring(v)))
       if def["label"] then
+
      if mw then DefInfo.vardefine(mt[k], v, frame) end
        if string.upper(def["label"]) == string.upper(frame.args[1]) then defName = defK end
+
    else
       end
+
       definePrefixed(v, frame)
 
     end
 
     end
 
   end
 
   end
 +
end
  
  if not defName then
+
----------------------
    mw.logObject(frame.args, "frame.args")
+
-- public interface --
     mw.log(string.format("'%s' not found", frame.args[1]))
+
----------------------
 +
 
 +
function wiki.count(frame)
 +
  local query = wiki.query(frame)
 +
  if type(wiki.queried) == 'table' then -- WARNING: checks a variable that is set in wiki.query (ugly)
 +
     return Util.table.count(wiki.queried)
 
   end
 
   end
 
  return defName
 
 
end
 
end
  
-- one function to rule them all, and in the darkness bind them
+
function wiki.query(frame)
function p.query(frame)
 
  
   -- implement shitloads of checks for arguments and the log so we know what's going on
+
   local argLen = Util.table.count(frame.args, "number") -- #frame.args won't work as expected, check the doc
  -- use them as a kind of usage guide
 
  
   if not frame.args[1] then
+
   if not frame.args['defName'] and not frame.args['label'] then
     mw.logObject(frame.args, "frame.args")
+
     logObject(frame.args, string.format('query @ %ims: missing an identifying argument (defName or label)\nframe.args', runTime()))
    mw.log("missing argument #1 (defName)")
 
 
     return nil
 
     return nil
 
   end
 
   end
  
   local def = get_def(frame.args[1])
+
   local def = DefInfo.getDef(frame.args['defName']) or DefInfo.getDef(frame.args['label'])
  
 
   if not def then
 
   if not def then
     mw.logObject(frame.args, "frame.args")
+
     logObject(frame.args, string.format("query @ %ims: Def not found\nframe.args", runTime()))
    mw.log(string.format("bad argument #1 ('%s' not found)", frame.args[1]))
 
 
     return nil
 
     return nil
 
   end
 
   end
  
   local prune = def
+
   if def and argLen == 0 then
 +
    logObject(def, string.format("['%s:%s'] @ %ims", def._.DefCategory, def.defName, runTime()))
 +
    return nil
 +
  end
  
   local arg_count = #frame.args
+
   local processedDef = def
  
  -- look at all the beautiful ifs!
+
   for i,arg in ipairs(frame.args) do -- arguments
   for i,arg in ipairs(frame.args) do
+
    arg = tonumber(arg) or arg -- frame.args are always strings on MediaWiki so convert back the numbers
  
    -- do stuff for additional arguments
+
     if i == argLen and frame.args["sibling"] then
     if i > 1 then
+
      processedDef = Search.find({nil, frame.args["sibling"]} , processedDef)
 
+
      if not processedDef then
      -- special checks for the final argument
+
        logObject(frame.args, string.format("query @ %ims: bad argument 'sibling' ('%s' not found')\nframe.args", runTime(), frame.args["sibling"]))
      if i == arg_count then
+
        return nil
 
+
      else
        -- sibling_value
+
        processedDef = Search.meta.parent.table[arg]
        if frame.args["sibling_value"] then
+
        if not processedDef then
          prune = search.conductor({nil, frame.args["sibling_value"]} , prune)
+
          logObject(frame.args, string.format("query @ %ims: bad argument #%i ('%s' is not a sibling of '%s')", runTime(), i, arg, frame.args["sibling"]))
          if not prune then
+
           return nil
            mw.log(string.format("bad argument 'sibling_value' ('%s' not found in '%s')", frame.args["sibling_value"], frame.args[i-1]))
 
            return nil
 
          else
 
            prune = prune.parent.table[arg]
 
            if not prune then
 
              mw.log(string.format("bad argument #%i ('%s' is not a sibling of '%s')", i, arg, frame.args["sibling_value"]))
 
            end
 
          end
 
        else
 
          prune = search.conductor(arg, prune)
 
           if not prune then
 
            mw.log(string.format("bad argument #%i ('%s' not found in '%s')", i, frame.args[i], frame.args[i-1]))
 
            return nil
 
          else
 
            prune = prune.value
 
          end
 
 
         end
 
         end
 +
      end
 +
    end
  
 +
    if i < argLen or i == argLen and not frame.args["sibling"] then
 +
      processedDef = Search.find(arg, processedDef)
 +
      if not processedDef then
 +
        logObject(frame.args, string.format("query @ %ims: bad argument #%i ('%s' not found)\nframe.args", runTime(), i, frame.args[i]))
 +
        return nil
 
       else
 
       else
         prune = search.conductor(arg, prune)
+
         if type(processedDef) ~= 'table' and i < argLen then
        if not prune then
+
           log(string.format("query @ %ims: warning Def ['%s'] argument #%i ('%s' returns a value, all extra arguments ignored)", runTime(), def['label'], i, frame.args[i]))
           mw.log(string.format("bad argument #%i ('%s' not found in '%s')", i, frame.args[i], frame.args[i-1]))
+
           return processedDef
           return nil
 
        else
 
          prune = prune.value
 
 
         end
 
         end
 
       end
 
       end
 +
    end
  
    end
+
  end -- for arguments
  
 +
  if type(processedDef) == "table" then
 +
    log(string.format("@%ims, query: table vardefined", runTime()))
 +
    setPrefix(processedDef, frame.args[argLen])
 +
    definePrefixed(processedDef, frame)
 +
    wiki.queried = processedDef -- WARNING: sets a variable that is used in another function wiki.count (ugly)
 +
    return nil
 
   end
 
   end
  
   if type(prune) == "table" then mw.logObject(prune) end
+
   log(string.format("@%ims, query: %s printed", runTime(), type(processedDef)))
  return prune
+
   return processedDef
end
 
 
 
function p.logObject(frame)
 
   mw.logObject(get(frame))
 
 
end
 
end
  
function p.dumpObject(frame)
+
------------------------------------
  return mw.dumpObject(get(frame))
+
-- simulate MediaWiki environment --
end
+
------------------------------------
  
-------------------------------------------------------------------
+
if not mw then
-- simulate MediaWiki/Scribunto module invocation using 'frame'  --
+
  local simframe = { ["args"] = {} }
-------------------------------------------------------------------
+
  simframe.args['label'] = 'ancient cryptosleep casket'
 
+
--~  simframe.args[1] = 'verbs'
local simframe = { ["args"] = {} }
+
--~  simframe.args[2] = 'label'
 
+
   wiki.query(simframe)
simframe.args[1] = "feNNec FoX"
 
simframe.args[2] = "minAge"
 
simframe.args["sibling_value"] = "AnimalJuvenilee"
 
 
 
frame = frame or simframe
 
 
 
-- frame.args are always strings on MediaWiki so convert them back to numbers
 
for k,arg in pairs(frame.args) do
 
   frame.args[k] = tonumber(arg) or arg
 
 
end
 
end
  
if ENV == "dev" then
+
if not mw then
   print(p.query(frame))
+
  Util.hl("DefInfo log")
 +
   for _,v in ipairs(logDevStore) do
 +
    print(v)
 +
  end
 
end
 
end
  
----------------------------------------
+
------------
-- simulate wiki log while developing --
+
-- return --
----------------------------------------
+
------------
 
 
local clock = string.format("os.clock(): %i ms", os.clock() * 1000)
 
mw.log("--" .. string.rep("-", #clock) .. "--")
 
mw.log("- " .. clock .. " -")
 
mw.log("--" .. string.rep("-", #clock) .. "--")
 
 
 
if ENV == "dev" then
 
  util.hl("log")
 
  for _,v in ipairs(log) do
 
    print(v)
 
  end
 
  
 +
if mw then
 +
  return wiki
 +
else
 +
  return DefInfo
 
end
 
end
 
return p
 

Latest revision as of 09:56, 18 May 2021

This module is used for development.

Purpose

This module is used to query information from the uploaded and parsed game files.

Its main purpose is to populate the infoboxes.

Usage

A note on the order of named parameters. All of the parameters that look like ...=... are called named parameters and their order is not important (this is true for all templates).

query

{{#invoke:Test|query|<def ID>[|...|][|tag|][|sibling=...]}}

The work-horse. Output varies based on use:

If only the <def ID> parameter is set, it will show the whole Def in the log.
If simple values are queried it will return them.
If lists are queried it will return nothing but call {{#vardefine}} on all the simple values within it. What got defined can be seen in the page's log.

Named parameters:

<def ID>
This parameter identifies the Def so it is mandatory. It can take two forms, if both are defined then defName takes preference.
defName=<defName>
<defName> (case sensitive) should be replaced with the actual defName of a Def.
label=<label>
<label> (case insensitive) should be replaced with the actual label of a Def.
[sibling=...] (optional) (case sensitive)
Allows querying for something if we know its sibling's value (works only for values at the moment).

Anonymous parameters:

[|...|] (optional) (case sensitive)
Anonymous paramaters before the last one ([tag]) are here to help uniquely identify it. If the [tag] is already unique within a Def tree, then these additional parameters are not needed.
[|tag|] (optional) (case sensitive)
The final anonymous parameter defines what is to be queried.

count

{{#invoke:Test|count|<def ID>[|...|][|tag|][|sibling=...]}}

Parameters are the same as for query. It's basically a wrapped up query that behaves a bit differently.

The difference is in how it handles lists. If a list is queried, unlike query, it will return the length of the list.

How-to

Take a look at a Def

{{#invoke:Test|query|label=desert}}

Data is in the log.

Retrieve a simple value

{{#invoke:Test|query|defName=Caribou|description}}

A large member of the deer family, well-adapted to life in cold climates. Caribou can be milked, but refuse to carry packs.

Dealing with lists

{{#invoke:Test|query|defName=Mech_Scyther|tools}}

When a list is retrieved there will be no output but the log will contain a list of defined variables.

For convenience the list is reprinted here:

tools_1_linkedBodyPartsGroup = LeftBlade
tools_1_cooldownTime = 2
tools_1_label = left blade
tools_1_DPS = 10
tools_1_power = 20
tools_1_capacities_1 = Cut
tools_1_capacities_2 = Stab
tools_2_linkedBodyPartsGroup = RightBlade
tools_2_cooldownTime = 2
tools_2_label = right blade
tools_2_DPS = 10
tools_2_power = 20
tools_2_capacities_1 = Cut
tools_2_capacities_2 = Stab
tools_3_linkedBodyPartsGroup = HeadAttackTool
tools_3_capacities_1 = Blunt
tools_3_label = head
tools_3_DPS = 4.5
tools_3_chanceFactor = 0.2
tools_3_power = 9
tools_3_cooldownTime = 2

All of the above can be accessed with the use of {{#var:...}}.

{{#var:tools_1_DPS}}

10

DPS is not a normal member of this table but has been added with Lua. Let's call it a virtual field.

Retrieve something if a sibling is known

{{#invoke:Test|query|label=guinea pig|minAge|sibling=AnimalAdult}}

0.3


DefInfo = {}
local wiki = {}

local function runTime()
  return string.format("%i", os.clock() * 1000)
end

------------------------------------------------------------------
-- deal with differences between MediaWiki and dev environments --
------------------------------------------------------------------

if mw then

  log = mw.log
  logObject = mw.logObject

  local timeDataStart = runTime()
  
  Data   = mw.loadData('Module:Test/data')

  local timeDataEnd = runTime()
  log(string.format('@%ims, data loaded in %ims', timeDataEnd, timeDataEnd - timeDataStart))

  Util   = require("Module:Test/lib/util")
  Search = require("Module:Test/lib/search")
  VF     = require("Module:Test/data/virtual")

  log(string.format('@%ims, modules loaded', runTime()))

else

  logDevStore = {}

  log = function(str)
    table.insert(logDevStore, str)
  end

  logObject = function(obj, prefix)
    if prefix then
      assert(type(prefix) == "string")
      table.insert(logDevStore, prefix .. " = " .. Inspect(obj))
    else
      table.insert(logDevStore, Inspect(obj))
    end
  end

  function pp(tbl, title) -- pretty print tables
    Util.hl(title)
    print(Inspect(tbl))
  end

  local timeDataStart = runTime()

  Data    = require "data/data"

  local timeDataEnd = runTime()
  log(string.format('@%ims, data loaded in %ims', timeDataEnd, timeDataEnd - timeDataStart))

  Util    = require "lib/util"
  Search  = require "lib/search"
  Inspect = require "lib/inspect"
  VF      = require "data/virtual"

  log(string.format('@%ims, modules loaded', runTime()))

end

-----------------------
-- private functions --
-----------------------

function DefInfo.vardefine(name, value, frame)
  assert(name, "vardefine: missing argument #1 (variable to definePrefix)")
  assert(type(name) == "string", string.format("vardefine: bad argument #1 (string expected, got %s)", type(name)))
  assert(value, "vardefine: missing argument #2 (value to assign)")
  assert(type(value) == "string" or type(value) == "number" or type(value) =="boolean", string.format("vardefine: bad argument #2 (string, number or boolean expected, got %s)", type(value)))
  assert(frame, "vardefine: 'frame' missing")
  frame:callParserFunction('#vardefine', name, value)
end

function DefInfo.expandDef(def, runMe)
  if not runMe then return nil end
  local vFuncs = VF
  for fName,func in pairs(vFuncs) do
    if func(def) then
      log(string.format('@%ims, expandDef: %s expanded with %s', runTime(), def.defName, fName))
    end
  end
end

function DefInfo.mergeParents(baseDef, ignoreKeys)
  local ancestorIDs = {}
  local mergedDef = {}
  local def = baseDef

  while def._.ParentName do
    local parentID = def._.DefCategory .. ":" .. def._.ParentName
    table.insert(ancestorIDs, parentID)
    def = Data[parentID]
  end

  ancestorIDs = Util.table.reverse(ancestorIDs)
  table.insert(ancestorIDs, baseDef._.DefCategory .. ":" .. baseDef.defName)

  for _,parentID in ipairs(ancestorIDs) do
    Util.table.overwrite(mergedDef, Data[parentID], ignoreKeys)
  end

  return mergedDef
end

function DefInfo.getDef(defID, expandVF)
  if expandVF ~= false then expandVF = true end

  local ignoreKeys = {"Abstract", "Name", "ParentName"}
  local baseDef
  local def

  if not defID then return nil end

  for _,def in pairs(Data) do
    if def.defName == defID then
      baseDef = def
      break
    elseif string.upper(def.label or '') == string.upper(defID) then
      baseDef = def
      break
    end
  end

  if not baseDef then return nil end

  def = DefInfo.mergeParents(baseDef, ignoreKeys)

  DefInfo.expandDef(def, expandVF)

  return def
end

local function setPrefix(tbl, parentKey)
  local mt = getmetatable(tbl) or {}

  for k,v in pairs(tbl) do
    local prefix = parentKey .. "_" .. k
    if type(v) == 'table' then
      setPrefix(v, prefix)
    else
      mt[k] = prefix
    end
  end

  setmetatable(tbl, mt)
end

local function definePrefixed(tbl, frame)
  for k,v in pairs(tbl) do
    if type(v) ~= 'table' then
      local mt = getmetatable(tbl)
      log(string.format('%s = %s', mt[k], tostring(v)))
      if mw then DefInfo.vardefine(mt[k], v, frame) end
    else
      definePrefixed(v, frame)
    end
  end
end

----------------------
-- public interface --
----------------------

function wiki.count(frame)
  local query = wiki.query(frame)
  if type(wiki.queried) == 'table' then -- WARNING: checks a variable that is set in wiki.query (ugly)
    return Util.table.count(wiki.queried)
  end
end

function wiki.query(frame)

  local argLen = Util.table.count(frame.args, "number") -- #frame.args won't work as expected, check the doc

  if not frame.args['defName'] and not frame.args['label'] then
    logObject(frame.args, string.format('query @ %ims: missing an identifying argument (defName or label)\nframe.args', runTime()))
    return nil
  end

  local def = DefInfo.getDef(frame.args['defName']) or DefInfo.getDef(frame.args['label'])

  if not def then
    logObject(frame.args, string.format("query @ %ims: Def not found\nframe.args", runTime()))
    return nil
  end

  if def and argLen == 0 then
    logObject(def, string.format("['%s:%s'] @ %ims", def._.DefCategory, def.defName, runTime()))
    return nil
  end

  local processedDef = def

  for i,arg in ipairs(frame.args) do -- arguments
    arg = tonumber(arg) or arg -- frame.args are always strings on MediaWiki so convert back the numbers

    if i == argLen and frame.args["sibling"] then
      processedDef = Search.find({nil, frame.args["sibling"]} , processedDef)
      if not processedDef then
        logObject(frame.args, string.format("query @ %ims: bad argument 'sibling' ('%s' not found')\nframe.args", runTime(), frame.args["sibling"]))
        return nil
      else
        processedDef = Search.meta.parent.table[arg]
        if not processedDef then
          logObject(frame.args, string.format("query @ %ims: bad argument #%i ('%s' is not a sibling of '%s')", runTime(), i, arg, frame.args["sibling"]))
          return nil
        end
      end
    end

    if i < argLen or i == argLen and not frame.args["sibling"] then
      processedDef = Search.find(arg, processedDef)
      if not processedDef then
        logObject(frame.args, string.format("query @ %ims: bad argument #%i ('%s' not found)\nframe.args", runTime(), i, frame.args[i]))
        return nil
      else
        if type(processedDef) ~= 'table' and i < argLen then
          log(string.format("query @ %ims: warning Def ['%s'] argument #%i ('%s' returns a value, all extra arguments ignored)", runTime(), def['label'], i, frame.args[i]))
          return processedDef
        end
      end
    end

  end -- for arguments

  if type(processedDef) == "table" then
    log(string.format("@%ims, query: table vardefined", runTime()))
    setPrefix(processedDef, frame.args[argLen])
    definePrefixed(processedDef, frame)
    wiki.queried = processedDef -- WARNING: sets a variable that is used in another function wiki.count (ugly)
    return nil
  end

  log(string.format("@%ims, query: %s printed", runTime(), type(processedDef)))
  return processedDef
end

------------------------------------
-- simulate MediaWiki environment --
------------------------------------

if not mw then
  local simframe = { ["args"] = {} }
  simframe.args['label'] = 'ancient cryptosleep casket'
--~   simframe.args[1] = 'verbs'
--~   simframe.args[2] = 'label'
  wiki.query(simframe)
end

if not mw then
  Util.hl("DefInfo log")
  for _,v in ipairs(logDevStore) do
    print(v)
  end
end

------------
-- return --
------------

if mw then
  return wiki
else
  return DefInfo
end