README.md

Emacs RSpec Mode

RSpec mode provides some convenience functions for dealing with RSpec.

Installation

You can install via ELPA, or manually by downloading rspec-mode and
adding the following to your init file:

(add-to-list 'load-path "/path/to/rspec-mode")
(require 'rspec-mode)

Provided you have yasnippet installed, you can load the snippets:

(eval-after-load 'rspec-mode
'(rspec-install-snippets))

(This isn't done automatically to avoid conflicts with snippets you
may already have set up.)

Usage

If rspec-mode is installed properly, it will be started
automatically when ruby-mode is started.

RSpec Verifiable mode

These keybindings are available in any Ruby source file:

Keybinding

Description

C-c , v

Verify the spec file associated with the current buffer

C-c , a

Run spec for entire project

C-c , t

Toggle back and forth between a spec and its target

C-c , e

Toggle back and forth between a method and its examples in the spec file

C-c , 4 t

Find in the other window the spec or the target file

C-c , 4 e

As above, but try to navigate to the example or method corresponding to point

C-c , r

Re-run the last verification process

C-c , m

Run all specs related to the current buffer

C-c , c

Run the current spec and all after it

C-c , s

Verify the example or method defined at point

C-c , f

Re-run just the failed examples from the last run

RSpec mode

These keybindings are available in Ruby spec files:

Keybinding

Description

C-c , s

Run the specified example at point

C-c , d

Toggle the pendingness of the example at point

RSpec Dired mode

These keybindings are available in Dired buffers:

Keybinding

Description

C-c , v

Run all specs in the current directory

C-c , s

Run marked specs or spec at point (works with directories too)

C-c , a

Run the 'spec' rake task for the project of the current file

C-c , r

Re-run the last RSpec invocation

See rspec-mode.el for further usage.

Gotchas

Debugging

To use binding.pry or byebug, install inf-ruby and add this to
your init file:

(add-hook 'after-init-hook 'inf-ruby-switch-setup)

When you've hit the breakpoint, hit C-x C-q to enable inf-ruby.

ZSH and RVM

If you use ZSH and RVM, you may encounter problems running the
specs. It may be so that an older version of Ruby, than the one you
specified in .rvmrc, is used. This is because ZSH runs a small
script each time a shell is created, which modifies the $PATH. The
problem is that it prepends some default paths, such as /usr/bin,
which contains another ruby binary.

What you can do to solve this is to use BASH for running the
specs. This piece of code does the job: