Skip to content

Septh/vscode-regexplus

Repository files navigation

Regex+

Visual Studio Code syntax highlighter for Steve Levithan's Regex+ library, "a template tag for readable, high-performance, native JS regexes with extended syntax, context-aware interpolation, and always-on best practices".

 

Regex+

 


 

screenshot

Usage

This extension highlights Regex+ template strings in JavaScript and TypeScript source files, including their React flavours.

You can also create and edit .regex+ files, their full text is considered a regular expression source. This may help in writing very complex expressions that you can later copy and paste in your JS/TS code (or even read it from disk and feed it to Regex+'s pattern utility).

Be sure to read the docs if you're not familiar with Regex+.

Regex+ is an astonishing piece of software. I highly recommend it you want to be serious about regexes.

screenshot

Configuration

None yet.

Known Issues

Although the full regular expression syntax Regex+ brings is supported, not all its features are yet implemented.

For now, the following restrictions apply:

  • Only the regex, regex(flags) and pattern tagged templates are highlighted. The regex(options) variant and the rewrite utility function are not.

    • To call regex with options and still have your regex syntax highlighted, either make it start with #regex or prefix the actual template with /* regex */:
    // With embedded start comment:
    const re = regex(options)`#regex
    ...
    `
    
    // With prefix comment:
    const re = regex(options)/* regex */`
    ...
    `
  • Only the main Regex+ package is supported. The recursion plugin is not.

  • You cannot rename the imports, they have to be named regex and pattern.

    • If you really want to alias the functions (eg., import { regex as regexplus } from 'regex'), you can still use the comment trick described above.

There is still work in progress and the missing features will be implemented gradually.

Release Notes

1.1.2

Buf fixes and improvements.

About

Syntax highlighting for Regex+ tagged template strings.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors