Poet(3pm)						User Contributed Perl Documentation						 Poet(3pm)

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

       o   A common-sense directory hierarchy for web development

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

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

       o   Integration with CHI for powerful and flexible caching

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

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

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

       o   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.

perl v5.14.2							    2012-06-05								 Poet(3pm)