aboutsummaryrefslogtreecommitdiffstats
path: root/src/irc/debug.lua
blob: 414b49deefc33b1995eaddf83b756bc0d21dba9d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
-- Basic debug output
-- initialization {{{
local base = _G
local io =   require 'io'
-- }}}

---
-- This module implements a few useful debug functions for use throughout the
-- rest of the code.
module 'irc.debug'

-- defaults {{{
COLOR = true
-- }}}

-- local variables {{{
local ON = false
local outfile = io.output()
-- }}}

-- internal functions {{{
-- _message {{{
--
-- Output a debug message.
-- @param msg_type Arbitrary string corresponding to the type of message
-- @param msg      Message text
-- @param color    Which terminal code to use for color output (defaults to
--                 dark gray)
function _message(msg_type, msg, color)
    if ON then
        local endcolor = ""
        if COLOR and outfile == io.stdout then
            color = color or "\027[1;30m"
            endcolor = "\027[0m"
        else
            color = ""
            endcolor = ""
        end
        outfile:write(color .. msg_type .. ": " .. msg .. endcolor .. "\n")
    end
end
-- }}}

-- _err {{{
--
-- Signal an error. Writes the error message to the screen in red and calls
-- error().
-- @param msg Error message
-- @see error
function _err(msg)
    _message("ERR", msg, "\027[0;31m")
    base.error(msg, 2)
end
-- }}}

-- _warn {{{
--
-- Signal a warning. Writes the warning message to the screen in yellow.
-- @param msg Warning message
function _warn(msg)
    _message("WARN", msg, "\027[0;33m")
end
-- }}}
-- }}}

-- public functions {{{
-- enable {{{
---
-- Turns on debug output.
function enable()
    ON = true
end
-- }}}

-- disable {{{
---
-- Turns off debug output.
function disable()
    ON = false
end
-- }}}

-- set_output {{{
---
-- Redirects output to a file rather than stdout.
-- @param file File to write debug output to
function set_output(file)
    outfile = base.assert(io.open(file))
end
-- }}}
-- }}}