NAME

       Poet -- a modern Perl web framework for Mason developers

SYNOPSIS

         % poet new MyApp
         my_app/.poet_root
         my_app/bin/app.psgi
         ...

         % my_app/bin/run.pl
         Running plackup --Reload ... --env development --port 5000
         Watching ... for file updates.
         HTTP::Server::PSGI: Accepting connections at http://0:5000/

DESCRIPTION

       Poet is a modern Perl web framework designed especially for Mason developers. It uses
       PSGI/Plack for server integration, Mason for request routing and templating, and a
       selection of best-of-breed CPAN modules for caching, logging and configuration.

FEATURES

       •   A common-sense directory hierarchy for web development

       •   A configuration system that scales elegantly with multiple coders and multiple layers
           (development/production)

       •   Integration with Log4perl for logging, wrapped with dead-simple configuration

       •   Integration with CHI for powerful and flexible caching

       •   The power of Mason, an object-oriented templating system, for request routing and
           content generation

       •   Easy access to common objects and utilities from anywhere in your application

       •   Conventions and defaults based on the author's best practices from over fifteen years
           of Perl web development; and

       •   The freedom to override just about any of Poet's behaviors

DOCUMENTATION

       All documentation is indexed at Poet::Manual.

SUPPORT

       For now Poet will share a mailing list and IRC with Mason. The Mason mailing list is
       "mason-users@lists.sourceforge.net"; you must be subscribed
       <https://lists.sourceforge.net/lists/listinfo/mason-users> to send a message. The Mason
       IRC channel is #mason <irc://irc.perl.org/#mason>.

       Bugs and feature requests will be tracked at RT:

           http://rt.cpan.org/NoAuth/Bugs.html?Dist=Poet
           bug-poet@rt.cpan.org

       The latest source code can be browsed and fetched at:

           http://github.com/jonswar/perl-poet
           git clone git://github.com/jonswar/perl-poet.git

ACKNOWLEDGEMENTS

       Poet was originally designed and developed for the Digital Media group of the Hearst
       Corporation, a diversified media company based in New York City. Many thanks to Hearst for
       agreeing to this open source release. However, Hearst has no direct involvement with this
       open source release and bears no responsibility for its support or maintenance.

SEE ALSO

       Mason, Plack, PSGI

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.