Tracerius

Tracerius is a simple and fast tracer for your Ruby code. It follows your code line by line and deep dive into any gem source code to carefully inspect every method you call. Think - it's puts debugging on steroids.

It's very opinioned out of the box, but in the same time it tries really hard to be flexible, so you can adopt it to your tracing style.

Installation

Add this line to your application's Gemfile:

gem 'tracerius'

And then execute:

$ bundle

Or install it yourself as:

$ gem install tracerius

Usage

Configuration

Tracerius provides a few options you can configure:

Show or not params for methods (for custom classes you can choose a strategie)
Write output on screen or to file (also you can provide your custom strategie)
How to handle fatal errors (few options)

You can skip setting it up, because Tracerius provides saine defaults for every case.

Basic usage might look like:

Tracerius::Runner.run do
  puts "Hello"
end

Output:
47.929 0.000     line hello.rb:4
47.929 0.000   c-call hello.rb:4        puts   Kernel
47.929 0.000   c-call hello.rb:4        puts       IO
47.930 0.000   c-call hello.rb:4       write       IO
47.930 0.001 c-return hello.rb:4       write       IO
47.930 0.000   c-call hello.rb:4       write       IO

47.930 0.000 c-return hello.rb:4       write       IO
47.930 0.000 c-return hello.rb:4        puts       IO
47.930 0.000 c-return hello.rb:4        puts   Kernel

Development

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing