Rails Debug Toolkit
===================
Introduction
------------
`rails_dt` gem gives you `DT.p()` method you can use anywhere in your project to print variable dumps, debug messages etc.
It's similar to Ruby's native `p()` with output being sent to browser, console and log.
Setup
-----
$ gem sources --add http://rubygems.org
$ gem install rails_dt
In your application root, do a:
$ script/generate rails_dt
Follow the instructions the generator gives you (they are listed below):
In your `config/environment.rb`, add:
config.gem "rails_dt"
Inside your `ApplicationController` class, add:
handles_dt
In your `app/views/layouts/application.html.erb` `` section, add:
<%= stylesheet_link_tag "dt" %>
Somewhere at the end of your `app/views/layouts/application.html.erb` `` section, add:
<%= DT.to_html %>
Checking Setup
--------------
Somewhere in your `app/views/layouts/application.html.erb`, add:
<% DT.p "hello, world" %>
Refresh a page that uses this layout. You should see "hello, world" beneath your main page content.
Debugging...
------------
### ...Models ###
def before_save
DT.p "in before_save"
end
### ...Controllers ###
def action
DT.p "hi, I'm #{action_name}"
end
### ...Views ###
<% DT.p "@users", @users %>
### ...Filters ###
Insert debugging code:
before_filter do
DT.p "in before_filter xyz"
end
after_filter do
DT.p "in after_filter xyz"
end
See it in action:
$ tail -f log/dt.log
### ...Anything! ###
To conclude it, `DT.p` is the universal method you can print your debug messages with.
Feedback
--------
Send bug reports, suggestions and criticisms through [project's page on GitHub](http://github.com/dadooda/rails_dt).