package Dancer::Handler::Debug;
BEGIN {
$Dancer::Handler::Debug::AUTHORITY = 'cpan:SUKRIA';
}
#ABSTRACT: a debug handler for easy tracing
$Dancer::Handler::Debug::VERSION = '1.3130';
use strict;
use warnings;
use HTTP::Headers;
use HTTP::Server::Simple::PSGI;
use base 'Dancer::Object', 'Dancer::Handler', 'HTTP::Server::Simple::PSGI';
use Dancer::Config 'setting';
use Dancer::SharedData;
sub run {
my ($self, $req) = @_;
my ($method, $path, $query, @env ) = @ARGV;
my $host = "127.0.0.1";
my $port = "3000";
my $env = {
'HTTP_ACCEPT' => '*/*',
'HTTP_HOST' => "$host:$port",
'HTTP_USER_AGENT' => 'curl',
'QUERY_STRING' => $query,
'REMOTE_ADDR' => "$host:$port",
'REMOTE_HOST' => "$host:$port",
'REQUEST_METHOD' => $method,
'REQUEST_URI' => $path,
'SERVER_NAME' => $host,
'SERVER_PORT' => $port,
'SERVER_PROTOCOL' => 'HTTP/1.1',
'SERVER_SOFTWARE' => 'HTTP::Server::Simple/0.41',
'SERVER_URL' => "http://$host:$port/",
map { /=/ ? split /=/, $_, 2 : () } @env
};
$req = Dancer::Request->new(env => $env);
my $headers = HTTP::Headers->new(
'User-Agent' => 'curl',
'Host', "$host:$port",
'Accept', '*/*'
);
$req->headers($headers);
# now simulate a PSGI response for the current request only
my $res = eval { $self->{psgi_app}->($env) }
|| [500, ['Content-Type', 'text/plain'], ["Internal Server Error"]];
$self->_handle_response($res);
print "\n";
return $res;
}
sub start {
my ($self, $req) = @_;
print STDERR ">> Dancer dummy debug server\n" if setting('startup_info');
my $dancer = Dancer::Handler::Debug->new();
my $psgi = sub {
my $env = shift;
my $req = Dancer::Request->new(env => $env);
$dancer->handle_request($req);
};
$dancer->{psgi_app} = $psgi;
$dancer->run($req);
}
sub dance { start(@_) }
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Dancer::Handler::Debug - a debug handler for easy tracing
=head1 VERSION
version 1.3130
=head1 DESCRIPTION
When developing a Dancer application, it can be useful to trace precisely what
happen when a query is processed. This handler is here to provide the developer
with a way to easily run the dancer application with the Perl debugger.
This handler will process only one query, based on the arguments given on
the command line, which must follow the pattern
<verb> <path> <parameter segment> <env variable> <even variable>
=head1 USAGE
# in bin/app.pl
set apphandler => 'Debug';
# then, run the app the following way
perl -d bin/app.pl GET '/some/path/to/test'
# with arguments
perl -d bin/app.pl GET '/some/path/to/test' 'with=parameters&other=42'
# with environment variables
perl -d bin/app.pl GET '/some/path/to/test' '' HTTP_X_REQUESTED_WITH=XMLHttpRequest SERVER_NAME=fake
=head1 AUTHORS
Dancer contributors
=head1 AUTHOR
Dancer Core Developers
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Alexis Sukrieh.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut