makefile::ast(3pm) [debian man page]

Makefile::AST(3pm)					User Contributed Perl Documentation					Makefile::AST(3pm)

NAME

       Makefile::AST - AST for (GNU) makefiles

DESCRIPTION

       The structure of this (GNU) makefile AST is designed based on GNU make's data base listing output produced by "--print-data-base".

       This AST library provides the following classes:

       Makefile::AST
	   The primary class for ASTs. Provides interface for node adding and querying, such as "add_implicit_rule", "apply_implicit_rules",
	   "add_explicit_rule", "apply_explicit_rules", "add_var", "add_auto_var", "get_var", as well as lots of other utility functions, like
	   method "eval_var_value" for computing the ultimate values of makefile variables, method "enter_pad" and "leave_pad" for local
	   variable's scoping pad.

       Makefile::AST::Rule::Base
	   This is the base class for the rule nodes in the AST. It has properties like "normal_prereqs", "order_prereqs", "commands", and
	   "colon".

       Makefile::AST::Rule
	   This class represents the de-sugared form of simple rules and implicite rules after application. It inherits from
	   Makefile::AST::Rule::Base, and adds new properties "target" and "other_targets".

       Makefile::AST::Rule::Implicit
	   This class represents the implicit rule nodes in the AST. It inherits from Makefile::AST::Rule::Base, and adds new properties
	   "targets", "match_anything", and "is_terminal".

       Makefile::AST::StemMatch
	   This class encapsulates the file pattern matching (file names containing "%") and stem substitution algorithms.

       Makefile::AST::Variable
	   It represents the makefile variable nodes in the AST, including "name", "value", "flavor", and "origin".

       Makefile::AST::Command
	   Used to encapsulate information regarding makefile rule commands (e.g. command body, command modifiers "@", "-", "+", and etc.) as a
	   whole.

LIMITATIONS AND TODO

       Adding support for other flavors' makes into this AST library should make a huge amount of sense. The most interesting candiate is
       Microsoft's NMAKE.

CODE REPOSITORY

       For the very latest version of this script, check out the source from

       http://github.com/agentzh/makefile-parser-pm <http://github.com/agentzh/makefile-parser-pm>.

       There is anonymous access to all.

AUTHOR

       Zhang "agentzh" Yichun "<agentzh@gmail.com>"

COPYRIGHT AND LICENSE

       Copyright (c) 2007-2008 by Zhang "agentzh" Yichun (agentzh).

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       Makefile::AST::Evaluator, Makefile::Parser::GmakeDB, makesimple, pgmake-db, Makefile::DOM.

perl v5.12.4							    2011-08-17							Makefile::AST(3pm)

Check Out this Related Man Page

Template::Alloy::Compile(3pm)				User Contributed Perl Documentation			     Template::Alloy::Compile(3pm)

NAME

       Template::Alloy::Compile - Compile role - allows for compiling the AST to perl code

DESCRIPTION

       The Template::Alloy::Compile role allows for taking the AST returned by the Parse role, and translating it into a perl code document.  This
       is in contrast Template::Alloy::Play which executes the AST directly.

TODO

       o   Translate compile_RAWPERL to actually output rather than calling play_RAWPERL.

ROLE METHODS

       "compile_tree"
	   Takes an AST returned by parse_tree and translates it into perl code using functions stored in the $DIRECTIVES hashref.

	   A template that looked like the following:

	       Foo
	       [% GET foo %]
	       [% GET bar %]
	       Bar

	   would parse to the following perl code:

	       # Generated by Template::Alloy::Compile v1.001 on Thu Jun  7 12:58:33 2007
	       # From file /home/paul/bar.tt

	       my $blocks = {};
	       my $meta   = {};
	       my $code   = sub {
		   my ($self, $out_ref, $var) = @_;

		   $$out_ref .= 'Foo';

		   # "GET" Line 2 char 2 (chars 6 to 15)
		   $var = $self->play_expr(['foo', 0]);
		   $$out_ref .= defined($var) ? $var : $self->undefined_get(['foo', 0]);

		   # "GET" Line 3 char 2 (chars 22 to 31)
		   $var = $self->play_expr(['bar', 0]);
		   $$out_ref .= defined($var) ? $var : $self->undefined_get(['bar', 0]);

		   $$out_ref .= 'Bar';

		   return 1;
	       };

	       {
		   blocks => $blocks,
		   meta   => $meta,
		   code   => $code,
	       };

	   As you can see the output is quite a bit more complex than the AST, but under mod_perl conditions, the perl will run faster than
	   playing the AST each time.

       "compile_expr"
	   Takes an AST variable or expression and returns perl code that can lookup the variable.

AUTHOR

       Paul Seamons <paul at seamons dot com>

LICENSE

       This module may be distributed under the same terms as Perl itself.

perl v5.10.1							    2008-09-17					     Template::Alloy::Compile(3pm)

Linux and UNIX Man Pages

makefile::ast(3pm) [debian man page]

Check Out this Related Man Page