Class: RubyProf::CallTreePrinter

Inherits:
AbstractPrinter show all
Defined in:
lib/ruby-prof/printers/call_tree_printer.rb

Overview

Generates profiling information in callgrind format for use by kcachegrind and similar tools.

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from AbstractPrinter

#filter_by, #initialize, #max_percent, #method_href, #method_location, #min_percent, #open_asset, #print_column_headers, #print_footer, #print_header, #setup_options, #sort_method, #time_format

Constructor Details

This class inherits a constructor from RubyProf::AbstractPrinter

Class Method Details

.needs_dir? ⇒ Boolean

Returns:

  • (Boolean) 


97
98
99
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 97

def self.needs_dir?
  true
end

Instance Method Details

#calltree_name(method_info) ⇒ Object 



12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 12

def calltree_name(method_info)
  klass_path = method_info.klass_name.gsub("::", '/')
  result = "#{klass_path}::#{method_info.method_name}"

  case method_info.klass_flags
    when 0x2
      "#{result}^"
    when 0x4
      "#{result}^"
    when 0x8
     "#{result}*"
    else
     result
  end
end

#convert(value) ⇒ Object 



76
77
78
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 76

def convert(value)
  (value * @value_scale).round
end

#determine_event_specification_and_value_scale ⇒ Object 



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
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 28

def determine_event_specification_and_value_scale
  @event_specification = "events: "
  case @result.measure_mode
    when RubyProf::PROCESS_TIME
      @value_scale = RubyProf::CLOCKS_PER_SEC
      @event_specification << 'process_time'
    when RubyProf::WALL_TIME
      @value_scale = 1_000_000
      @event_specification << 'wall_time'
    when RubyProf.const_defined?(:ALLOCATIONS) && RubyProf::ALLOCATIONS
      @value_scale = 1
      @event_specification << 'allocations'
    when RubyProf.const_defined?(:MEMORY) && RubyProf::MEMORY
      @value_scale = 1
      @event_specification << 'memory'
    when RubyProf.const_defined?(:GC_RUNS) && RubyProf::GC_RUNS
      @value_scale = 1
      @event_specification << 'gc_runs'
    when RubyProf.const_defined?(:GC_TIME) && RubyProf::GC_TIME
      @value_scale = 1000000
      @event_specification << 'gc_time'
    else
      raise "Unknown measure mode: #{RubyProf.measure_mode}"
  end
end

#file(method) ⇒ Object 



80
81
82
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 80

def file(method)
  method.source_file ? File.expand_path(method.source_file) : ''
end

#file_name_for_thread(thread) ⇒ Object 



107
108
109
110
111
112
113
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 107

def file_name_for_thread(thread)
  if thread.fiber_id == Fiber.current.object_id
    ["callgrind.out", $$].join(".")
  else
    ["callgrind.out", $$, thread.fiber_id].join(".")
  end
end

#file_path_for_thread(thread) ⇒ Object 



115
116
117
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 115

def file_path_for_thread(thread)
  File.join(path, file_name_for_thread(thread))
end

#path ⇒ Object 



93
94
95
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 93

def path
  @options[:path] || "."
end

#print(options = {}) ⇒ Object 



54
55
56
57
58
59
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 54

def print(options = {})
  validate_print_params(options)
  setup_options(options)
  determine_event_specification_and_value_scale
  print_threads
end

#print_headers(output, thread) ⇒ Object 



119
120
121
122
123
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 119

def print_headers(output, thread)
  output << "#{@event_specification}\n\n"
  # this doesn't work. kcachegrind does not fully support the spec.
  # output << "thread: #{thread.id}\n\n"
end

#print_method(output, method) ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 125

def print_method(output, method)
  # Print out the file and method name
  output << "fl=#{file(method)}\n"
  output << "fn=#{self.calltree_name(method)}\n"

  # Now print out the function line number and its self time
  output << "#{method.line} #{convert(method.self_time)}\n"

  # Now print out all the children methods
  method.call_trees.callees.each do |callee|
    output << "cfl=#{file(callee.target)}\n"
    output << "cfn=#{self.calltree_name(callee.target)}\n"
    output << "calls=#{callee.called} #{callee.line}\n"

    # Print out total times here!
    output << "#{callee.line} #{convert(callee.total_time)}\n"
  end
  output << "\n"
end

#print_thread(thread) ⇒ Object 



84
85
86
87
88
89
90
91
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 84

def print_thread(thread)
  File.open(file_path_for_thread(thread), "w") do |f|
    print_headers(f, thread)
    thread.methods.reverse_each do |method|
      print_method(f, method)
    end
  end
end

#print_threads ⇒ Object 



69
70
71
72
73
74
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 69

def print_threads
  remove_subsidiary_files_from_previous_profile_runs
  @result.threads.each do |thread|
    print_thread(thread)
  end
end

#remove_subsidiary_files_from_previous_profile_runs ⇒ Object 



101
102
103
104
105
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 101

def remove_subsidiary_files_from_previous_profile_runs
  pattern = ["callgrind.out", $$, "*"].join(".")
  files = Dir.glob(File.join(path, pattern))
  FileUtils.rm_f(files)
end

#validate_print_params(options) ⇒ Object 



61
62
63
64
65
66
67
 
# File 'lib/ruby-prof/printers/call_tree_printer.rb', line 61

def validate_print_params(options)
  if options.is_a?(IO)
    raise ArgumentError, "#{self.class.name}#print cannot print to IO objects"
  elsif !options.is_a?(Hash)
    raise ArgumentError, "#{self.class.name}#print requires an options hash"
  end
end