git404hub

what is vim-spec-finder fr?

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

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

3VimLAudience · developerComplexity · 1/5DormantSetup · easy

tl;dr

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

vibe map

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

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

what's the stack?

VimLVimRuby

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 5min

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

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.