com.oracle.truffle.regex.tregex.parser.flavors

Class PythonRegexParser

java.lang.Object

com.oracle.truffle.regex.tregex.parser.flavors.PythonRegexParser

All Implemented Interfaces:

RegexParser, RegexValidator

public final class PythonRegexParser
extends Object
implements RegexValidator, RegexParser

Implements the parsing and validation of Python regular expressions.

The implementation strives to be as close as possible to the behavior of the regex parser that ships with Python 3.7, down to the wording of the error messages.

Field Summary

Fields

Modifier and Type	Field and Description
static String	WORD_BOUNDARY
static Pattern	WORD_CHARS_PATTERN
static String	WORD_NON_BOUNDARY

Method Summary

Modifier and Type	Method and Description
static RegexParser	createParser(RegexLanguage language, RegexSource source, CompilationBuffer compilationBuffer, PythonREMode mode)
static RegexValidator	createValidator(RegexSource source, PythonREMode mode)
AbstractRegexObject	getFlags() Returns a TruffleObject representing the compilation flags which were set for the regular expression.
AbstractRegexObject	getNamedCaptureGroups() Returns a map from the names of capture groups to their indices.
static int	lookupCharacterByName(String characterName)
RegexAST	parse() Runs the parser and produces an AST.
void	validate() Checks the regular expression for syntax errors without building an AST.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WORD_CHARS_PATTERN

public static final Pattern WORD_CHARS_PATTERN

WORD_BOUNDARY

public static final String WORD_BOUNDARY

See Also:

Constant Field Values

WORD_NON_BOUNDARY

public static final String WORD_NON_BOUNDARY

See Also:

Constant Field Values

Method Detail

createValidator

public static RegexValidator createValidator(RegexSource source,
                                             PythonREMode mode)
                                      throws RegexSyntaxException

Throws:

RegexSyntaxException

createParser

public static RegexParser createParser(RegexLanguage language,
                                       RegexSource source,
                                       CompilationBuffer compilationBuffer,
                                       PythonREMode mode)
                                throws RegexSyntaxException

Throws:

RegexSyntaxException

getNamedCaptureGroups

public AbstractRegexObject getNamedCaptureGroups()

Description copied from interface: RegexParser

Returns a map from the names of capture groups to their indices. If the regular expression had no named capture groups, returns null. This method has to be called after calling RegexParser.parse().

Specified by:

getNamedCaptureGroups in interface RegexParser

getFlags

public AbstractRegexObject getFlags()

Description copied from interface: RegexParser

Returns a TruffleObject representing the compilation flags which were set for the regular expression. The returned object responds to 'READ' messages on names which correspond to the names of the flags as used in the language from which the flavor originates. This method has to be called after calling RegexParser.parse().

Specified by:

getFlags in interface RegexParser

validate

public void validate()
              throws RegexSyntaxException

Description copied from interface: RegexValidator

Checks the regular expression for syntax errors without building an AST.

Specified by:

validate in interface RegexValidator

Throws:

RegexSyntaxException - when the pattern or the flags are not well-formed

parse

public RegexAST parse()
               throws RegexSyntaxException,
                      UnsupportedRegexException

Description copied from interface: RegexParser

Runs the parser and produces an AST.

Specified by:

parse in interface RegexParser

Throws:

RegexSyntaxException - when the pattern or the flags are not well-formed

UnsupportedRegexException - when the pattern cannot be translated to an equivalent ECMAScript pattern

lookupCharacterByName

public static int lookupCharacterByName(String characterName)