Mason::Plugin::DollarDot(3pm)

Mason::Plugin::DollarDot3pm

Allow $. as substitution for $self-> and in attribute names

Usage

    <%class>
    has 'name';
    has 'date';
    </%class>
    <%method greet>
    Hello, <% $.name %>. Today is <% $.date %>.
    </%method>
    ...
    % $.greet();
    <%init>
    # Set the date
    $.date(scalar(localtime));
    # or, if combined with LvalueAttributes
    $.date = scalar(localtime);
    </%init>

Overview

This plugin substitutes "$.identifier" for "$self->identifier" in all Perl code inside components, so that $. can be used when referring to attributes and calling methods. The actual regex is

    s/ \$\.([^\W\d]\w*) / \$self->$1 /gx;

Rationale

In Mason 2, components have to write "$self->" a lot to refer to attributes that were simple scalars in Mason 1. This eases the transition pain. $. was chosen because of its similar use in Perl 6.

This plugin falls under the heading of gratuitous source filtering, which the author generally agrees is Evil. That said, this is a very limited filter, and seems unlikely to break any legitimate Perl syntax other than use of the $. special variable (input line number).

Releases

7 releases since Debian 7 (Wheezy); the text changed 4 times.

  1. 7
  2. 8
  3. 9–10
  4. 11
  5. 12–13

Bugs

Will not interpolate as expected inside double quotes:

    "My name is $.name"   # nope

instead you have to do

    "My name is " . $.name

Author

Jonathan Swartz <[email protected]>

From libmason-perl 2.24-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.