Scroll to navigation

Mason::Compilation(3pm) User Contributed Perl Documentation Mason::Compilation(3pm)

NAME

Mason::Compilation - Performs compilation of a single component

DESCRIPTION

A new "Mason::Compilation" object is created by Mason::Interp to compile each component.

This class has no public API at this time.

MODIFIABLE METHODS

These methods are not intended to be called externally, but may be useful to modify with method modifiers in plugins and subclasses. Their APIs will be kept as stable as possible.

A list of attribute names that should not be used because they are reserved for built-in attributes or methods: "args", "m", "cmeta", "render", "main", etc.
A list of method names that should not be used because they are reserved for built-in attributes: "args", "m", "cmeta", etc. Not as extensive as bad_attribute_names above because methods like "render" and "main" can be overridden but make no sense as attributes.
The top-level method called to compile the component. Returns the generated component class.
An arrayref of valid named block types: "after", "filter", "method", etc. Add to this list if you want to create your own named blocks (i.e. blocks that take a name argument).
Perl code to be added at the bottom of the class. Empty by default.
Perl code to be added at the top of the class, just after initialization of Moose, $m and other required pieces. By default it consults the class_header parameter.

    # Add to the top of every component class:
    #   use Modern::Perl;
    #   use JSON::XS qw(encode_json decode_json);
    #
    override 'output_class_header' => sub {
        return join( "\n",
            super(),
            'use Modern::Perl;',
            'use JSON::XS qw(encode_json decode_json);' );
    };
    
This method is called on each distinct piece of Perl code in the component. $coderef is a reference to a string containing the code; the method can modify the code as desired. See Mason::Plugin::DollarDot for a sample usage.
An arrayref of valid unnamed block types: "args", "class", "init", etc. Add to this list if you want to create your own unnamed blocks.
An arrayref of valid flags: contains only "extends" at time of writing. Add to this list if you want to create your own flags.

SEE ALSO

Mason

AUTHOR

Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 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.

2022-05-27 perl v5.34.0