NAME

Devel::ebug::HTTP - Webserver front end to Devel::ebug

SYNOPSIS

  # it's easier to use the 'ebug_httpd' script
  use Devel::ebug::HTTP;
  my $server = Devel::ebug::HTTP->new();
  $server->port(8080);
  $server->program($filename);
  $server->run();

DESCRIPTION

Accessors

In addition to the accessors defined by the HTTP::Server::Simple::CGI, the following get/set chanined accessors are defined.

program

The name of the program we're running. When run is called an instance of Devel::ebug is created that executes this program.

ebug

The Devel::ebug instance that this front end is displaying.

Internals

Essentially this module is a HTTP::Server::Simple::CGI subclass. The main method is the handle_request method which is called for each request to the websever.

handle_request

Method that's called each individual request that's made to the server from the web browser. This dispatches to all the other methods.

skip_request

Returns true if we should skip the current request and return a 404. Currently used for not creating favicons.

Interacting with ebug

create_ebug

Create a new ebug instance and store it via the ebug accessor.

tell_ebug($what);

Tell the ebug process what's going on.

Creating the HTML/HTTP response

create_output

Create everything that's sent to the client. Calls the other methods documented below.

create_html

Create the html.

codelines

Create the marked up perl code.

header($html)

Return a string that contains the http header for the html that's been passed (including the server status code.)

template

Return the template toolkit template.