whatisgithub

What is vim-spec-finder?

skwp/vim-spec-finder — explained in plain English

Analysis updated 2026-07-11 · repo last pushed 2020-05-17

3VimLAudience · developerComplexity · 1/5DormantSetup · easy

In one sentence

A Vim plugin for Ruby developers that automatically switches between source files and their test files with a single shortcut, eliminating manual folder navigation.

Mindmap

mindmap
  root((repo))
    What it does
      Toggles between code and tests
      Opens matching spec file
      Supports split window view
    Tech stack
      VimL
      Vim editor
      Ruby
    Use cases
      Rails app development
      Ruby gem development
      Test-driven workflows
    Audience
      Ruby developers
      Vim users
      TDD practitioners
    Setup
      Install as Vim plugin
      Follow spec folder convention
      Check vim-ruby-conque
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Toggle between a Ruby source file and its corresponding test file with one keystroke while working in Vim.

USE CASE 2

Open the matching test file in a split window so you can view code and tests side by side.

USE CASE 3

Get the file path of the corresponding spec so you can pass it to another tool or command.

What is it built with?

VimLVimRuby

How does it compare?

skwp/vim-spec-finderdavidpdrsn/vim-leaderboardjianyuh/vimbackup
Stars34
LanguageVimLVimLVimL
Last pushed2020-05-172014-11-222016-09-19
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity1/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Your Ruby project must follow the convention of mirroring spec files under a spec or fast_spec directory.

So what is it?

If you write Ruby code in Vim, you probably bounce back and forth between your source files and your test files constantly. The spec-finder plugin automates that tedious toggle. Press a shortcut while looking at a code file, and it opens the corresponding test file. Press it in a test file, and it takes you back to the code it tests. The plugin makes a few straightforward assumptions about how your project is organized. It expects your tests to live in a folder called spec or fast_spec, and it assumes your test files mirror the structure of your code files. For example, if your code lives at lib/foo/bar.rb, the plugin looks for a test file at spec/lib/foo/bar_spec.rb. As long as your project follows that convention, the plugin can figure out the matching file on its own. It also gives you options for how to open the file, such as in a separate split window alongside your current view, or simply returning the file path so you can do something else with it. This is built for Ruby developers who use Vim as their editor and want to save the mental overhead of manually navigating directory trees every time they switch between writing code and writing tests. If you are working on a Rails app or a Ruby gem and find yourself constantly hunting through folders to find the spec that matches the class you are editing, this tool removes that friction entirely. One thing to note is that the README mentions this plugin has been folded into a larger project called vim-ruby-conque. If you are considering using it, you might want to look at that combined repository instead, as this standalone version may no longer be actively maintained on its own.

Copy-paste prompts

Prompt 1
Install the vim-spec-finder plugin in my Vim setup and configure a keyboard shortcut to toggle between Ruby source files and their test files.
Prompt 2
Set up vim-spec-finder to open matching spec files in a vertical split window instead of replacing the current buffer when I press the toggle shortcut.
Prompt 3
Configure vim-spec-finder for my Ruby project where tests live in fast_spec instead of spec, and verify it correctly maps lib/foo/bar.rb to fast_spec/lib/foo/bar_spec.rb.
Prompt 4
Check if the vim-ruby-conque project has absorbed vim-spec-finder and help me decide whether I should use the standalone plugin or the combined repository.

Frequently asked questions

What is vim-spec-finder?

A Vim plugin for Ruby developers that automatically switches between source files and their test files with a single shortcut, eliminating manual folder navigation.

What language is vim-spec-finder written in?

Mainly VimL. The stack also includes VimL, Vim, Ruby.

Is vim-spec-finder actively maintained?

Dormant — no commits in 2+ years (last push 2020-05-17).

How hard is vim-spec-finder to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is vim-spec-finder for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.