Public Methods

These methods are called from within the normal flow of MicroMason functionality, and you do not need to invoke them directly.

read()

Clears the variables used to store the file name and first line of a template, so that they can be set by the methods below.

read_file()

Saves the source file name before invoking the standard behavior for this method.

  $mason->compile( file => $filename );
    

read_handle()

Saves the caller's file name before invoking the standard behavior for this method.

  $mason->compile( handle => $filename );
    

read_text()

Saves the caller's file name before invoking the standard behavior for this method.

  $mason->compile( text => $filename );
    

read_inline()

This is similar to read_text, except it adjusts the line numbering to reflect a template that's embdded as a literal text in the Perl code.

  $mason->compile( inline => q{
          My template text goes here.
  } );
    

lex()

Identical to the lex() method provided by the Base class, except that it also inserts a stream of line-number-setting comments into the to-be- compiled Perl code that attempt to re-synchronize the

assembler_rules()

Maps the "line_num" token to a perl line number comment.

Private Methods

_get_external_caller()

Returns the source file and line number of the first item in the function call stack that is not a Text::MicroMason package.