PersistentRegexHighlight

This plugin will allow you to create regular expressions that will highlight for all documents.

Installation

Manual

Clone or copy this repository into the packages directory. By default, they are located at:

• OS X: ~/Library/Application Support/Sublime Text 2/Packages/
• Windows: %APPDATA%/Roaming/Sublime Text 2/Packages/
• Linux: ~/.config/sublime-text-2/Packages/

or

• OS X: ~/Library/Application Support/Sublime Text 3/Packages/
• Windows: %APPDATA%/Roaming/Sublime Text 3/Packages/
• Linux: ~/.config/sublime-text-3/Packages/

Package Control

Installation through package control is recommended. It will handle updating your packages as they become available. To install, do the following.

• In the Command Palette, enter Package Control: Install Package
• Search for PersistentRegexHighlight

Configuration

Settings

regex:

An array of hash entries used to determine what to highlight. For more information about these entries, please see Regex Settings.

enabled:

A boolean value that is used to specify if highlighting is enabled.

on_load:

A boolean value that specifies if highlighting should occur when a view is loaded.

on_modify:

A boolean value that specifies if highlighting should occur as modifications are made.

disable_pattern:

An array containing file patterns to ignore. Note these use Unix style patterns. Patterns are compared against the absolute path for the current file.

max_file_size:

Maximum file size to run the the PersistentRegexHighlight on. Any value less than or equal to zero will be treated as a non limiting value. Default value is 0.

whitelist_folders:

A list of absolute paths, specifying folders to run PersistentRegexHighlight. An empty list will result in PersistentRegexHighlight running on all files (unless limited by the disable_pattern setting).

Regex Settings

pattern:

A string representing a pattern to match. Note that the regex setting must contain either pattern or pattern_scope. If both are specified, pattern will be used.

pattern_scope:

A string specifying a scope to highlight. These are scopes that exist in a .tmLanguage files. If multiple entries in the regex setting contain overlapping scopes, the first will be used. For example, if two entries are specified with different colors, one being constant.language and the other being constant.language.python, which ever appears first will be used to highlight. Note that the regex setting must contain either pattern or pattern_scope. If both are specified, pattern will be used.

ignored_scopes:

An optional parameter where one can specify scopes which will never be matched by the pattern. It is Possible to specify more than one scope. They are separated by whitespace (' ').

ignore_case:

An optional boolean value specifiying if the pattern should ignore case. This only applies if pattern is specified. By default, this is set to false.

color_scope:

An optional parameter specifying the color scope to use. Please note you should specify either color or color_scope. If both are specified, color_scope will be taken over color. This scope should already exist in your color scheme file. For more information, see Specifiying Highlight Color.

color:

An optional parameter specifying a highlight color. Please note you should specify either color or color_scope. If both are specified, color_scope will be taken over color. The value for this entry should be in the form RRBBGG. By specifying this value, a new color scheme file will be generated. Please see Specifiying Highlight Color for more information about specifying a color and the generated file.

underline:

A boolean value specifying if the specified pattern should be underlined rather than highlighted. If this is set to “False”, the entry will be highlighted rather than underlined. This defaults to False.

underline_style:

An optional string specifying the underline style. This value is only used if underline is true. In addition, styles only apply for Sublime Text versions >= 3014. Valid Entries for this field are solid, squiggly, and stippled. Invalid entries will fall back to solid.

Sample Regex Entries

Example specifying various patterns.

{
    "regex": [{
        "pattern": "[Ff]oo",
        "color_scope": "color.scope.name",
        "ignore_case": true
    }, {
        "pattern_scope": "constant.language",
        "color_scope": "constant.language"
    }, {
        "pattern": "SomeUnderlinePattern",
        "underline": true
    }]
}

Example specifying a color scope.

{
    "regex": [{
        "pattern": "[Ff]oo",
        "color_scope": "color.scope.name",
        "ignore_case": true
    }]
}

Example specifying a color.

{
    "regex": [{
        "pattern": "Bar",
        "color": "00FF00",
        "ignore_case": false
    }]
}

Example for excluding a scope.

{
    "regex": [{
        "pattern": "\\t",
        "color": "FF3333",
        "ignore_case": true,
        "ignored_scopes": "text.plain example.scope.name"
    }]
}

Project Specific Settings

All of the above settings can also be specified as part of the project specific settings. These values override any previous values set by higher level settings (user and default). For example, specifying a new regex entry will only highlight entries specified as part of the project specific settings.

"settings":
{
    "PersistentRegexHighlight":
    {
        "enabled": false
    }
}

Specifying Highlight Color

You may specify colors in two ways. You may either specify a color scope or a hex color. See Regex Settings for information on color formatting.

Specifying Scope

Below is a sample entry for specifying a custom scope in the theme file. The scope 'regex.highlight.one' would be used to specify utilization of this coloring.

<dict>
    <key>name</key>
    <string>Regex Highlight</string>
    <key>scope</key>
    <string>regex.highlight.one</string>
    <key>settings</key>
    <dict>
        <key>foreground</key>
        <string>#75715E</string>
    </dict>
</dict>

Specifying Color

Specifying a value for the color key will generate a new color scheme file. This will take the contents of your current color scheme file and write it to Packages/User/ColorScheme/<color_scheme_name_here>. This is done to prevent polluting the default color scheme with the additional values. When this is done, you will be prompted with a dialog box to optionally change your color scheme file to the newly created one.

Troubleshooting

If you are having unexpected behaviors, please do not hesitate to create an issue. When you do, please include the console output, accessible through View -> Show Console or Ctrl/Cmd + ` by default.

Specifying a color

The current libraries included with Sublime Text 2 for some platforms are missing the pyexpat module. To temporarily fix this issue, you will need to place the Python library into the Sublime Library directory. If you already have Python 2.6, like ln -s /usr/lib/python2.6 [Sublime Text 2 Directory]/lib.

For some platforms (tested on Ubuntu 12.04), the Python 2.6 library is no longer available. You may need to find a distribution for yourself for your platform. For Ubuntu users, you may go to Ubuntu Archives. You will then need to extract the files dpkg-deb -x python2.6_2.6.5-1ubuntu6_i386.deb python2.6. Finally, move usr/lib/python2.6 from the extracted files to [Sublime Text 2 Directory]/lib