dnscrypt-proxy/vendor/github.com/quasilyte/regex/syntax
Frank Denis 8e913d8bf9 Udate deps 2021-09-24 09:30:49 +02:00
..
LICENSE Update deps 2021-07-03 10:56:53 +02:00
README.md Update deps 2021-07-03 10:56:53 +02:00
ast.go Update deps 2021-07-03 10:56:53 +02:00
errors.go Update deps 2021-07-03 10:56:53 +02:00
lexer.go Update deps 2021-07-03 10:56:53 +02:00
operation.go Update deps 2021-07-03 10:56:53 +02:00
operation_string.go Update deps 2021-07-03 10:56:53 +02:00
parser.go Update deps 2021-07-03 10:56:53 +02:00
pos.go Update deps 2021-07-03 10:56:53 +02:00
tokenkind_string.go Update deps 2021-07-03 10:56:53 +02:00
utils.go Update deps 2021-07-03 10:56:53 +02:00

README.md

Package regex/syntax

Package syntax provides regular expressions parser as well as AST definitions.

Rationale

There are several problems with the stdlib regexp/syntax package:

  1. It does several transformations during the parsing that make it hard to do any kind of syntax analysis afterward.

  2. The AST used there is optimized for the compilation and execution inside the regexp package. It's somewhat complicated, especially in a way character ranges are encoded.

  3. It only supports re2 syntax. This parser recognizes most PCRE operations.

  4. It's easier to extend this package than something from the standard library.

This package does almost no assumptions about how generated AST is going to be used so it preserves as much syntax information as possible.

It's easy to write another intermediate representation on top of it. The main function of this package is to convert a textual regexp pattern into a more structured form that can be processed more easily.