package Poet;
$Poet::VERSION = '0.16';
use Poet::Environment;
use Method::Signatures::Simple;
use strict;
use warnings;

method import ($class:) {
    my $poet = Poet::Environment->current_env
      or die "environment has not been initialized!";
    $poet->importer->export_to_level( 1, @_ );




=head1 NAME

Poet -- a modern Perl web framework for Mason developers


  % poet new MyApp

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


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



=item *

A common-sense L<directory hierarchy|Poet::Environment> for web development

=item *

A L<configuration system|Poet::Conf> that scales elegantly with multiple coders
and multiple layers (development/production)

=item *

Integration with L<Log4perl|Log::Log4perl> for logging, wrapped with
dead-simple configuration

=item *

Integration with L<CHI|CHI> for powerful and flexible caching

=item *

The power of L<Mason|Mason>, an object-oriented templating system, for request
routing and content generation

=item *

Easy access to common L<objects|Poet::Import/QUICK VARS> and
L<utilities|Poet::Import/UTILITIES> from anywhere in your application

=item *

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

=item *

The freedom to L<override|Poet::Manual::Subclassing> just about any of Poet's



All documentation is indexed at L<Poet::Manual>.

=head1 SUPPORT

For now Poet will share a mailing list and IRC with Mason. The Mason mailing
list is C<>; you must be
L<subscribed|> to send
a message. The Mason IRC channel is L<#mason|irc://>.

Bugs and feature requests will be tracked at RT:

The latest source code can be browsed and fetched at:
    git clone git://


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.

=head1 SEE ALSO

L<Mason|Mason>, L<Plack|Plack>, L<PSGI|PSGI>

=head1 AUTHOR

Jonathan Swartz <>


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.