Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 2259a9579a
Fetching contributors…

Cannot retrieve contributors at this time

210 lines (152 sloc) 5.461 kb
#============================================================= -*-Perl-*-
#
# Template::Grammar
#
# DESCRIPTION
# Grammar file for the Template Toolkit language containing token
# definitions and parser state/rules tables generated by Parse::Yapp.
#
# AUTHOR
# Andy Wardley <abw@wardley.org>
#
# COPYRIGHT
# Copyright (C) 1996-2006 Andy Wardley. All Rights Reserved.
# Copyright (C) 1998-2000 Canon Research Centre Europe Ltd.
#
# This module is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.
#
# REVISION
# $Id$
#
# IMPORTANT NOTE
# This module is constructed from the parser/Grammar.pm.skel file by
# running the parser/yc script. You only need to do this if # you
# have modified the grammar in the parser/Parser.yp file and need #
# to-recompile it. See the README in the 'parser' directory for
# more information (sub-directory of the Template distribution).
#
#========================================================================
package Template::Grammar;
use strict;
use warnings;
our $VERSION = 2.25;
my (@RESERVED, %CMPOP, $LEXTABLE, $RULES, $STATES);
my ($factory, $rawstart);
#========================================================================
# Reserved words, comparison and binary operators
#========================================================================
@RESERVED = qw(
GET CALL SET DEFAULT INSERT INCLUDE PROCESS WRAPPER BLOCK END
USE PLUGIN FILTER MACRO PERL RAWPERL TO STEP AND OR NOT DIV MOD
IF UNLESS ELSE ELSIF FOR NEXT WHILE SWITCH CASE META IN
TRY THROW CATCH FINAL LAST RETURN STOP CLEAR VIEW DEBUG
);
# for historical reasons, != and == are converted to ne and eq to perform
# stringwise comparison (mainly because it doesn't generate "non-numerical
# comparison" warnings which != and == can) but the others (e.g. < > <= >=)
# are not converted to their stringwise equivalents. I added 'gt' et al,
# briefly for v2.04d and then took them out again in 2.04e.
%CMPOP = qw(
!= ne
== eq
< <
> >
>= >=
<= <=
);
# eq eq # add these lines to the above to
# lt lt # enable the eq, lt and gt operators
# gt gt
#========================================================================
# Lexer Token Table
#========================================================================
# lookup table used by lexer is initialised with special-cases
$LEXTABLE = {
'FOREACH' => 'FOR',
'BREAK' => 'LAST',
'&&' => 'AND',
'||' => 'OR',
'!' => 'NOT',
'|' => 'FILTER',
'.' => 'DOT',
'_' => 'CAT',
'..' => 'TO',
# ':' => 'MACRO',
'=' => 'ASSIGN',
'=>' => 'ASSIGN',
# '->' => 'ARROW',
',' => 'COMMA',
'\\' => 'REF',
'and' => 'AND', # explicitly specified so that qw( and or
'or' => 'OR', # not ) can always be used in lower case,
'not' => 'NOT', # regardless of ANYCASE flag
'mod' => 'MOD',
'div' => 'DIV',
};
# localise the temporary variables needed to complete lexer table
{
# my @tokens = qw< ( ) [ ] { } ${ $ / ; : ? >;
my @tokens = qw< ( ) [ ] { } ${ $ + / ; : ? >;
my @cmpop = keys %CMPOP;
# my @binop = qw( + - * % ); # '/' above, in @tokens
my @binop = qw( - * % ); # '+' and '/' above, in @tokens
# fill lexer table, slice by slice, with reserved words and operators
@$LEXTABLE{ @RESERVED, @cmpop, @binop, @tokens }
= ( @RESERVED, ('CMPOP') x @cmpop, ('BINOP') x @binop, @tokens );
}
#========================================================================
# CLASS METHODS
#========================================================================
sub new {
my $class = shift;
bless {
LEXTABLE => $LEXTABLE,
STATES => $STATES,
RULES => $RULES,
}, $class;
}
# update method to set package-scoped $factory lexical
sub install_factory {
my ($self, $new_factory) = @_;
$factory = $new_factory;
}
#========================================================================
# States
#========================================================================
$STATES = <<$states>>;
#========================================================================
# Rules
#========================================================================
$RULES = <<$rules>>;
1;
__END__
=head1 NAME
Template::Grammar - Parser state/rule tables for the TT grammar
=head1 SYNOPSIS
# no user serviceable parts inside
=head1 DESCRIPTION
This module defines the state and rule tables that the L<Template::Parser>
module uses to parse templates. It is generated from a YACC-like grammar
using the C<Parse::Yapp> module. The F<parser> sub-directory of the
Template Toolkit source distribution contains the grammar and other
files required to generate this module.
But you don't need to worry about any of that unless you're planning to
modify the Template Toolkit language.
=head1 AUTHOR
Andy Wardley E<lt>abw@wardley.orgE<gt>
L<http://wardley.org/>
=head1 COPYRIGHT
Copyright (C) 1996-2007 Andy Wardley. All Rights Reserved.
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
=head1 SEE ALSO
L<Template::Parser>
=cut
# Local Variables:
# mode: perl
# perl-indent-level: 4
# indent-tabs-mode: nil
# End:
#
# vim: expandtab shiftwidth=4:
Jump to Line
Something went wrong with that request. Please try again.