класс Tracer

Выводит трассировку выполнения программы Ruby на уровне исходного кода.

Это делается путём регистрации обработчика событий с помощью Kernel#set_trace_func для обработки входящих событий. Также предоставляются методы для фильтрации нежелательного трассировочного вывода (см. ::add_filter, ::on и ::off).

Пример

Рассмотрим следующий скрипт Ruby

class A
  def square(a)
    return a*a
  end
end

a = A.new
a.square(5)

Запуск вышеуказанного скрипта с помощью ruby -r tracer example.rb выведет следующую трассировку в стандартный вывод (Обратите внимание, что вы также можете явно require 'tracer')

#0:<internal:lib/rubygems/custom_require>:38:Kernel:<: -
#0:example.rb:3::-: class A
#0:example.rb:3::C: class A
#0:example.rb:4::-:   def square(a)
#0:example.rb:7::E: end
#0:example.rb:9::-: a = A.new
#0:example.rb:10::-: a.square(5)
#0:example.rb:4:A:>:   def square(a)
#0:example.rb:5:A:-:     return a*a
#0:example.rb:6:A:<:   end
 |  |         | |  |
 |  |         | |   ---------------------+ event
 |  |         |  ------------------------+ class
 |  |          --------------------------+ line
 |   ------------------------------------+ filename
  ---------------------------------------+ thread

Таблица символов Symbol, используемая для отображения входящих событий:

+}+

вызов C-языковой функции

+{+

возврат из C-языковой функции

+>+

вызов метода Ruby

+<+

возврат из метода Ruby

+def+

начало определения класса или модуля

+end+

окончание определения класса или модуля

+line+

выполнение кода на новой строке

+^+

выброс исключения

Авторские права

Keiju ISHITSUKA (keiju@ishitsuka.com)