-- Private ----------------------------------------------------------------------------------------- local private = {} --[[ Creates a diagnostic string from a given object. This function recursively explores tables trying to show as much detail as possible within the limits dictated by its arguments. For anything other than a table, it simply uses the results of calling `tostring` with the object in question. The output is pretty printed for ease of reading using a new line for each key/value pair, and indenting successive layers by four spaces. Args: value:any - the value to be dumped depth:int - the maximum layers of nested tables to explore (10 by default) indent:string - the initial indent to use at the first layer max_keys:int - the maximum number of keys to print for a single table (100 by default) seen:table[any,true] - a table containing all the values already seen during a single, recursive print attempt (to avoid cycles or duplication) Returns: a string containing the pretty-printed version of the given object ]]-- function private.dump(value, depth, indent, max_keys, seen) depth = depth or 10 indent = indent or "" max_keys = max_keys or 100 seen = seen or {} if depth == 0 then return "" end if seen[value] == true then return "" end seen[value] = true local result = "" if type(value) == "table" then result = result.."{\n" local inner_indent = indent.." " local key_count = 0 for inner_key, inner_value in pairs(value) do local inner_text = private.dump(inner_value, depth - 1, inner_indent, max_keys, seen) result = result..inner_indent..inner_key.." = "..inner_text.."\n" key_count = key_count + 1 if key_count >= max_keys then result = result..inner_indent.."\n" break end end result = result..indent.."}" else result = tostring(value) end return result end -- Export ----------------------------------------------------------------------------------------- return private.dump