Andy Wardley > Template-Toolkit-2.25 > Template::Plugin::Assert

Download:
Template-Toolkit-2.25.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  53
Open  19
View/Report Bugs
Module Version: 1   Source   Latest Release: Template-Toolkit-2.26

NAME ^

Template::Plugin::Assert - trap undefined values

SYNOPSIS ^

    [% USE assert %]
    
    # throws error if any undefined values are returned
    [% object.assert.method %]
    [% hash.assert.key %]
    [% list.assert.item %]

DESCRIPTION ^

This plugin defines the assert virtual method that can be used to automatically throw errors when undefined values are used.

For example, consider this dotop:

    [% user.name %]

If user.name is an undefined value then TT will silently ignore the fact and print nothing. If you USE the assert plugin then you can add the assert vmethod between the user and name elements, like so:

    [% user.assert.name %]

Now, if user.name is an undefined value, an exception will be thrown:

    assert error - undefined value for name

AUTHOR ^

Andy Wardley <abw@wardley.org> http://wardley.org/

COPYRIGHT ^

Copyright (C) 2008 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.

SEE ALSO ^

Template::Plugin

syntax highlighting: