Debbie

Fully based on the amazing work of @nixme (Gopal Patel) on his gem Jazz Hands

We only removed some stuff that we're not using it and also remove some stuff that are not compatible with ruby > 2.0.0

---

Spending hours in the rails console? Spruce it up and show off those hard-working hands!

debbie is an opinionated set of console-related gems and a bit of glue:

• Pry for a powerful shell alternative to IRB.
• Awesome Print for stylish pretty print.
• Hirb for tabular collection output.
• Pry Rails for additional commands (show-routes, show-models, show-middleware) in the Rails console.
• Pry Stack Explorer to navigate the call stack and frames.
• Pry Remote to connect remotely to a Pry console.
• Coolline & Coderay for syntax highlighting as you type. Optional. MRI 1.9.3/2.0.0 only

To-Do

• Simple log time profiler Add a Simple Ruby Profiler for logging time consume in stuff

Usage

Ruby 1.9.3+, Rails 3 or 4 only. Add to your project Gemfile:

group :development, :test do
  gem 'debbie'
end

That's it. Run bundle and then bundle exec rails c as usual.

Hirb isn't enabled by default. To use, run Hirb.enable in the console.

Ruby compiled against a proper readline library, ideally GNU readline, is recommended. Alternatively, gem install rb-readline for an acceptible backup. Using ruby compiled against a libedit wrapper (primarily OS X) will work but is not recommended.

Options

Change the following options by creating an initializer in your Rails project Example config/initializers/debbie.rb:

if defined?(Debbie)
  Debbie.colored_prompt = false
  Debbie.enable_syntax_highlighting_as_you_type!
end

colored_prompt

Color the console prompt? Defaults to true when the current ruby is compiled against GNU readline or rb-readline, which don't have issues counting characters in colored prompts. false for libedit.

Note: Pry.color = false trumps this setting and disables all console coloring.

prompt_separator

Separator string between the application name and line input. Defaults to » for GNU readline or libedit. Defaults to > for rb-readline which fails on mixed encodings.

Syntax highlighting

Syntax highlighting as you type via Coolline and Coderay is disabled by default due to slightly buggy behavior. To enable, add Debbie.enable_syntax_highlighting_as_you_type! to the initializer. Only works with MRI 1.9.3 or 2.0.0.

Contributing

Patches and bug reports are welcome. Just send a pull request or file an issue. Project changelog.