skwp/vim-spec-finder — explained in plain English
Analysis updated 2026-07-11 · repo last pushed 2020-05-17
Toggle between a Ruby source file and its corresponding test file with one keystroke while working in Vim.
Open the matching test file in a split window so you can view code and tests side by side.
Get the file path of the corresponding spec so you can pass it to another tool or command.
| skwp/vim-spec-finder | davidpdrsn/vim-leaderboard | jianyuh/vimbackup | |
|---|---|---|---|
| Stars | 3 | 4 | — |
| Language | VimL | VimL | VimL |
| Last pushed | 2020-05-17 | 2014-11-22 | 2016-09-19 |
| Maintenance | Dormant | Dormant | Dormant |
| Setup difficulty | easy | easy | easy |
| Complexity | 1/5 | 2/5 | 1/5 |
| Audience | developer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Your Ruby project must follow the convention of mirroring spec files under a spec or fast_spec directory.
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.
A Vim plugin for Ruby developers that automatically switches between source files and their test files with a single shortcut, eliminating manual folder navigation.
Mainly VimL. The stack also includes VimL, Vim, Ruby.
Dormant — no commits in 2+ years (last push 2020-05-17).
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.