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

CTags

by SublimeText ST2/ST3 Top 100

CTags support for Sublime Text 2/3

Details

Installs

  • Total 180K
  • Win 94K
  • OS X 47K
  • Linux 39K
May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27 Apr 26 Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14
Windows 36 53 101 141 151 136 158 145 71 83 126 142 147 133 145 70 53 136 136 158 133 151 67 71 112 164 144 129 75 49 47 109 119 150 132 161 68 90 146 148 119 117 131 58 90 121
OS X 14 11 35 27 37 45 40 31 18 17 30 42 46 45 35 25 23 48 40 33 36 37 22 26 33 42 40 26 18 19 24 45 36 35 45 35 23 24 33 40 37 43 47 13 19 35
Linux 15 23 26 29 35 33 24 24 13 13 34 33 32 42 26 12 25 36 30 34 33 37 22 12 37 37 36 30 25 12 15 47 28 36 46 26 15 14 32 26 36 39 31 19 23 30

Readme

Source
raw.​githubusercontent.​com

CTags

/readmes/img/7551f282e239a6eb6c3a6a6cff1da63e9c0ff51b.svg

About

This Sublime Text 2/3 package provides support for working with tags generated by Exuberant CTags

The ctags command is searched for on the system PATH. It works by doing a binary search of a memory-mapped tags file, so it will work efficiently with very large (50MB+) tags files if needed.

See this forum thread for a bit of historical background on the Sublime Text plugin.

Installation

The easiest way to install this plugin, is to use the Package Control plugin, by Will Bond

Alternatively, the plugin can be installed manually using one of the following methods.

Using Git

Go to your Sublime Text Packages directory and clone the repository using the command below:

$ git clone https://github.com/SublimeText/CTags

Manual Download

  • Download the files using the .zip download option
  • Unzip the files (and rename the folder to CTags if needed)
  • Copy the folder to your Sublime Text Packages directory

Additional Setup Steps

OS X

The default ctags executable in OSX does not support recursive directory search (i.e. ctags -R). To get a proper copy of ctags, use one of the following options:

Ensure that the PATH is updated so the correct version is run:

  • If which ctags doesn't point at ctags in /usr/local/bin, make sure you add /usr/local/bin to your PATH ahead of the folder which ctags reported.
  • Alternatively, add the path to the new ctags executable to the settings, under command. If you have Xcode / Apple Developer Tools installed this path will likely be /usr/local/bin/ctags.

Linux

To install ctags use your package manager.

  • For Debian-based systems (Ubuntu, Mint, etc.):

    sudo apt-get install exuberant-ctags
    
  • For Red Hat-based systems (Red Hat, Fedora, CentOS):

    sudo yum install ctags
    

And so forth

Windows

  • Download the CTags binary from the Exuberant CTags site.
  • Extract ctags.exe from the downloaded zip to C:\Program Files\Sublime Text 2 or any folder within your PATH so that Sublime Text can run it.
  • Alternatively, extract to any folder and add the path to this folder to the command setting.

Usage

This uses tag files created by the ctags -R -f .tags command by default (although this can be overriden in settings).

The plugin will try to find a .tags file in the same directory as the current view, walking up directories until it finds one. If it can't find one it will offer to build one (in the directory of the current view)

If a symbol can't be found in a tags file, it will search in additional locations that are specified in the CTags.sublime-settings file (see below).

If you are a Rubyist, you can build a Ruby Gem's tags with the following script:

require 'bundler'
paths = Bundler.load.specs.map(&:full_gem_path)
system("ctags -R -f .gemtags #{paths.join(' ')}")

Settings

By default, Sublime will include ctags files in your project, which causes them to show up in the file tree and search results. To disable this behaviour you should add a file_exclude_patterns entry to your Preferences.sublime-settings or your project file. For example:

"file_exclude_patterns": [".tags", ".tags_sorted_by_file", ".gemtags"]

In addition to this setting, there's a CTags.sublime-settings file, which can be edited like any other .sublime-settings file

  • filters will allow you to set scope specific filters against a field of the tag. In the excerpt above, imports tags like from a import b are filtered:

    '(?P<symbol>[^\t]+)\t'
    '(?P<filename>[^\t]+)\t'
    '(?P<ex_command>.*?);"\t'
    '(?P<type>[^\t\r\n]+)'
    '(?:\t(?P<fields>.*))?'
    
  • extra_tag_paths is a list of extra places to look for keyed by

  • (selector, platform). Note the platform is tested against sublime.platform() so any values that function returns are valid.

  • extra_tag_files is a list of extra files relative to the original file

  • command is the path to the version of ctags to use, for example:

    "command" : "/usr/local/bin/ctags"
    

    or:

    "command" : "C:\Users\<username>\Downloads\CTags\ctag.exe"
    

The rest of the options are fairly self explanatory.

Support

If there are any problems or you have a suggestion, open an issue, and we will receive a notification.

Thanks :)

Commands Listing

Command Key Binding Alt Binding Mouse Binding
rebuild_ctags ctrl+t, ctrl+r    
navigate_to_definition ctrl+t, ctrl+t ctrl+> ctrl+shift+left_click
jump_prev ctrl+t, ctrl+b ctrl+< ctrl+shift+right_click
show_symbols alt+s    
show_symbols (all files) alt+shift+s    
show_symbols (suffix) ctrl+alt+shift+s