Module:SimpleDebug/doc

Contains a functions to help debug the lua modules. It allows to collect and view the values of several variables and/or points in your lua program, from a module (which is usual) or in several modules (which are required from the main module).

It is designed so that its functions are called from within the module that is to be debugged, calls that will have to be part of the code (of the module that you have designed, or that you want to improve or adapt) until you decide to delete them (when you already have determined the bug). Thus, you do not have to call any of its functions from an invoke.

Uses class wikitable colspan 3 One or several points to watch colspan 3 Function abbreviations code w code where. code n code names. V code variables code> string Variables Name Default code tab oneline code true If it is or it is true and contains nested tables, it will show a line for each item in the table and with an indent for each nested table

If it is true and it does not contain nested tables it shows the table in a line.

|-

| tab.allidx || false || If it is true then also displays the numerical indexes of a table. |- | dec || -1 || Spaces for the decimals:

• -1: It displays all required decimals.
• 0: No decimals.
• n: 1: one decimal, 2: two decimals, etc.

|- |enabled || true || If it is false all calls to the below functions do nothing. |- |nohtml || false || In strings, it replaces < for ⪡ and > for ⪢. |- |plaintext || false || Deletes html format. |- ! colspan="3" |One point to watch |- | colspan="2" |Functions |- | colspan="2" |w (where) ||

• where: point label.

|- | colspan="2" |v (...) ||

• ...: a number of variables = var1, var2...

|- | colspan="2" |wv (where, ...) ||

• where: point label.
• ...: a number of variables = var1, var2...

|- | colspan="2" |nv (...) ||

• ...: a number of pairs of name-variable = name1, var1, name2, var2....

|- | colspan="2" |wnv (where, ...) ||

• where: point label.
• ...: a number of pairs of name-variable = name1, var1, name2, var2....

|- ! colspan="3" |Several points to watch |- | colspan="3" |Variables |- | Name||Default|| |- | s || || The string variable that holds the returned values from the next functions. |- | maxlines.num || 100 || The maxim number of lines (on calling the next functions). |- | maxlines.doerror || true || If it is true and maxlines.num is reached, error(s) is called. |- |counter || false || Adds an autoincremental number at the beginning of each call of a function. |- | colspan="3" |Functions |- | colspan="2" |breakline () || Adds a break line in s. |- | colspan="2" |wtos (where) || Equal to w, but the return string is stored in s. |- | colspan="2" |vtos (...) || Equal to v, but the return string is stored in s. |- | colspan="2" |wvtos (where, ...) || Equal to wv, but the return string is stored in s. |- | colspan="2" |nvtos (...) || Equal to nv, but the return string is stored in s. |- | colspan="2" |wnvtos (where, ...) || Igual a wnv, but the return string is stored in s. |}

Examples

One point to watch Following the flow syntaxhighlight lang Lua local SD require Module SimpleDebug return SD.v Here is reached syntaxhighlight returns Here is reached Number of decimal places and value of a variable syntaxhighlight lang Lua local SD require Module SimpleDebug" SD.dec 2 return SD.v 1/3 syntaxhighlight return No html syntaxhighlight lang Lua local SD require Module Simple Debug SD no html true return SD v bbold b syntaxhighlight return Plaintext lang Lua local SD require Module Simple Debug SD.plaintext true return SDv bold b syntaxhighlight return The value of several variables syntaxhighlight lang Lua local SD require Module SimpleDebug" local a 12 local b Hello return SD v a bsyntaxhighlight return 12 Hello

Non-assigned variable detection syntaxhighlight lang Lua local SD  require Module Simple Debug

local a true return SD v a b syntaxhighlight returns true The value of a tablesyntaxhighlight lang Lua local SD require Module Simple Debug local a 1 tab a b return SD v a syntax highlight returns 1 b tab a syntaxhighlight lang Lua local SD require Module SimpleDebug local a 1 2 3 4 5 6 7 8 9 return SD v syntaxhighlight returns 1 2 3 2 4 5 6 3 7 8 9 syntaxhighlight lang Lua local SD require Module SimpleDebug" local a First 1 2 3 4 Second 5 6 7 8 9 return SD.v (a) syntaxhighlight returns 1 2 3 First 1 2 4 6 Second 5 3 7 8 9 syntaxhighlight lang Lua local SD require Module SimpleDebug SD.tab allidx true local a 1 2 3 4 6 7 8 9 return SD v a Ssyntaxhighligh 1 2 2 3 2 1 4 3 6 3 1 7 2 8 3 9 Usually you implement these functions with error function syntaxhighlight lang local SD require Modul Simple Debug local a 1 2 3 4 5 6 7 8 9 error SD v a syntaxhighlight displays color red Lua errorModule Your Module Line div style color red;font family monospace monospace b   &nbsp 1 1 2 3 b   &nbsp 2 4 5 6 br &nbsp &nbsp 3 78 9 br nbsp b div All values of a table in multiline

returns

a 12  b Hello

===Several points to watch===
==== Following the flow ====
<syntaxhighlight lang="lua">
local SD = require "Module:SimpleDebug" 
local tab = {1,12,7}
function p.CheckValues ()
  local function LittleNum()
    SD.wtos ('little number')
  end
  local function BigNum(num)
    SD.wtos ('big='..num)
  end
  for i, num in ipairs(tab) do
    if num > 9 then
      BigNum(num)
    else
      LittleNum()
    end  
  end  
  error (SD.s)
end

returns:

Lua Error:Module:Your module:Line:

little number

big=12

little number.

With counter

local SD = require "Module:SimpleDebug" 
function Increm()
  local n = 0
  for i = 1, 3 do
    n = n + 2
    SD.vtos (n)
  end
end
SD.counter = true
Increm()
return SD.s

returns:

1  •  2

2  •  4

3  •  6

Monitoring of several variables

local SD = require "Module:SimpleDebug"
a = 12
b = 'Hello'
SD.vtos (1,a,b)
a = a + a
b = b..' world!'
SD.vtos ('Finally',a,b)
return SD.s

returns:

1 => 12  •  "Hello"

Finally => 24  •  "Hello world!"

local SD = require "Module:SimpleDebug"
SD.breakline ()
a = 12
b = 'Hello'
c = false
SD.nvtos (1,'a',a,'b',b,'c',c)
a = a + a
b = b..' world!'
SD.nvtos ('Finally','a',a,'b',b)
error (SD.s)

displays:

Lua error:Module:YourModule:Line:

1 => a: 12  •  b: "Hello"  •  c: false

Finally => a: 24  •  b: "Hello world!"

Variables and their presentation with conditions

local SD = require "Module:SimpleDebug"
SD.breakline()
SD.enabled = false
SD.maxlines.num = 3
local a = 'AA'
for i = 1, 10 do
  a = a + 'AA'
  if i == 3 then
    SD.enabled = true
  end
  SD.nvtos (i, string.len(a), a)
end

displays:

Lua error:Module:YourModule:Line:

3 => 8  •  "AAAAAAAA"

4 => 10  •  "AAAAAAAAAA"

5 => 12  •  "AAAAAAAAAAAA".