NAME

MooseX::Templated - Template framework for Moose objects

SYNOPSIS

    # Farm/Cow.pm
    package Farm::Cow;
    use Moose;
    with 'MooseX::Templated::Role';

    has 'spots'   => ( is => 'rw' );
    has 'hobbies' => ( is => 'rw', default => sub { ['mooing', 'chewing'] } );

    sub moo { "Moo" }

    # Farm/Cow.tt
    This cow has [% self.spots %] spots - it likes
    [% self.hobbies.join(" and ") %]. 
    [% self.moo %]!

Elsewhere...

    my $cow = Farm::Cow->new( spots => '8' );
    
    $cow->render();
    
    # This cow has 8 spots - it likes
    # mooing and chewing.
    # Moo!

INTERFACE

This module contains no code to speak of - it is just here to provide an obvious root document for the rest of the project.

If you're looking for more details on the interface available for rendering your Moose object with templates then you are probably looking for:

    L<MooseX::Templated::Role>

If you are interested in looking under the bonnet or implementing your own templating engine then you probably want to have a look at:

    L<MooseX::Templated::View>

DISCUSSION

What this module aims to be

The intention of this module is to provide a quick and simple framework to glue all things good about Moose to all things sensible about using templates to separate your internals from your display logic.

It makes some guesses about what your templates are called and where they live and going along with those defaults should get you up and running within a couple lines of code.

If you don't want to go with those default suggestions then the intention is to provide enough flexible to fit in with your setup with the minimum of fuss (if not, then patches/suggestions are always welcome).

What this module doesn't aim to be

This module is not intended to be an attempt at a MVC framework.

If you haven't heard of Catalyst then go have a look.

SEE ALSO

Moose

Please report any bugs or feature requests to bug-moosex-templated@rt.cpan.org, or through the web interface at http://rt.cpan.org.

ACKNOWLEDGEMENTS

Chris Prather (perigrin)

AUTHOR

Ian Sillitoe <isillitoe@cpan.org>

LICENCE AND COPYRIGHT

Copyright (c) 2008, Ian Sillitoe <isillitoe@cpan.org>. All rights reserved.

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