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.