DebugExtras
Helper methods for Ruby on Rails applications debugging. Screenshots.
Table of Contents
- Features
- Installation
- Usage
- #dd
- #wp
- #dump
- Styling
- License
Features
-
dd <variable>
at anyapp/
place. Inspired bydd
function from Laravel. -
wp <variable>
at anyapp/
place. Inspired by classic PHP 'print' debug. It works for HTML pages and bypass other content types likeapplication/json
. -
dump <variable>
at your views. It's alternative fordebug
method fromActionView::Helpers::DebugHelper
andap
fromAwesomePrint
.
Installation
Add this line to your Gemfile:
gem 'debug-extras', group: :development
And then execute:
$ bundle
Usage
#dd
Call dd
from any app/
place:
dd @books
#wp
Call wp
from any app/
place:
wp 'Authors through #wp method (called from controller):'
wp @authors
#dump
Call dump
from views:
<%= dump 'Books through #dump method (called from view):' %>
<%= dump @books %>
Styling
DebugExtras inject default CSS to the page on methods call. You can override styles and
set your fonts, margins, etc using .debug-extras
wrapper. Just look to the page sources to see
them at the end of head section.
Example how to override default fonts in your stylesheet:
.debug-extras pre,
.debug-extras kbd {
font-family: Consolas, SFMono-Regular, Menlo, Monaco, Ubuntu, monospace !important;
font-size: 14px !important;
line-height: 18px !important;
}
or may be you want to use pre-wrap
rendering:
.debug-extras pre {
white-space: pre-wrap !important;
}
Note: if #wp and #dump results looks different compare to the screenshots above then default styles were overridden by yours.
License
DebugExtras is released under the MIT License.