Skip to content

formatting.md

Latest commit

 

History

History
73 lines (53 loc) · 1.36 KB

formatting.md

File metadata and controls

73 lines (53 loc) · 1.36 KB

Formatting, Colors, and Grouping

📦 Auto Grouping

Consecutive messages from the same section are automatically grouped for better readability. The visual grouping behaves natively based on log sequences without needing any extra intervention.

flowchart LR
    A(["log()"]) --> D{Same Section?}
    M(["log()"]) -->|Consecutive| D
    
    D -->|Yes| C[Merge to previous group]
    D -->|No| E[Start new group block]
    
    C -.-> F("[1-2][network]<br>Connected<br>User Auth OK")
    E -.-> G("[3][db]<br>Query Failed")
Loading 
local net = log.inSection("network")
net("Connecting...")
net("Handshake OK")
net("Authenticated")

log.add(log.section("database"), "Query executed")

net("Sending data")
net("Response received")

Output:

[1-3][network]
 Connecting...
 Handshake OK
 Authenticated

[4][database]
 Query executed

[5-6][network]
 Sending data
 Response received

🎨 Colors

Enable ANSI colors for colored output (errors in red, debug in yellow):

log.enableColors()   -- enable colors
log.disableColors()  -- disable colors
log.hasColors()      -- check if colors are enabled

🔧 Custom Header

Customize the log header with setHandlerHeader:

log.setHandlerHeader(function()
    return "(-/", 9, "My App"
end)

Output:

(-/(-/(-/(-/(-/(-/(-/(-/(-/(-/
My App
(-/(-/(-/(-/(-/(-/(-/(-/(-/(-/