Stevan Little > CGI-Application-Server-0.03 > CGI::Application::Server

Download:
CGI-Application-Server-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
Stalled  1
View/Report Bugs
Module Version: 0.03   Source   Latest Release: CGI-Application-Server-0.063

NAME ^

CGI::Application::Server - A simple HTTP server for developing with CGI::Application

SYNOPSIS ^

  use CGI::Application::Server;

  my $server = CGI::Application::Server->new();
  $server->document_root('./htdocs');
  $server->entry_points({
      '/index.cgi' => 'MyCGIApp',
      '/admin'     => 'MyCGIApp::Admin'
  });
  $server->run();

DESCRIPTION ^

This is a simple HTTP server for for use during development with CGI::Appliaction. At this moment, it serves our needs in a very basic way. The plan is to release early and release often, and add features when we need them. That said, we welcome any and all patches, tests and feature requests (the ones with which are accompanied by failing tests will get priority).

METHODS ^

new ($port)

This acts just like new for HTTP::Server::Simple, except it will initialize instance slots that we use.

handle_request

This will check the request uri and dispatch appropriately, either to an entry point, or serve a static file (html, jpeg, gif, etc).

entry_points (?$entry_points)

This accepts a HASH reference in $entry_points, which maps server entry points (uri) to CGI::Application class names. See the SYNOPSIS above for an example.

is_valid_entry_point ($uri)

This attempts to match the $uri to an entry point.

document_root (?$document_root)

This is the server's document root where all static files will be served from.

CAVEATS ^

This is a subclass of HTTP::Server::Simple and all of its caveats apply here as well.

BUGS ^

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

CODE COVERAGE ^

I use Devel::Cover to test the code coverage of my tests, below is the Devel::Cover report on this module's test suite.

 ---------------------------- ------ ------ ------ ------ ------ ------ ------
 File                           stmt   bran   cond    sub    pod   time  total
 ---------------------------- ------ ------ ------ ------ ------ ------ ------
 CGI/Application/Server.pm      95.1   79.2   53.3  100.0  100.0  100.0   88.5
 ---------------------------- ------ ------ ------ ------ ------ ------ ------
 Total                          95.1   79.2   53.3  100.0  100.0  100.0   88.5
 ---------------------------- ------ ------ ------ ------ ------ ------ ------

ACKNOWLEDGEMENTS ^

The HTTP response handling was shamelessly stolen from HTTP::Request::AsCGI by chansen

AUTHOR ^

Stevan Little <stevan@iinteractive.com>

Rob Kinyon <rob.kinyon@iinteractive.com>

COPYRIGHT AND LICENSE ^

Copyright 2006 by Infinity Interactive, Inc.

http://www.iinteractive.com

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: