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

Class PythonFlavorProcessor

java.lang.Object

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

All Implemented Interfaces:

RegexFlavorProcessor

public final class PythonFlavorProcessor
extends Object
implements RegexFlavorProcessor

Implements the parsing and translating of Python regular expressions to ECMAScript 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.

See Also:

RegexFlavorProcessor

Constructor Summary

Constructors

Constructor and Description
PythonFlavorProcessor(RegexSource source, PythonREMode mode)

Method Summary

Modifier and Type	Method and Description
com.oracle.truffle.api.interop.TruffleObject	getFlags() Returns a TruffleObject representing the compilation flags which were set for the regular expression.
Map<String,Integer>	getNamedCaptureGroups() Returns a map from the names of capture groups to their indices.
int	getNumberOfCaptureGroups() Returns the number of capture groups contained in the expression, including capture group 0.
boolean	isUnicodePattern() Returns true if the generated ECMAScript pattern is a Unicode pattern (matches Unicode code points instead of UTF-16 code units).
RegexSource	toECMAScriptRegex() Runs the parser and emits an equivalent ECMAScript regex.
void	validate() Runs the parser without trying to find an equivalent ECMAScript regex.

Methods inherited from class java.lang.Object

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

Constructor Detail

PythonFlavorProcessor

public PythonFlavorProcessor(RegexSource source,
                             PythonREMode mode)

Method Detail

getNumberOfCaptureGroups

public int getNumberOfCaptureGroups()

Description copied from interface: RegexFlavorProcessor

Returns the number of capture groups contained in the expression, including capture group 0.

Specified by:

getNumberOfCaptureGroups in interface RegexFlavorProcessor

getNamedCaptureGroups

public Map<String,Integer> getNamedCaptureGroups()

Description copied from interface: RegexFlavorProcessor

Returns a map from the names of capture groups to their indices. If the regular expression had no named capture groups, returns null.

Specified by:

getNamedCaptureGroups in interface RegexFlavorProcessor

getFlags

public com.oracle.truffle.api.interop.TruffleObject getFlags()

Description copied from interface: RegexFlavorProcessor

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.

Specified by:

getFlags in interface RegexFlavorProcessor

isUnicodePattern

public boolean isUnicodePattern()

Description copied from interface: RegexFlavorProcessor

Returns true if the generated ECMAScript pattern is a Unicode pattern (matches Unicode code points instead of UTF-16 code units).

Specified by:

isUnicodePattern in interface RegexFlavorProcessor

validate

public void validate()
              throws RegexSyntaxException

Description copied from interface: RegexFlavorProcessor

Runs the parser without trying to find an equivalent ECMAScript regex. Useful for early error detection.

Specified by:

validate in interface RegexFlavorProcessor

Throws:

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

toECMAScriptRegex

public RegexSource toECMAScriptRegex()
                              throws RegexSyntaxException,
                                     UnsupportedRegexException

Description copied from interface: RegexFlavorProcessor

Runs the parser and emits an equivalent ECMAScript regex.

Specified by:

toECMAScriptRegex in interface RegexFlavorProcessor

Returns:

an ECMAScript RegexSource compatible to the input one

Throws:

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

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