Alex Ayars > Devel-Pillbug-0.006 > Devel::Pillbug

Download:
Devel-Pillbug-0.006.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.006   Source  

NAME ^

Devel::Pillbug - Stand-alone HTML::Mason-enabled server

SYNOPSIS ^

Install Devel::Pillbug:

  > perl -MCPAN -e 'install Devel::Pillbug';

Start Devel::Pillbug:

  > pillbug;

All arguments are optional:

  > pillbug -host example.com -port 8080 -docroot /tmp/foo

Do it in Perl:

  use Devel::Pillbug;

  my $port = 8000; # Optional argument, default is 8080

  my $server = Devel::Pillbug->new($port);

  #
  # Optional: Use methods from HTTP::Server::Simple
  #
  # $server->host("example.com");

  #
  # Optional: Override the document root
  #
  # $server->docroot("/tmp/foo");

  #
  # See docs or "pillbug -h" for further options
  #

  $server->run;

DESCRIPTION ^

Devel::Pillbug is a stand-alone HTML::Mason server, extending HTTP::Server::Simple::Mason. It is designed for zero configuration and easy install from CPAN.

The "public_html" or "Sites" directory of the user who launched the process will be used for the default document root. Files ending in "html" are treated as Mason components. These and other behaviors may be overridden as needed.

METHODS ^

See HTTP::Server::Simple and HTTP::Server::Simple::Mason for inherited methods.

CLASS METHODS

INSTANCE METHODS

CONFIGURATION AND ENVIRONMENT ^

The document root must exist and be readable, and Devel::Pillbug must be able to bind to its listen port (default 8080).

BUGS ^

Absolutely...

Currently, several brutish hacks are employed to work around minor issues in modules which Pillbug needs. These hacks will need to go away and/or be revisited over time.

Please use the CPAN RT system or contact me if you find something which isn't working as advertised.

VERSION ^

This document is for version .006 of Devel::Pillbug.

AUTHOR ^

Alex Ayars <pause@nodekit.org>

COPYRIGHT AND LICENSE ^

Copyright (C) 2010, Alex Ayars <pause@nodekit.org>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0 or later. See: http://dev.perl.org/licenses/

SEE ALSO ^

File::HomeDir, Media::Type::Simple, Net::Server::PreFork.

This module extends HTTP::Server::Simple::Mason.

syntax highlighting: