Regex Night

Regex night We come together when the code ain't right Regex night And we'll be debuggin' 'til the morning light

Regex Night is a command-line tool to print syntax-highlighted versions of regular expressions and spot errors in them.

Usage

Regex Night main commands are:

• print
• tree
• lint

Each of these commands let you pass a regular expression either on the command-line, via a file or by reading it from stdin:

regexnight print '(foo|bar)'

echo '(foo|bar)' | regexnight print

echo '(foo|bar)' > a_file
regexnight print -f a_file

Passing a regular expression from the command-line is handy for simple regular expressions, but can get complicated when it includes quotes or backslashes as those have to be properly escaped for the shell to pass them unaltered. In these situations it's less error-prone to write the regular expression in a file or just run the command without argument and type in the regular expression.

Examples

Let's have a look at this regex used to match phone numbers:

^\+?(\d[\d-. ]+)?(\([\d-. ]+\))?[\d-. ]+\d$

(Source: https://www.variables.sh/complex-regular-expression-examples/)

regexnight print can produce a colored version of it:

regexnight print '^\+?(\d[\d-. ]+)?(\([\d-. ]+\))?[\d-. ]+\d$'

That's nice but still cryptic. We can get a more readable result with the tree command:

regexnight tree '^\+?(\d[\d-. ]+)?(\([\d-. ]+\))?[\d-. ]+\d$'

Regex Night can also be used to lint regular expressions. Here is a regular expression with an unnecessary extra group:

Hello (?P<name>(?:\w+))!

Running this expression through regexnight lint gives us:

Installation

cargo install regexnight

Known limitations

• Regex Night currently only supports Python regular expression syntax, because this is what I work with every day. Other syntaxes could be added.
• Some aspects of the syntax are not properly supported. For example multi-character escapes.
• There is only one lint check at the moment. More are expected to come.