ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Better​Switch​Header​Implementation

by rwols ST2/ST3

More exhaustive Switch File functionality for the C-family

Details

  • 1.0.0
  • github.​com
  • github.​com
  • 3 months ago
  • 33 minutes ago
  • 2 months ago

Installs

  • Total 49
  • Win 28
  • OS X 9
  • Linux 12
Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8
Windows 0 0 0 0 0 0 0 1 0 0 0 1 0 0 1 1 0 0 0 0 1 1 0 0 1 0 0 0 0 1 0 1 0 1 1 1 0 2 0 0 0 1 0 2 1 2
OS X 0 0 0 1 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 0 0 0 0 0 0 0 1 0 0 0 0
Linux 0 0 0 1 0 1 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

BetterSwitchHeaderImplementation

A simple plugin that “takes over” the menu item in Goto -> Switch File -> Switch Header/Implementation. Actually, it takes over the command that gets invoked by that menu item.

Usage

Just use Switch Header/Implementation like you normally would. That is, either from the menu item in Goto -> Switch File -> Switch Header/Implementation, or by its keybinding, whatever that may be.

For example, if your header file lives in

$project_path/include/awesome/foo.hpp

and your implementation file lives in

$project_path/lib/foo.cpp

then this plugin will actually do the switch.

Two Modes of Operation

When you're in folder mode (you have not opened a .sublime-project file), then the plugin will traverse parent directories. A sanity limit of going up three parent directories is in place. You can change this number in the settings of the plugin, but do not make this number too high, or Sublime might freeze.

If your code base looks like this:

$project_path/include/foo/bar.hpp
$project_path/include/foo/baz/bar.hpp
$project_path/src/bar.cpp

then switching from src/bar.cpp, you'll most likely end up in include/foo/bar.hpp, as that's the first good match. This is the downside of folder mode.

When you're in project mode (you have opened a .sublime-project file), then the plugin will assume that the project file is at the root of the directory, and the search will start there. All candidate files are collected, and if there's more than one candidate file, a quick panel will pop up asking you to select the correct file. From that point on the plugin will always choose your selection for switching. This mode is much more powerful. Use the power of the sublime project file.

Limitations

The plugin might come up with false positives. For example, if your code base looks like this:

$project_path/include/awesome/foo.hpp
$project_path/include/awesome/bar/foo.hpp
$project_path/src/bar/foo.cpp

then switching from include/awesome/foo.hpp, it will open src/bar/foo.cpp. But src/bar/foo.cpp is probably paired with include/awesome/bar/foo.hpp.