NAME
Mason::Plugin::DollarDot - Allow $. as substitution for $self-> and in attribute names
VERSION
version 2.00
SYNOPSIS
<%args>
$.name
</%args>
<%shared>
$.date
</%shared>
<%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>DESCRIPTION
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;It also allows attributes in <%args> and <%shared> sections to be harmlessly prefixed with $.. The prefix is ignored; this is an optional mnemonic to make the attribute's declaration match its use.
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).
SEE ALSO
AUTHOR
Jonathan Swartz <swartz@pobox.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Jonathan Swartz.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.