Class: Vedeu::Logging::Timer

Inherits:
Object
  • Object
show all
Defined in:
lib/vedeu/logging/timer.rb

Overview

Measure the duration. Used for debugging. The configuration option ‘debug’ must be set to true to enable this functionality.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(message = '') ⇒ Vedeu::Logging::Timer

Returns a new instance of Vedeu::Logging::Timer.

Parameters:

  • message (String) (defaults to: '') 


36
37
38
39
 
# File 'lib/vedeu/logging/timer.rb', line 36

def initialize(message = '')
  @message = message
  @started = Time.now.to_f
end

Instance Attribute Details

#message ⇒ String (readonly, protected)

Returns:

  • (String) 


71
72
73
 
# File 'lib/vedeu/logging/timer.rb', line 71

def message
  @message
end

#started ⇒ Time (readonly, protected)

Returns:

  • (Time) 


67
68
69
 
# File 'lib/vedeu/logging/timer.rb', line 67

def started
  @started
end

Class Method Details

.timer(message = '', &block) ⇒ void

This method returns an undefined value.

Measure the execution time of the code in the given block. The message provided will have ‘ took <time>ms.’ appended.

Examples:

Vedeu.timer 'Really complex code' do
  # ... code to be measured
end

# => 'Really complex code took 0.234ms.'

Parameters:

  • message (String) (defaults to: '')
  • block (Proc) 


26
27
28
 
# File 'lib/vedeu/logging/timer.rb', line 26

def timer(message = '', &block)
  new(message).measure(&block)
end

Instance Method Details

#elapsed ⇒ Float (protected)

Returns the elapsed time in milliseconds with 3 decimal places.

Returns:

  • (Float) 


77
78
79
 
# File 'lib/vedeu/logging/timer.rb', line 77

def elapsed
  ((Time.now.to_f - started) * 1000).round(3)
end

#measure ⇒ void

This method returns an undefined value.

Write an entry to the log file stating how long a section of code took in milliseconds. Useful for debugging performance.

Raises:



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/vedeu/logging/timer.rb', line 46

def measure
  fail Vedeu::Error::RequiresBlock unless block_given?

  if Vedeu::Configuration.debug?
    work = yield

    Vedeu.log(type:    :timer,
              message: "#{message} took #{elapsed}ms.".freeze)

    work

  else
    yield

  end
end