bionic (3) Twiggy.3pm.gz

NAME

       Twiggy - AnyEvent HTTP server for PSGI (like Thin)

SYNOPSIS

         twiggy --listen :8080

       See "twiggy -h" for more details.

         use Twiggy::Server;

         my $server = Twiggy::Server->new(
             host => $host,
             port => $port,
         );
         $server->register_service($app);

         AE::cv->recv;

DESCRIPTION

       Twiggy is a lightweight and fast HTTP server with unique features such as:

       PSGI
           Can run any PSGI applications. Fully supports psgi.nonblocking and psgi.streaming interfaces.

       AnyEvent
           This server uses AnyEvent and runs in a non-blocking event loop, so it's best to run event-driven web
           applications that runs I/O bound jobs or delayed responses such as long-poll, WebSocket or streaming
           content (server push).

           This software used to be called Plack::Server::AnyEvent but was renamed to Twiggy. See "NAMING" for
           details.

       Fast header parser
           Uses XS/C based HTTP header parser for the best performance. (optional, install the HTTP::Parser::XS
           module to enable it; see also Plack::HTTPParser for more information).

       Lightweight and Fast
           The memory required to run twiggy is 6MB and it can serve more than 4500 req/s with a single process
           on Perl 5.10 with MacBook Pro 13" late 2009.

       Superdaemon aware
           Supports Server::Starter for hot deploy and graceful restarts.

           To use it, instead of the usual:

               plackup --server Twiggy --port 8111 app.psgi

           install Server::Starter and use:

               start_server --port 8111 plackup --server Twiggy app.psgi

ENVIRONMENT

       The following environment variables are supported.

       TWIGGY_DEBUG
           Set to true to enable debug messages from Twiggy.

NAMING

   Twiggy?
       Because it is like Thin <http://code.macournoyer.com/thin/>, Ruby's Rack web server using EventMachine.
       You know, Twiggy is thin :)

   Why the cute name instead of more descriptive namespace? Are you on drugs?
       I'm sick of naming Perl software like HTTP::Server::PSGI::How::Its::Written::With::What::Module and
       people call it HSPHIWWWM on IRC. It's hard to say on speeches and newbies would ask questions what they
       stand for every day. That's crazy.

       This module actually includes the longer alias and an empty subclass AnyEvent::Server::PSGI for those who
       like to type more ::'s. It would actually help you find this software by searching for PSGI Server
       AnyEvent on CPAN, which i believe is a good thing.

       Yes, maybe I'm on drugs. We'll see.

LICENSE

       This module is licensed under the same terms as Perl itself.

AUTHOR

       Tatsuhiko Miyagawa

       Tokuhiro Matsuno

       Yuval Kogman

       Hideki Yamamura

       Daisuke Maki

SEE ALSO

       Plack AnyEvent Tatsumaki