Home

Awesome

inf-ruby provides a REPL buffer connected to a Ruby subprocess.

Installation

Via package.el

package.el is the built-in package manager in Emacs 24+. On Emacs 23 you will need to get package.el yourself if you wish to use it.

inf-ruby is available on both major package.el community maintained repos: Marmalade and MELPA.

If you're not already using one of them, follow their installation instructions: Marmalade, MELPA.

And then you can install inf-ruby with the following command:

<kbd>M-x package-install [RET] inf-ruby [RET]</kbd>

or by adding this bit of Emacs Lisp code to your Emacs initialization file (.emacs or init.el):

(unless (package-installed-p 'inf-ruby)
  (package-install 'inf-ruby))

If the installation doesn't work try refreshing the package list:

<kbd>M-x package-refresh-contents [RET]</kbd>

Via el-get

el-get is another popular package manager for Emacs. If you're an el-get user just do <kbd>M-x el-get-install</kbd>.

Manual

If you're installing manually, you'll need to:

(autoload 'inf-ruby-minor-mode "inf-ruby" "Run an inferior Ruby process" t)
(add-hook 'ruby-mode-hook 'inf-ruby-minor-mode)

Or, for enh-ruby-mode:

(add-hook 'enh-ruby-mode-hook 'inf-ruby-minor-mode)

Installation via package.el interface does the above for you automatically.

Additionally, consider adding

(add-hook 'compilation-filter-hook 'inf-ruby-auto-enter)

or

(add-hook 'compilation-filter-hook 'inf-ruby-auto-enter-and-focus)

to your init file to automatically switch from common Ruby compilation modes to interact with a debugger. The latter snippet will also select the compilation window and move point to the breakpoint prompt.

Custom Prompts

If you wish to add other interpreter prompt patterns, see the description in the wiki.

Emacs Prelude

inf-ruby comes bundled in Emacs Prelude. If you're a Prelude user you can start using it right away.

Usage

IRB

A simple IRB process can be fired up with <kbd>M-x inf-ruby</kbd>.

Project

To launch a REPL with project-specific console instead, type <kbd>M-x inf-ruby-console-auto</kbd>. It recognizes several project types, including Rails, gems and anything with racksh in their Gemfile.

Hooks

When entered, this mode runs comint-mode-hook and inf-ruby-mode-hook (in that order).

Commands

Keybindings

Keymap

To see the list of the keybindings defined by inf-ruby-minor-mode, type <kbd>M-x describe-function [RET] inf-ruby-minor-mode [RET]</kbd>.

Bugs

IRB.conf[:USE_MULTILINE] = false if ENV['INSIDE_EMACS']
IRB.conf[:USE_READLINE] = false if ENV['INSIDE_EMACS']

For most projects that inf-ruby-console-auto can recognize, we try to apply this flag automatically (using command line arguments rather than .irbrc), but some cases remain where the users will have to do it manually.

IRB 1.2.x broke the --noreadline support (#137, IRB#127). Upgrade to IRB 1.3.0 or newer for better experience.

Please report problems at http://github.com/nonsequitur/inf-ruby/issues.