Raku rules


Raku rules are the regular expression, string matching and general-purpose parsing facility of Raku, and are a core part of the language. Since Perl's pattern-matching constructs have exceeded the capabilities of formal regular expressions for some time, Raku documentation refers to them exclusively as regexes, distancing the term from the formal definition.
Raku provides a superset of Perl 5 features with respect to regexes, folding them into a larger framework called rules, which provide the capabilities of a parsing expression grammar, as well as acting as a closure with respect to their lexical scope. Rules are introduced with the rule keyword, which has a usage quite similar to subroutine definitions. Anonymous rules can be introduced with the regex keyword, or simply be used inline as regexes were in Perl 5 via the m or s operators.

History

In Apocalypse 5, a document outlining the preliminary design decisions for Raku pattern matching, Larry Wall enumerated 20 problems with the "current regex culture". Among these were that Perl's regexes were "too compact and 'cute'", had "too much reliance on too few metacharacters", "little support for named captures", "little support for grammars", and "poor integration with 'real' language".
Between late 2004 and mid-2005, a compiler for Raku style rules was developed for the Parrot virtual machine called Parrot Grammar Engine, which was later renamed to the more generic Parser Grammar Engine. PGE is a combination of runtime and compiler for Raku style grammars that allows any parrot-based compiler to use these tools for parsing, and also to provide rules to their runtimes.
Among other Raku features, support for named captures was added to Perl 5.10 in 2007.
In May 2012, the reference implementation of Raku, Rakudo, shipped its Rakudo Star monthly snapshot with a working JSON parser built entirely in Raku rules.

Changes from Perl 5

There are only six unchanged features from Perl 5's regexes:
A few of the most powerful additions include:
The following changes greatly improve the readability of regexes:
Some of the features of Perl 5 regular expressions are more powerful in Raku because of their ability to encapsulate the expanded features of Raku rules. For example, in Perl 5, there were positive and negative lookahead operators and . In Raku these same features exist, but are called and .
However, because before can encapsulate arbitrary rules, it can be used to express lookahead as a syntactic predicate for a grammar. For example, the following parsing expression grammar describes the classic non-context-free language :
S ← & a+ B
A ← a A? b
B ← b B? c
In Raku rules that would be:

rule S
rule A
rule B

Of course, given the ability to mix rules and regular code, that can be simplified even further:

rule S

However, this makes use of assertions, which is a subtly different concept in Raku rules, but more substantially different in parsing theory, making this a semantic rather than syntactic predicate. The most important difference in practice is performance. There is no way for the rule engine to know what conditions the assertion may match, so no optimization of this process can be made.

Integration with Perl

In many languages, regular expressions are entered as strings, which are then passed to library routines that parse and compile them into an internal state. In Perl 5, regular expressions shared some of the lexical analysis with Perl's scanner. This simplified many aspects of regular expression usage, though it added a great deal of complexity to the scanner. In Raku, rules are part of the grammar of the language. No separate parser exists for rules, as it did in Perl 5. This means that code, embedded in rules, is parsed at the same time as the rule itself and its surrounding code. For example, it is possible to nest rules and code without re-invoking the parser:

rule ab

The above is a single block of Raku code that contains an outer rule definition, an inner block of assertion code, and inside of that a regex that contains one more level of assertion.

Implementation

Keywords

There are several keywords used in conjunction with Raku rules:
;regex: A named or anonymous regex that ignores whitespace within the regex by default.
;token: A named or anonymous regex that implies the :ratchet modifier.
;rule: A named or anonymous regex that implies the :ratchet and :sigspace modifiers.
;rx: An anonymous regex that takes arbitrary delimiters such as // where regex only takes braces.
;m: An operator form of anonymous regex that performs matches with arbitrary delimiters.
;mm: Shorthand for m with the :sigspace modifier.
;s: An operator form of anonymous regex that performs substitution with arbitrary delimiters.
;ss: Shorthand for s with the :sigspace modifier.
;/.../: Simply placing a regex between slashes is shorthand for rx/.../.
Here is an example of typical use:

token word
rule phrase
if $string ~~ / \n /

Modifiers

Modifiers may be placed after any of the regex keywords, and before the delimiter. If a regex is named, the modifier comes after the name. Modifiers control the way regexes are parsed and how they behave. They are always introduced with a leading : character.
Some of the more important modifiers include:
For example:

regex addition

Grammars

A grammar may be defined using the grammar operator. A grammar is essentially just a namespace for rules:

grammar Str::SprintfFormat

This is the grammar used to define Perl's sprintf string formatting notation.
Outside of this namespace, you could use these rules like so:

if / /

A rule used in this way is actually identical to the invocation of a subroutine with the extra semantics and side-effects of pattern matching.

Examples

Here are some example rules in Raku:

rx
rx

That last is identical to:

rx