This commit is contained in:
Andrew Miner
2026-10-27 09:19:27 -06:00
parent a822ebbdfd
commit 267349a830
9 changed files with 45 additions and 40 deletions
+34 -4
View File
@@ -2,9 +2,31 @@
local private = {}
function private.dump(value, depth, indent, seen)
depth = depth or -1
--[[
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 "<too deep: "..tostring(value)..">" end
@@ -16,9 +38,15 @@ function private.dump(value, depth, indent, seen)
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, seen)
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.."<too many keys>\n"
break
end
end
result = result..indent.."}"
else
@@ -31,4 +59,6 @@ end
-- Export -----------------------------------------------------------------------------------------
return private.dump
return {
dump = private.dump
}