p-lambert / mutant.el Goto Github PK

An interface for the Mutant testing tool

This package provides an interface for dealing with the Mutant testing tool, enabling one to easily launch it from a .rb file or even from a dired buffer. The generated output is nicely formatted and provides direct links to the errors reported by the mutations. I've tried to mimic the rspec-mode overall experience as much as possible.

This package can be installed via MELPA, or manually by downloading mutant.el and adding it to your init file, as it follows:

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

For having mutant-mode enabled automatically, I suggest you to do the following:

(add-hook 'ruby-mode-hook 'mutant-mode)

By default, the following keybindings will be available:

• C-c . f runs mutant-check-file
• C-c . c runs mutant-check-custom

For dired mode integration, just add the following to your configuration file:

(add-hook 'dired-mode-hook 'mutant-dired-mode)

By doing so, you'll be able to mark files and then press C-c . f for running mutant on them.

See the Function Documentation for more details.

If you're a rvm user, you might have to add the following to your configuration file:

(add-hook 'mutant-precompile-hook
          (lambda () (rvm-activate-corresponding-ruby)))

Notice that this obviously requires rvm.el to be installed.

In order to execute the mutant command with a bundle exec prefix, simply add the following to your configuration file:

(setq mutant-cmd-base "bundle exec mutant")

1.0 - First release.

Run Mutant over a single file. If none is given, then buffer-file-name is used.

Run Mutant over all marked files in dired. If there are no files marked, use that under cursor.

Run Mutant over MATCH-EXP. When called without argument, prompt user.