.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Poet 3pm"
.TH Poet 3pm "2022-06-18" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Poet \-\- a modern Perl web framework for Mason developers
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 4
\&  % 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/
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Poet is a modern Perl web framework designed especially for Mason
developers. It uses \s-1PSGI\s0/Plack for server integration, Mason
for request routing and templating, and a selection of best-of-breed \s-1CPAN\s0
modules for caching, logging and configuration.
.SH "FEATURES"
.IX Header "FEATURES"
.IP "\(bu" 4
A common-sense directory hierarchy for web development
.IP "\(bu" 4
A configuration system that scales elegantly with multiple coders
and multiple layers (development/production)
.IP "\(bu" 4
Integration with Log4perl for logging, wrapped with
dead-simple configuration
.IP "\(bu" 4
Integration with \s-1CHI\s0 for powerful and flexible caching
.IP "\(bu" 4
The power of Mason, an object-oriented templating system, for request
routing and content generation
.IP "\(bu" 4
Easy access to common objects and
utilities from anywhere in your application
.IP "\(bu" 4
Conventions and defaults based on the author's best practices from over fifteen
years of Perl web development; and
.IP "\(bu" 4
The freedom to override just about any of Poet's
behaviors
.SH "DOCUMENTATION"
.IX Header "DOCUMENTATION"
All documentation is indexed at Poet::Manual.
.SH "SUPPORT"
.IX Header "SUPPORT"
For now Poet will share a mailing list and \s-1IRC\s0 with Mason. The Mason mailing
list is \f(CW\*(C`mason\-users@lists.sourceforge.net\*(C'\fR; you must be
subscribed <https://lists.sourceforge.net/lists/listinfo/mason-users> to send
a message. The Mason \s-1IRC\s0 channel is #mason <irc://irc.perl.org/#mason>.
.PP
Bugs and feature requests will be tracked at \s-1RT:\s0
.PP
.Vb 2
\&    http://rt.cpan.org/NoAuth/Bugs.html?Dist=Poet
\&    bug\-poet@rt.cpan.org
.Ve
.PP
The latest source code can be browsed and fetched at:
.PP
.Vb 2
\&    http://github.com/jonswar/perl\-poet
\&    git clone git://github.com/jonswar/perl\-poet.git
.Ve
.SH "ACKNOWLEDGEMENTS"
.IX Header "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.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Mason, Plack, \s-1PSGI\s0
.SH "AUTHOR"
.IX Header "AUTHOR"
Jonathan Swartz <swartz@pobox.com>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2012 by Jonathan Swartz.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.