Module: Log

Extended by:
Term::ANSIColor
Defined in:
lib/rbbt/util/log.rb,
lib/rbbt/util/log/progress.rb,
lib/rbbt/util/log/progress/util.rb,
lib/rbbt/util/log/progress/report.rb

Defined Under Namespace

Classes: ProgressBar

Constant Summary collapse

LOG_MUTEX =

ToDo: I’m not sure if using a Mutex here really gives troubles in CPU concurrency LOG_MUTEX = MockMutex.new

Mutex.new
SEVERITY_COLOR =

.collect{|e| “033[#{e}”}

[reset, cyan, green, magenta, blue, yellow, red]
HIGHLIGHT = 
"\033[1m"
LAST = 
"log"

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.logfile(file = nil) ⇒ Object

Returns the value of attribute logfile.



67
68
69
 
# File 'lib/rbbt/util/log.rb', line 67

def logfile
  @logfile
end

.nocolor ⇒ Object

Returns the value of attribute nocolor.



67
68
69
 
# File 'lib/rbbt/util/log.rb', line 67

def nocolor
  @nocolor
end

.severity ⇒ Object

Returns the value of attribute severity.



67
68
69
 
# File 'lib/rbbt/util/log.rb', line 67

def severity
  @severity
end

.tty_size ⇒ Object

Returns the value of attribute tty_size.



67
68
69
 
# File 'lib/rbbt/util/log.rb', line 67

def tty_size
  @tty_size
end

Class Method Details

.clear_line(out = STDOUT) ⇒ Object 



135
136
137
 
# File 'lib/rbbt/util/log.rb', line 135

def self.clear_line(out = STDOUT)
  out.puts Log.return_line << " " * (Log.tty_size || 80) << Log.return_line unless nocolor
end

.color(severity, str = nil, reset = false) ⇒ Object 



119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/rbbt/util/log.rb', line 119

def self.color(severity, str = nil, reset = false)
  return str || "" if nocolor 
  color = reset ? Term::ANSIColor.reset : ""
  color << SEVERITY_COLOR[severity] if Fixnum === severity
  color << Term::ANSIColor.send(severity) if Symbol === severity and Term::ANSIColor.respond_to? severity 
  if str.nil?
    color
  else
    color + str.to_s + self.color(0)
  end
end

.color_stack(stack) ⇒ Object 



239
240
241
242
243
244
245
246
 
# File 'lib/rbbt/util/log.rb', line 239

def self.color_stack(stack)
  stack.collect do |line|
    line = line.sub('`',"'")
    color = :green if line =~ /workflow/
    color = :blue if line =~ /rbbt-/
    Log.color color, line
  end
end

.debug(message = nil, &block) ⇒ Object 



199
200
201
 
# File 'lib/rbbt/util/log.rb', line 199

def self.debug(message = nil, &block)
  log(message, DEBUG, &block)
end

.deprecated(m) ⇒ Object 



233
234
235
236
237
 
# File 'lib/rbbt/util/log.rb', line 233

def self.deprecated(m)
  stack = caller
  warn("DEPRECATED: " << Log.last_caller(caller))
  warn("* " << (m || "").to_s)
end

.error(message = nil, &block) ⇒ Object 



223
224
225
 
# File 'lib/rbbt/util/log.rb', line 223

def self.error(message = nil, &block)
  log(message, ERROR, &block)
end

.exception(e) ⇒ Object 



227
228
229
230
231
 
# File 'lib/rbbt/util/log.rb', line 227

def self.exception(e)
  stack = caller
  error([e.class.to_s, e.message].compact * ": " )
  error("BACKTRACE: " << Log.last_caller(caller) << "\n" + color_stack(e.backtrace)*"\n")
end

.get_level(level) ⇒ Object 



51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/rbbt/util/log.rb', line 51

def self.get_level(level)
  case level
  when Fixnum
    level
  when String
    begin
      Log.const_get(level.upcase)
    rescue
      Log.exception $!
    end
  when Symbol
    get_level(level.to_s)
  end || 0
end

.high(message = nil, &block) ⇒ Object 



211
212
213
 
# File 'lib/rbbt/util/log.rb', line 211

def self.high(message = nil, &block)
  log(message, HIGH, &block)
end

.highlight(str = nil) ⇒ Object 



139
140
141
142
143
144
145
146
147
 
# File 'lib/rbbt/util/log.rb', line 139

def self.highlight(str = nil)
  if str.nil?
    return "" if nocolor
    HIGHLIGHT
  else
    return str if nocolor
    HIGHLIGHT + str + color(0)
  end
end

.ignore_stderr ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/rbbt/util/log.rb', line 36

def self.ignore_stderr
  LOG_MUTEX.synchronize do
    backup_stderr = STDERR.dup
    File.open('/dev/null', 'w') do |f|
      STDERR.reopen(f)
      begin
        yield
      ensure
        STDERR.reopen backup_stderr
        backup_stderr.close
      end
    end
  end
end

.info(message = nil, &block) ⇒ Object 



215
216
217
 
# File 'lib/rbbt/util/log.rb', line 215

def self.info(message = nil, &block)
  log(message, INFO, &block)
end

.last_caller(stack) ⇒ Object 



27
28
29
30
31
32
33
34
 
# File 'lib/rbbt/util/log.rb', line 27

def self.last_caller(stack)
  line = nil
  pos ||= 0
  while line.nil? or line =~ /util\/log\.rb/ and stack.any? 
    line = stack.shift 
  end
  line ||= caller.first
end

.log(message = nil, severity = MEDIUM, &block) ⇒ Object 



150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
 
# File 'lib/rbbt/util/log.rb', line 150

def self.log(message = nil, severity = MEDIUM, &block)
  return if severity < self.severity 
  message ||= block.call if block_given?
  return if message.nil?

  time = Time.now.strftime("%m/%d/%y-%H:%M:%S.%L")

  sev_str = severity.to_s

  #prefix = time << "[" << color(severity) << sev_str << color(0)<<"]"
  prefix = time << color(severity) << "["  << sev_str << "]" << color(0)
  #prefix = color(severity) << time << color(0) << "[" << sev_str  << "]"
  message = "" << highlight << message << color(0) if severity >= INFO
  str = prefix << " " << message

  LOG_MUTEX.synchronize do
    STDERR.puts str
    Log::LAST.replace "log"
    logfile.puts str unless logfile.nil?
    nil
  end
end

.log_obj_fingerprint(obj, level, file = $stdout) ⇒ Object 



186
187
188
189
190
191
192
193
194
195
196
197
 
# File 'lib/rbbt/util/log.rb', line 186

def self.log_obj_fingerprint(obj, level, file = $stdout)
  stack = caller

  line = Log.last_caller stack

  level = Log.get_level level
  name = Log::SEVERITY_NAMES[level] + ": "
  Log.log Log.color(level, name, true) << line, level
  Log.log "", level
  Log.log Log.color(level, "=> ", true) << Misc.fingerprint(obj), level
  Log.log "", level
end

.log_obj_inspect(obj, level, file = $stdout) ⇒ Object 



173
174
175
176
177
178
179
180
181
182
183
184
 
# File 'lib/rbbt/util/log.rb', line 173

def self.log_obj_inspect(obj, level, file = $stdout)
  stack = caller

  line = Log.last_caller stack

  level = Log.get_level level
  name = Log::SEVERITY_NAMES[level] + ": "
  Log.log Log.color(level, name, true) << line, level
  Log.log "", level
  Log.log Log.color(level, "=> ", true) << obj.inspect, level
  Log.log "", level
end

.low(message = nil, &block) ⇒ Object 



203
204
205
 
# File 'lib/rbbt/util/log.rb', line 203

def self.low(message = nil, &block)
  log(message, LOW, &block)
end

.medium(message = nil, &block) ⇒ Object 



207
208
209
 
# File 'lib/rbbt/util/log.rb', line 207

def self.medium(message = nil, &block)
  log(message, MEDIUM, &block)
end

.reset_color ⇒ Object 



115
116
117
 
# File 'lib/rbbt/util/log.rb', line 115

def self.reset_color
  reset
end

.return_line ⇒ Object 



131
132
133
 
# File 'lib/rbbt/util/log.rb', line 131

def self.return_line
  nocolor ? "" : "\033[1A"
end

.stack(stack) ⇒ Object 



254
255
256
257
258
259
260
261
262
 
# File 'lib/rbbt/util/log.rb', line 254

def self.stack(stack)
  LOG_MUTEX.synchronize do

    STDERR.puts Log.color :magenta, "Stack trace: " << Log.last_caller(caller)
    color_stack(stack).each do |line|
      STDERR.puts line
    end
  end
end

.tsv(tsv) ⇒ Object 



248
249
250
251
252
 
# File 'lib/rbbt/util/log.rb', line 248

def self.tsv(tsv)
  STDERR.puts Log.color :magenta, "TSV log: " << Log.last_caller(caller)
  puts Log.color(:blue, "=> "<< Misc.fingerprint(tsv), true) 
  puts Log.color(:cyan, "=> " << tsv.summary)
end

.uncolor(str) ⇒ Object 



111
112
113
 
# File 'lib/rbbt/util/log.rb', line 111

def self.uncolor(str)
  Term::ANSIColor.uncolor(str)
end

.warn(message = nil, &block) ⇒ Object 



219
220
221
 
# File 'lib/rbbt/util/log.rb', line 219

def self.warn(message = nil, &block)
  log(message, WARN, &block)
end

.with_severity(level) ⇒ Object 



81
82
83
84
85
86
87
88
89
 
# File 'lib/rbbt/util/log.rb', line 81

def self.with_severity(level)
  orig = Log.severity
  begin
    Log.severity = level
    yield
  ensure
    Log.severity = orig
  end
end