Skip to content
Extra source code navigation hotkeys
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Default (Linux).sublime-keymap
Default (OSX).sublime-keymap
Default (Windows).sublime-keymap


This is really glorious plugin that provides api used by many other plugins of sublime-enhanced as well as great amount of navigation keyboard shortcuts.




This plugin is part of sublime-enhanced plugin set. You can install sublime-enhanced and this plugin will be installed automatically.

If you would like to install this package separately check "Installing packages separately" section of sublime-enhanced package.


Hit keyboard shortcut to navigate in opened file according to table below.


Description Keyboard shortcuts
Goto block up ctrl+i
Goto block down ctrl+k
Select block up ctrl+shift+i
Select block down ctrl+shift+k
Goto end of next brackets ctrl+alt+\
Goto in brackets forward alt+enter
Goto out of brackets or string forward alt+shift+enter
Goto over next brackets forward ctrl+shift+enter
Goto in brackets backward alt+ctrl+backspace
Goto out of brackets or string backward alt+shift+backspace
Goto over brackets backward alt+ctrl+shift+backspace
Goto matched bracket or quote ctrl+alt+enter
Select in brackets or string alt+ctrl+shift+enter
Select in brackets or string including wrapping alt+ctrl+shift+\
Delete in brackets or string ctrl+alt+shift+/
Select to bracket or quote forward alt+shift+\
Select to bracket or quote backward ctrl+shift+\
Delete brackets or string backward alt+backspace
Delete brackets or string forward ctrl+alt+/
Goto over brackets or string forward alt+ctrl+l
Select brackets or string forward alt+ctrl+shift+l
Goto over brackets or string backward ctrl+alt+j
Select brackets or string backward ctrl+alt+shift+j
Clean brackets or quotes forward ctrl+/
Clean brackets or quotes backward ctrl+backspace
Goto search result forward alt+enter
Goto search result backward alt+shift+enter


Guys, API of this plugin is a bit bloated; sorry for that.

find_matches(view, cursor, expression, options = {})


Find all matches of expression in view according from the cursor and filter it according to options.


  • view - view where to look for brackets

  • cursor - int; point inside view from which expression should be matched

  • expression - string; regexp to match

  • options:

    "backward" - bool; whether to find matches backward or forward from cursor; note that matches will be sorted from closest to most far match.

    "range" - [int, int]; range in view where to look for matches; put a huge attention that view.substr(sublime.Region(*options['range'])) will be called and to find resulting match position you explicitly need to add options['range'][0] manually to match.start(group) or match.end(group)

    "nesting" - how to treat brackets; True - allow matching in brackets; False or "start" - disallow matching in brackets for match.start(0); "end" - disallow matching in brackets for match.end(0); int - disallow matching in brackets for match.start(int); array of int's - disallow matching in brackets for each element of array

    "in_current_nesting" - bool; look only into the current brackets

    "string" - same that "nesting" option do but for string (don't allow specified regexp group to hit string)

    "comment" - same that "nesting" option do but for comment (don't allow specified regexp group to hit comment)

    "scope" - regexp; scope of groups, specified in "scope_groups" should match this regexp; this is useful when you need to match only operators or keyword or another specific scope; if you need to ignore some scope you can specify negative lookahead (e.g. (?!.*operator) - do not match "operator" scope)

    "scope_groups" - same that "nesting" but for "scope" option (scope of specified regexp groups should match "scope" option)

    "cursor" - same that "nesting" but for cursor point (don't allow specified regexp group to be out of cursor according to "backward" option)

    "limit" - how many matches you need


List of matches.


I have find out that regexps is very fast but filtering is very slow and lugs can be noticeable and be really annoying on large files (2k+ lines) even for simple regexps that hit a lot of matches. So specify 'range' and 'limit' where it is possible to reduce execution time.

Probably I'll rewrite this part or whole library in order to minimize execution time and clean out interface of library.


from Expression import expression

class MyCommand(sublime_plugin.TextCommand):
  def run(self, edit):
    # find three last r'("|\')(\s*)(+)' before cursor where (\s*)(+) is not
    # string and (+) is operator

    options = {
      'nesting': False,
      'scope': r'operator',
      'scope_groups': [2],
      'string': [2, 3],
      'limit': 3,
      'backward': True

    print(expression.find_matches(self.view, self.view.sel()[0].b,
      r'("|\')(\s*)(+)', options))
find_match(view, cursor, expression, options = {})


Like find_matches but returns one match or None if no matches found. Just a helper.

get_nesting(view, cursor, search_range = None, options = {}, expression = r'[({[]')


Get position inside of brackets that surrounds cursor. Note that it will return position inside of brackets, e.g. for "(value)" position of "v" and ")" will be returned.


  • view - view where to look for brackets

  • cursor - int, point inside view where to look for brackets

  • search_range - int or array([int, int]) for how many symbols should be analyzed; if array passed, first element will be for backward count, second - for forward count of bytes to be analyzed

  • options - dict with options (see above for options description)

  • expression - regexp to find first bracket


Array with 2 integers or None if nothing was found.


from Expression import expression

class MyCommand(sublime_plugin.TextCommand):
  def run(self, edit):
    cursor = self.view.sel()[0].b
    print(expression.get_nesting(self.view, cursor, 1024, {}, r'\('))

There is a bit more methods but probably I'll add them to "deprecated" as there is no need of them

Additional options for lookup and find_match

Lookup and find match can receive "start" and "end" options which controls resulting "start" and "end" positions.

This options can receive following values:

  • "start" - (default for "start") return position of regexp start

  • "end" - (default for "end") return position of whole regexp end

  • "first_non_empty" - first non-empty group

  • "last_non_empty" - first non-empty group

  • integer - (group number) return position of specified group

  • list of integers - (groups number) return position of first non-empty group


_, position, _ = lookup(self.view, 0, r'\(', {"start": "end"}) # returns position after next parenthesis



You can’t perform that action at this time.