CGI-PSGI-0.15/000755 000771 000024 00000000000 11564560727 013555 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/.gitignore000644 000771 000024 00000000045 11257024730 015530 0ustar00miyagawastaff000000 000000 META.yml Makefile inc/ pm_to_blib *~ CGI-PSGI-0.15/Changes000644 000771 000024 00000003257 11564560637 015057 0ustar00miyagawastaff000000 000000 Revision history for Perl extension CGI::PSGI 0.15 Tue May 17 13:58:50 PDT 2011 - Updated the list of overriding methods per CGI.pm update - Added a note that you can't use CGI::Pretty (reported by Maestro) 0.14 Sat Dec 25 11:35:52 PST 2010 - Port fixes for header injection from CGI.pm (markstos) 0.13 Sat Oct 30 23:09:06 PDT 2010 - Specify Test::More dep 0.12 Mon Oct 25 11:06:59 PDT 2010 - Strip Status: header since to conform PSGI spec (clkao) 0.11 Sat May 1 04:37:07 PDT 2010 - Upped CGI.pm dependency to 3.33 to fix the upload() issue in perl 5.10 0.10 Wed Mar 31 01:14:43 PDT 2010 - Upped CGI.pm dependency to 3.15, released in 2005 and is core in perl 5.8.8 0.09 Thu Feb 11 14:47:26 PST 2010 - Added ->psgi_redirect to make migration from CGI.pm even easier (markstos) - POD overhaul and improvements (markstos) 0.07 Tue Jan 12 10:21:19 PST 2010 - Unset $CGI::MOD_PERL in case CGI.pm is preloaded by other non-PSGI apps running on Apache (confound, sukria) 0.06 Wed Jan 6 18:12:45 PST 2010 - Added ->env method to access PSGI env from the object. 0.05 Wed Jan 6 00:37:23 PST 2010 - Fixed a bug where uploaded files are not saved in temp files (fujiwara) 0.04 Wed Dec 9 16:37:47 PST 2009 - Added virtual_host to the list because bad CGI.pm uses host() as a function not a method (kazuho) 0.03 Fri Nov 27 17:32:50 JST 2009 - Speicify CGI.pm dependency since older one has different read_from_client params 0.02 Mon Oct 19 20:16:25 PDT 2009 - Fix the test to skip if <= 3.45 not < 3.45 0.01 Fri Sep 25 11:24:24 2009 - original version CGI-PSGI-0.15/inc/000755 000771 000024 00000000000 11564560727 014326 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/lib/000755 000771 000024 00000000000 11564560727 014323 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/Makefile.PL000644 000771 000024 00000000267 11466445735 015536 0ustar00miyagawastaff000000 000000 use inc::Module::Install; name 'CGI-PSGI'; all_from 'lib/CGI/PSGI.pm'; requires 'CGI', '3.33'; build_requires 'Test::More', 0.88; author_tests('xt'); auto_set_repository; WriteAll; CGI-PSGI-0.15/MANIFEST000644 000771 000024 00000001040 11564560710 014671 0ustar00miyagawastaff000000 000000 .gitignore Changes inc/Module/Install.pm inc/Module/Install/AuthorTests.pm inc/Module/Install/Base.pm inc/Module/Install/Can.pm inc/Module/Install/Fetch.pm inc/Module/Install/Makefile.pm inc/Module/Install/Metadata.pm inc/Module/Install/Repository.pm inc/Module/Install/Win32.pm inc/Module/Install/WriteAll.pm lib/CGI/PSGI.pm Makefile.PL MANIFEST This list of files META.yml README t/00_compile.t t/cookie.t t/http.t t/psgi.t t/psgi_headers.t t/redirect.t t/upload.t tools/extract-methods xt/perlcritic.t xt/pod.t xt/podspell.t xt/synopsis.t CGI-PSGI-0.15/META.yml000644 000771 000024 00000001144 11564560727 015026 0ustar00miyagawastaff000000 000000 --- abstract: 'Adapt CGI.pm to the PSGI protocol' author: - 'Tatsuhiko Miyagawa ' build_requires: ExtUtils::MakeMaker: 6.42 Test::More: 0.88 configure_requires: ExtUtils::MakeMaker: 6.42 distribution_type: module generated_by: 'Module::Install version 1.01' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: 1.4 name: CGI-PSGI no_index: directory: - inc - t - xt requires: CGI: 3.33 perl: 5.8.1 resources: license: http://dev.perl.org/licenses/ repository: git://github.com/miyagawa/CGI-PSGI.git version: 0.15 CGI-PSGI-0.15/README000644 000771 000024 00000006037 11466634333 014437 0ustar00miyagawastaff000000 000000 NAME CGI::PSGI - Adapt CGI.pm to the PSGI protocol SYNOPSIS use CGI::PSGI; my $app = sub { my $env = shift; my $q = CGI::PSGI->new($env); return [ $q->psgi_header, [ $body ] ]; }; DESCRIPTION This module is for web application framework developers who currently uses CGI to handle query parameters, and would like for the frameworks to comply with the PSGI protocol. Only slight modifications should be required if the framework is already collecting the body content to print to STDOUT at one place (rather using the print-as-you-go approach). On the other hand, if you are an "end user" of CGI.pm and have a CGI script that you want to run under PSGI web servers, this module might not be what you want. Take a look at CGI::Emulate::PSGI instead. Your application, typically the web application framework adapter should update the code to do "CGI::PSGI->new($env)" instead of "CGI->new" to create a new CGI object. (This is similar to how CGI::Fast object is initialized in a FastCGI environment.) INTERFACES SUPPORTED Only the object-oriented interface of CGI.pm is supported through CGI::PSGI. This means you should always create an object with "CGI::PSGI->new($env)" and should call methods on the object. The function-based interface like "use CGI ':standard'" does not work with this module. METHODS CGI::PSGI adds the following extra methods to CGI.pm: env $env = $cgi->env; Returns the PSGI environment in a hash reference. This allows CGI.pm-based application frameworks such as CGI::Application to access PSGI extensions, typically set by Plack Middleware components. So if you enable Plack::Middleware::Session, your application and plugin developers can access the session via: $cgi->env->{'plack.session'}->get("foo"); Of course this should be coded carefully by checking the existence of "env" method as well as the hash key "plack.session". psgi_header my ($status_code, $headers_aref) = $cgi->psgi_header(%args); Works like CGI.pm's header(), but the return format is modified. It returns an array with the status code and arrayref of header pairs that PSGI requires. If your application doesn't use "$cgi->header", you can ignore this method and generate the status code and headers arrayref another way. psgi_redirect my ($status_code, $headers_aref) = $cgi->psgi_redirect(%args); Works like CGI.pm's redirect(), but the return format is modified. It returns an array with the status code and arrayref of header pairs that PSGI requires. If your application doesn't use "$cgi->redirect", you can ignore this method and generate the status code and headers arrayref another way. AUTHOR Tatsuhiko Miyagawa Mark Stosberg LICENSE This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. SEE ALSO CGI, CGI::Emulate::PSGI CGI-PSGI-0.15/t/000755 000771 000024 00000000000 11564560727 014020 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/tools/000755 000771 000024 00000000000 11564560727 014715 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/xt/000755 000771 000024 00000000000 11564560727 014210 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/xt/perlcritic.t000644 000771 000024 00000000223 11257024730 016516 0ustar00miyagawastaff000000 000000 use strict; use Test::More; eval q{ use Test::Perl::Critic }; plan skip_all => "Test::Perl::Critic is not installed." if $@; all_critic_ok("lib"); CGI-PSGI-0.15/xt/pod.t000644 000771 000024 00000000201 11257024730 015134 0ustar00miyagawastaff000000 000000 use Test::More; eval "use Test::Pod 1.00"; plan skip_all => "Test::Pod 1.00 required for testing POD" if $@; all_pod_files_ok(); CGI-PSGI-0.15/xt/podspell.t000644 000771 000024 00000000342 11257024730 016202 0ustar00miyagawastaff000000 000000 use Test::More; eval q{ use Test::Spelling }; plan skip_all => "Test::Spelling is not installed." if $@; add_stopwords(); set_spell_cmd("aspell -l en list"); all_pod_files_spelling_ok('lib'); __DATA__ Tatsuhiko Miyagawa CGI-PSGI-0.15/xt/synopsis.t000644 000771 000024 00000000160 11257024730 016245 0ustar00miyagawastaff000000 000000 use Test::More; eval "use Test::Synopsis"; plan skip_all => "Test::Synopsis required" if $@; all_synopsis_ok(); CGI-PSGI-0.15/tools/extract-methods000755 000771 000024 00000000477 11564550472 017762 0ustar00miyagawastaff000000 000000 #!perl chomp(my $file = `perldoc -l CGI`); open my $io, "<", $file or die $!; my $sub; while (<$io>) { chomp; /^sub (\w+)/ and $sub = $1; /^}\s*$/ and do { print "$sub\n" if $code{$sub} =~ /([\%\$]ENV|http\()/; undef $sub }; $code{$sub} .= "$_\n" if $sub; /^\s*package [^C]/ and exit; } CGI-PSGI-0.15/t/00_compile.t000644 000771 000024 00000000105 11257024730 016114 0ustar00miyagawastaff000000 000000 use strict; use Test::More tests => 1; BEGIN { use_ok 'CGI::PSGI' } CGI-PSGI-0.15/t/cookie.t000755 000771 000024 00000007735 11257041055 015460 0ustar00miyagawastaff000000 000000 #!/usr/local/bin/perl -w use strict; use Test::More tests => 28; use CGI::Util qw(escape unescape); use POSIX qw(strftime); #----------------------------------------------------------------------------- # make sure module loaded #----------------------------------------------------------------------------- BEGIN {use_ok('CGI::Cookie');} use CGI::PSGI; my @test_cookie = ( 'foo=123; bar=qwerty; baz=wibble; qux=a1', 'foo=123; bar=qwerty; baz=wibble;', 'foo=vixen; bar=cow; baz=bitch; qux=politician', 'foo=a%20phrase; bar=yes%2C%20a%20phrase; baz=%5Ewibble; qux=%27', ); #----------------------------------------------------------------------------- # Test fetch #----------------------------------------------------------------------------- # Breaks encapsulation to easily adapt to CGI.pm's cookie.t my $get_cookie = sub { my $q = CGI::PSGI->new(shift); $q->cookie; %{ $q->{'.cookies'} || {} }; }; my $get_raw_cookie = sub { my $q = CGI::PSGI->new(shift); $q->raw_cookie('dummy'); %{ $q->{'.raw_cookies'} || {} }; }; { # make sure there are no cookies in the environment delete $ENV{HTTP_COOKIE}; delete $ENV{COOKIE}; # now set a cookie in the environment and try again my $env = {}; $env->{HTTP_COOKIE} = $test_cookie[2]; my %result = $get_cookie->($env); ok(eq_set([keys %result], [qw(foo bar baz qux)]), "expected cookies extracted"); is(ref($result{foo}), 'CGI::Cookie', 'Type of objects returned is correct'); is($result{foo}->value, 'vixen', "cookie foo is correct"); is($result{bar}->value, 'cow', "cookie bar is correct"); is($result{baz}->value, 'bitch', "cookie baz is correct"); is($result{qux}->value, 'politician', "cookie qux is correct"); # Delete that and make sure it goes away delete $env->{HTTP_COOKIE}; %result = $get_cookie->($env); ok(keys %result == 0, "No cookies in environment, returns empty list"); # try another cookie in the other environment variable thats supposed to work $env->{COOKIE} = $test_cookie[3]; %result = $get_cookie->($env); ok(eq_set([keys %result], [qw(foo bar baz qux)]), "expected cookies extracted"); is(ref($result{foo}), 'CGI::Cookie', 'Type of objects returned is correct'); is($result{foo}->value, 'a phrase', "cookie foo is correct"); is($result{bar}->value, 'yes, a phrase', "cookie bar is correct"); is($result{baz}->value, '^wibble', "cookie baz is correct"); is($result{qux}->value, "'", "cookie qux is correct"); } #----------------------------------------------------------------------------- # Test raw_fetch #----------------------------------------------------------------------------- { my $env = {}; my %result = $get_raw_cookie->($env); ok(keys %result == 0, "No cookies in environment, returns empty list"); # now set a cookie in the environment and try again $env->{HTTP_COOKIE} = $test_cookie[2]; %result = $get_raw_cookie->($env); ok(eq_set([keys %result], [qw(foo bar baz qux)]), "expected cookies extracted"); is(ref($result{foo}), '', 'Plain scalar returned'); is($result{foo}, 'vixen', "cookie foo is correct"); is($result{bar}, 'cow', "cookie bar is correct"); is($result{baz}, 'bitch', "cookie baz is correct"); is($result{qux}, 'politician', "cookie qux is correct"); # Delete that and make sure it goes away delete $env->{HTTP_COOKIE}; %result = $get_raw_cookie->($env); ok(keys %result == 0, "No cookies in environment, returns empty list"); # try another cookie in the other environment variable thats supposed to work $env->{COOKIE} = $test_cookie[3]; %result = $get_raw_cookie->($env); ok(eq_set([keys %result], [qw(foo bar baz qux)]), "expected cookies extracted"); is(ref($result{foo}), '', 'Plain scalar returned'); is($result{foo}, 'a%20phrase', "cookie foo is correct"); is($result{bar}, 'yes%2C%20a%20phrase', "cookie bar is correct"); is($result{baz}, '%5Ewibble', "cookie baz is correct"); is($result{qux}, '%27', "cookie qux is correct"); } CGI-PSGI-0.15/t/http.t000644 000771 000024 00000001435 11321242112 015137 0ustar00miyagawastaff000000 000000 use Test::More; use CGI::PSGI; use CGI; my $env; $env->{REQUEST_METHOD} = 'GET'; $env->{HTTP_HOST} = 'virtual.example.com:81'; $env->{SERVER_NAME} = 'server.example.com'; $env->{SCRIPT_NAME} = '/cgi-bin/foo.cgi'; $env->{PATH_INFO} = ''; $env->{QUERY_STRING} = ''; $env->{SERVER_PROTOCOL} = 'HTTP/1.0'; $env->{SERVER_PORT} = 8080; $env->{REQUEST_URI} = "$env->{SCRIPT_NAME}$env->{PATH_INFO}?$env->{QUERY_STRING}"; $env->{HTTP_USER_AGENT} = 'Mozilla/5.1'; $env->{HTTP_REFERER} = 'http://localhost/foo'; { my $q = CGI::PSGI->new($env); is $q->server_name, 'server.example.com'; is $q->virtual_host, 'virtual.example.com'; is $q->virtual_port, 81; is $q->user_agent, 'Mozilla/5.1'; is $q->referer, 'http://localhost/foo'; } done_testing; CGI-PSGI-0.15/t/psgi.t000644 000771 000024 00000010372 11466445736 015155 0ustar00miyagawastaff000000 000000 # copy of request.t use strict; use warnings; use Test::More; eval "use 5.008"; plan skip_all => "$@" if $@; plan tests => 36; use CGI::PSGI (); use Config; my $loaded = 1; $| = 1; ######################### End of black magic. # Set up a CGI environment my $env; $env->{REQUEST_METHOD} = 'GET'; $env->{QUERY_STRING} = 'game=chess&game=checkers&weather=dull'; $env->{PATH_INFO} = '/somewhere/else'; $env->{PATH_TRANSLATED} = '/usr/local/somewhere/else'; $env->{SCRIPT_NAME} = '/cgi-bin/foo.cgi'; $env->{SERVER_PROTOCOL} = 'HTTP/1.0'; $env->{SERVER_PORT} = 8080; $env->{SERVER_NAME} = 'the.good.ship.lollypop.com'; $env->{REQUEST_URI} = "$env->{SCRIPT_NAME}$env->{PATH_INFO}?$env->{QUERY_STRING}"; $env->{HTTP_LOVE} = 'true'; my $q = CGI::PSGI->new($env); ok $q,"CGI::new()"; is $q->request_method => 'GET',"CGI::request_method()"; is $q->query_string => 'game=chess;game=checkers;weather=dull',"CGI::query_string()"; is $q->param(), 2,"CGI::param()"; is join(' ',sort $q->param()), 'game weather',"CGI::param()"; is $q->param('game'), 'chess',"CGI::param()"; is $q->param('weather'), 'dull',"CGI::param()"; is join(' ',$q->param('game')), 'chess checkers',"CGI::param()"; ok $q->param(-name=>'foo',-value=>'bar'),'CGI::param() put'; is $q->param(-name=>'foo'), 'bar','CGI::param() get'; is $q->query_string, 'game=chess;game=checkers;weather=dull;foo=bar',"CGI::query_string() redux"; is $q->http('love'), 'true',"CGI::http()"; is $q->script_name, '/cgi-bin/foo.cgi',"CGI::script_name()"; is $q->url, 'http://the.good.ship.lollypop.com:8080/cgi-bin/foo.cgi',"CGI::url()"; is $q->self_url, 'http://the.good.ship.lollypop.com:8080/cgi-bin/foo.cgi/somewhere/else?game=chess;game=checkers;weather=dull;foo=bar', "CGI::url()"; is $q->url(-absolute=>1), '/cgi-bin/foo.cgi','CGI::url(-absolute=>1)'; is $q->url(-relative=>1), 'foo.cgi','CGI::url(-relative=>1)'; is $q->url(-relative=>1,-path=>1), 'foo.cgi/somewhere/else','CGI::url(-relative=>1,-path=>1)'; is $q->url(-relative=>1,-path=>1,-query=>1), 'foo.cgi/somewhere/else?game=chess;game=checkers;weather=dull;foo=bar', 'CGI::url(-relative=>1,-path=>1,-query=>1)'; $q->delete('foo'); ok !$q->param('foo'),'CGI::delete()'; $q->_reset_globals; $env->{QUERY_STRING}='mary+had+a+little+lamb'; ok $q=CGI::PSGI->new($env),"CGI::new() redux"; is join(' ',$q->keywords), 'mary had a little lamb','CGI::keywords'; is join(' ',$q->param('keywords')), 'mary had a little lamb','CGI::keywords'; # test posting $q->_reset_globals; { my $test_string = 'game=soccer&game=baseball&weather=nice'; local $env->{REQUEST_METHOD}='POST'; local $env->{CONTENT_LENGTH}=length($test_string); local $env->{QUERY_STRING}='big_balls=basketball&small_balls=golf'; open my $input, '<', \$test_string; use IO::Handle; $env->{'psgi.input'} = $input; ok $q=CGI::PSGI->new($env),"CGI::new() from POST"; is $q->param('weather'), 'nice',"CGI::param() from POST"; is $q->url_param('big_balls'), 'basketball',"CGI::url_param()"; } # test url_param { local $env->{QUERY_STRING} = 'game=chess&game=checkers&weather=dull'; my $q = CGI::PSGI->new($env); # params present, param and url_param should return true ok $q->param, 'param() is true if parameters'; ok $q->url_param, 'url_param() is true if parameters'; $env->{QUERY_STRING} = ''; $q = CGI::PSGI->new($env); ok !$q->param, 'param() is false if no parameters'; if (eval { CGI->VERSION(3.46) }) { ok !$q->url_param, 'url_param() is false if no parameters'; } else { # CGI.pm before 3.46 had an inconsistency with url_param and an empty # query string my %p = map { $_ => [ $q->url_param($_) ] } $q->url_param; is_deeply \%p, { keywords => [] }; } $env->{QUERY_STRING} = 'tiger dragon'; $q = CGI::PSGI->new($env); is_deeply [$q->$_] => [ 'keywords' ], "$_ with QS='$env->{QUERY_STRING}'" for qw/ param url_param /; is_deeply [ sort $q->$_( 'keywords' ) ], [ qw/ dragon tiger / ], "$_ keywords" for qw/ param url_param /; } { my $q = CGI::PSGI->new($env); $q->charset('utf-8'); my($status, $headers) = $q->psgi_header(-status => 302, -content_type => 'text/plain'); is $status, 302; is_deeply $headers, [ 'Content-Type', 'text/plain; charset=utf-8' ]; } CGI-PSGI-0.15/t/psgi_headers.t000644 000771 000024 00000004200 11505443615 016625 0ustar00miyagawastaff000000 000000 # Test that header generation is spec compliant. # References: # http://www.w3.org/Protocols/rfc2616/rfc2616.html # http://www.w3.org/Protocols/rfc822/3_Lexical.html use strict; use warnings; use Test::More 'no_plan'; use CGI; use CGI::PSGI; # Set up a CGI environment my $env; $env->{REQUEST_METHOD} = 'GET'; $env->{QUERY_STRING} = 'game=chess&game=checkers&weather=dull'; $env->{PATH_INFO} = '/somewhere/else'; $env->{PATH_TRANSLATED} = '/usr/local/somewhere/else'; $env->{SCRIPT_NAME} = '/cgi-bin/foo.cgi'; $env->{SERVER_PROTOCOL} = 'HTTP/1.0'; $env->{SERVER_PORT} = 8080; $env->{SERVER_NAME} = 'the.good.ship.lollypop.com'; $env->{REQUEST_URI} = "$env->{SCRIPT_NAME}$env->{PATH_INFO}?$env->{QUERY_STRING}"; $env->{HTTP_LOVE} = 'true'; my $cgi = CGI::PSGI->new($env); my ($status, $headers) = $cgi->psgi_header( -type => "text/html" ); is_deeply $headers, [ 'Content-Type' => 'text/html; charset=ISO-8859-1' ], 'known header, basic case: type => "text/html"'; eval { $cgi->psgi_header( -type => "text/html".$CGI::CRLF."evil: stuff" ) }; like($@,qr/contains a newline/,'invalid header blows up'); ($status, $headers) = $cgi->psgi_header( -type => "text/html".$CGI::CRLF." evil: stuff " ); like $headers->[1], qr#text/html evil: stuff#, 'known header, with leading and trailing whitespace on the continuation line'; eval { $cgi->psgi_header( -foobar => "text/html".$CGI::CRLF."evil: stuff" ) }; like($@,qr/contains a newline/,'unknown header with CRLF embedded blows up'); eval { $cgi->psgi_header( -foobar => "\nContent-type: evil/header" ) }; like($@,qr/contains a newline/,'header with leading newline blows up'); eval { $cgi->psgi_redirect( -type => "text/html".$CGI::CRLF."evil: stuff" ), }; like($@,qr/contains a newline/,'redirect with known header with CRLF embedded blows up'); eval { $cgi->psgi_redirect( -foobar => "text/html".$CGI::CRLF."evil: stuff" ) }; like($@,qr/contains a newline/,'redirect with unknown header with CRLF embedded blows up'); eval { $cgi->psgi_redirect( $CGI::CRLF.$CGI::CRLF."Content-Type: text/html") }; like($@,qr/contains a newline/,'redirect with leading newlines blows up'); CGI-PSGI-0.15/t/redirect.t000644 000771 000024 00000003410 11466445736 016007 0ustar00miyagawastaff000000 000000 use strict; use warnings; use Test::More; eval "use 5.008"; plan skip_all => "$@" if $@; plan tests => 6; #plan 'no_plan'; use CGI::PSGI (); # Set up a CGI environment my $env; $env->{REQUEST_METHOD} = 'GET'; $env->{QUERY_STRING} = 'game=chess&game=checkers&weather=dull'; $env->{PATH_INFO} = '/somewhere/else'; $env->{PATH_TRANSLATED} = '/usr/local/somewhere/else'; $env->{SCRIPT_NAME} = '/cgi-bin/foo.cgi'; $env->{SERVER_PROTOCOL} = 'HTTP/1.0'; $env->{SERVER_PORT} = 8080; $env->{SERVER_NAME} = 'the.good.ship.lollypop.com'; $env->{REQUEST_URI} = "$env->{SCRIPT_NAME}$env->{PATH_INFO}?$env->{QUERY_STRING}"; $env->{HTTP_LOVE} = 'true'; my $q = CGI::PSGI->new($env); # These first tree tests are ported from CGI.pm's 'function.t' { my $test = 'psgi_redirect($url)'; my ($status,$headers) = $q->psgi_redirect('http://somewhere.else'); is($status, 302, "$test - default status"); is_deeply $headers, [ 'Location' => 'http://somewhere.else' ], "$test - headers array"; } { my $test = 'psgi_redirect() with content type'; my ($status,$headers) = $q->psgi_redirect( -Location=>'http://somewhere.else',-Type=>'text/html'); is($status, 302, "$test - status"); is_deeply $headers, [ 'Location' => 'http://somewhere.else', 'Content-Type' => 'text/html; charset=ISO-8859-1', ], "$test - headers array"; } { my $test = "psgi_redirect() with path and query string"; my ($status,$headers) = $q->psgi_redirect( -Location=>'http://somewhere.else/bin/foo&bar',-Type=>'text/html'); is($status, 302, "$test - status"); is_deeply $headers, [ 'Location' => 'http://somewhere.else/bin/foo&bar', 'Content-Type' => 'text/html; charset=ISO-8859-1', ], "$test - headers array"; } CGI-PSGI-0.15/t/upload.t000644 000771 000024 00000001532 11321045670 015454 0ustar00miyagawastaff000000 000000 use strict; use Test::More; use CGI::PSGI; use CGI; use IO::Handle; my $content = do { local $/; }; $content =~ s/\x0A/\x0D\x0A/g; # LF => CR+LF open my $input, "<", \$content; my $env = { 'CONTENT_LENGTH' => length $content, 'CONTENT_TYPE' => 'multipart/form-data; boundary=----BOUNDARY', 'REQUEST_METHOD' => 'POST', 'SERVER_PROTOCOL' => 'HTTP/1.0', 'psgi.input' => $input, }; { my $q = CGI::PSGI->new($env); is $q->param("bar"), "BAR"; my $fh = $q->upload("upload_foo"); is $fh, "foo.txt"; isa_ok $fh, "Fh"; my $body = do { local $/; <$fh> }; is $body, "FOO"; } done_testing; __DATA__ ------BOUNDARY Content-Disposition: form-data; name="upload_foo"; filename="foo.txt" Content-Type: text/plain FOO ------BOUNDARY Content-Disposition: form-data; name="bar" BAR ------BOUNDARY-- CGI-PSGI-0.15/lib/CGI/000755 000771 000024 00000000000 11564560727 014725 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/lib/CGI/PSGI.pm000644 000771 000024 00000022174 11564560713 016026 0ustar00miyagawastaff000000 000000 package CGI::PSGI; use strict; use 5.008_001; our $VERSION = '0.15'; use base qw(CGI); sub new { my($class, $env) = @_; CGI::initialize_globals(); my $self = bless { psgi_env => $env, use_tempfile => 1, }, $class; local *ENV = $env; local $CGI::MOD_PERL = 0; $self->SUPER::init; $self; } sub env { $_[0]->{psgi_env}; } sub read_from_client { my($self, $buff, $len, $offset) = @_; $self->{psgi_env}{'psgi.input'}->read($$buff, $len, $offset); } # copied from CGI.pm sub read_from_stdin { my($self, $buff) = @_; my($eoffound) = 0; my($localbuf) = ''; my($tempbuf) = ''; my($bufsiz) = 1024; my($res); while ($eoffound == 0) { $res = $self->{psgi_env}{'psgi.input'}->read($tempbuf, $bufsiz, 0); if ( !defined($res) ) { # TODO: how to do error reporting ? $eoffound = 1; last; } if ( $res == 0 ) { $eoffound = 1; last; } $localbuf .= $tempbuf; } $$buff = $localbuf; return $res; } # copied and rearanged from CGI::header sub psgi_header { my($self, @p) = @_; my(@header); my($type,$status,$cookie,$target,$expires,$nph,$charset,$attachment,$p3p,@other) = CGI::rearrange([['TYPE','CONTENT_TYPE','CONTENT-TYPE'], 'STATUS',['COOKIE','COOKIES'],'TARGET', 'EXPIRES','NPH','CHARSET', 'ATTACHMENT','P3P'],@p); # CR escaping for values, per RFC 822 for my $header ($type,$status,$cookie,$target,$expires,$nph,$charset,$attachment,$p3p,@other) { if (defined $header) { # From RFC 822: # Unfolding is accomplished by regarding CRLF immediately # followed by a LWSP-char as equivalent to the LWSP-char. $header =~ s/$CGI::CRLF(\s)/$1/g; # All other uses of newlines are invalid input. if ($header =~ m/$CGI::CRLF|\015|\012/) { # shorten very long values in the diagnostic $header = substr($header,0,72).'...' if (length $header > 72); die "Invalid header value contains a newline not followed by whitespace: $header"; } } } $type ||= 'text/html' unless defined($type); if (defined $charset) { $self->charset($charset); } else { $charset = $self->charset if $type =~ /^text\//; } $charset ||= ''; # rearrange() was designed for the HTML portion, so we # need to fix it up a little. my @other_headers; for (@other) { # Don't use \s because of perl bug 21951 next unless my($header,$value) = /([^ \r\n\t=]+)=\"?(.+?)\"?$/; $header =~ s/^(\w)(.*)/"\u$1\L$2"/e; push @other_headers, $header, $self->unescapeHTML($value); } $type .= "; charset=$charset" if $type ne '' and $type !~ /\bcharset\b/ and defined $charset and $charset ne ''; # Maybe future compatibility. Maybe not. my $protocol = $self->{psgi_env}{SERVER_PROTOCOL} || 'HTTP/1.0'; push(@header, "Window-Target", $target) if $target; if ($p3p) { $p3p = join ' ',@$p3p if ref($p3p) eq 'ARRAY'; push(@header,"P3P", qq(policyref="/w3c/p3p.xml", CP="$p3p")); } # push all the cookies -- there may be several if ($cookie) { my(@cookie) = ref($cookie) && ref($cookie) eq 'ARRAY' ? @{$cookie} : $cookie; for (@cookie) { my $cs = UNIVERSAL::isa($_,'CGI::Cookie') ? $_->as_string : $_; push(@header,"Set-Cookie", $cs) if $cs ne ''; } } # if the user indicates an expiration time, then we need # both an Expires and a Date header (so that the browser is # uses OUR clock) push(@header,"Expires", CGI::expires($expires,'http')) if $expires; push(@header,"Date", CGI::expires(0,'http')) if $expires || $cookie || $nph; push(@header,"Pragma", "no-cache") if $self->cache(); push(@header,"Content-Disposition", "attachment; filename=\"$attachment\"") if $attachment; push(@header, @other_headers); push(@header,"Content-Type", $type) if $type ne ''; $status ||= "200"; $status =~ s/\D*$//; return $status, \@header; } # Ported from CGI.pm's redirect() method. sub psgi_redirect { my ($self,@p) = @_; my($url,$target,$status,$cookie,$nph,@other) = CGI::rearrange([['LOCATION','URI','URL'],'TARGET','STATUS',['COOKIE','COOKIES'],'NPH'],@p); $status = '302 Found' unless defined $status; $url ||= $self->self_url; my(@o); for (@other) { tr/\"//d; push(@o,split("=",$_,2)); } unshift(@o, '-Status' => $status, '-Location'=> $url, '-nph' => $nph); unshift(@o,'-Target'=>$target) if $target; unshift(@o,'-Type'=>''); my @unescaped; unshift(@unescaped,'-Cookie'=>$cookie) if $cookie; return $self->psgi_header((map {$self->unescapeHTML($_)} @o),@unescaped); } # The list is auto generated and modified with: # perl -nle '/^sub (\w+)/ and $sub=$1; \ # /^}\s*$/ and do { print $sub if $code{$sub} =~ /([\%\$]ENV|http\()/; undef $sub };\ # $code{$sub} .= "$_\n" if $sub; \ # /^\s*package [^C]/ and exit' \ # `perldoc -l CGI` for my $method (qw( url_param url cookie raw_cookie _name_and_path_from_env request_method content_type path_translated request_uri Accept user_agent virtual_host remote_host remote_addr referrer server_name server_software virtual_port server_port server_protocol http https remote_ident auth_type remote_user user_name read_multipart read_multipart_related )) { no strict 'refs'; *$method = sub { my $self = shift; my $super = "SUPER::$method"; local *ENV = $self->{psgi_env}; $self->$super(@_); }; } sub DESTROY { my $self = shift; CGI::initialize_globals(); } 1; __END__ =encoding utf-8 =for stopwords =head1 NAME CGI::PSGI - Adapt CGI.pm to the PSGI protocol =head1 SYNOPSIS use CGI::PSGI; my $app = sub { my $env = shift; my $q = CGI::PSGI->new($env); return [ $q->psgi_header, [ $body ] ]; }; =head1 DESCRIPTION This module is for web application framework developers who currently uses L to handle query parameters, and would like for the frameworks to comply with the L protocol. Only slight modifications should be required if the framework is already collecting the body content to print to STDOUT at one place (rather using the print-as-you-go approach). On the other hand, if you are an "end user" of CGI.pm and have a CGI script that you want to run under PSGI web servers, this module might not be what you want. Take a look at L instead. Your application, typically the web application framework adapter should update the code to do C<< CGI::PSGI->new($env) >> instead of C<< CGI->new >> to create a new CGI object. (This is similar to how L object is initialized in a FastCGI environment.) =head1 INTERFACES SUPPORTED Only the object-oriented interface of CGI.pm is supported through CGI::PSGI. This means you should always create an object with C<< CGI::PSGI->new($env) >> and should call methods on the object. The function-based interface like C<< use CGI ':standard' >> does not work with this module. =head1 METHODS CGI::PSGI adds the following extra methods to CGI.pm: =head2 env $env = $cgi->env; Returns the PSGI environment in a hash reference. This allows CGI.pm-based application frameworks such as L to access PSGI extensions, typically set by Plack Middleware components. So if you enable L, your application and plugin developers can access the session via: $cgi->env->{'plack.session'}->get("foo"); Of course this should be coded carefully by checking the existence of C method as well as the hash key C. =head2 psgi_header my ($status_code, $headers_aref) = $cgi->psgi_header(%args); Works like CGI.pm's L, but the return format is modified. It returns an array with the status code and arrayref of header pairs that PSGI requires. If your application doesn't use C<< $cgi->header >>, you can ignore this method and generate the status code and headers arrayref another way. =head2 psgi_redirect my ($status_code, $headers_aref) = $cgi->psgi_redirect(%args); Works like CGI.pm's L, but the return format is modified. It returns an array with the status code and arrayref of header pairs that PSGI requires. If your application doesn't use C<< $cgi->redirect >>, you can ignore this method and generate the status code and headers arrayref another way. =head1 LIMITATIONS Do not use L or something similar in your controller. The module messes up L's DIY autoloader and breaks CGI::PSGI (and potentially other) inheritance. =head1 AUTHOR Tatsuhiko Miyagawa Emiyagawa@bulknews.netE Mark Stosberg Emark@summersault.comE =head1 LICENSE This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =head1 SEE ALSO L, L =cut CGI-PSGI-0.15/inc/Module/000755 000771 000024 00000000000 11564560727 015553 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/inc/Module/Install/000755 000771 000024 00000000000 11564560727 017161 5ustar00miyagawastaff000000 000000 CGI-PSGI-0.15/inc/Module/Install.pm000644 000771 000024 00000030135 11564560726 017520 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install; # For any maintainers: # The load order for Module::Install is a bit magic. # It goes something like this... # # IF ( host has Module::Install installed, creating author mode ) { # 1. Makefile.PL calls "use inc::Module::Install" # 2. $INC{inc/Module/Install.pm} set to installed version of inc::Module::Install # 3. The installed version of inc::Module::Install loads # 4. inc::Module::Install calls "require Module::Install" # 5. The ./inc/ version of Module::Install loads # } ELSE { # 1. Makefile.PL calls "use inc::Module::Install" # 2. $INC{inc/Module/Install.pm} set to ./inc/ version of Module::Install # 3. The ./inc/ version of Module::Install loads # } use 5.005; use strict 'vars'; use Cwd (); use File::Find (); use File::Path (); use vars qw{$VERSION $MAIN}; BEGIN { # All Module::Install core packages now require synchronised versions. # This will be used to ensure we don't accidentally load old or # different versions of modules. # This is not enforced yet, but will be some time in the next few # releases once we can make sure it won't clash with custom # Module::Install extensions. $VERSION = '1.01'; # Storage for the pseudo-singleton $MAIN = undef; *inc::Module::Install::VERSION = *VERSION; @inc::Module::Install::ISA = __PACKAGE__; } sub import { my $class = shift; my $self = $class->new(@_); my $who = $self->_caller; #------------------------------------------------------------- # all of the following checks should be included in import(), # to allow "eval 'require Module::Install; 1' to test # installation of Module::Install. (RT #51267) #------------------------------------------------------------- # Whether or not inc::Module::Install is actually loaded, the # $INC{inc/Module/Install.pm} is what will still get set as long as # the caller loaded module this in the documented manner. # If not set, the caller may NOT have loaded the bundled version, and thus # they may not have a MI version that works with the Makefile.PL. This would # result in false errors or unexpected behaviour. And we don't want that. my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm'; unless ( $INC{$file} ) { die <<"END_DIE" } Please invoke ${\__PACKAGE__} with: use inc::${\__PACKAGE__}; not: use ${\__PACKAGE__}; END_DIE # This reportedly fixes a rare Win32 UTC file time issue, but # as this is a non-cross-platform XS module not in the core, # we shouldn't really depend on it. See RT #24194 for detail. # (Also, this module only supports Perl 5.6 and above). eval "use Win32::UTCFileTime" if $^O eq 'MSWin32' && $] >= 5.006; # If the script that is loading Module::Install is from the future, # then make will detect this and cause it to re-run over and over # again. This is bad. Rather than taking action to touch it (which # is unreliable on some platforms and requires write permissions) # for now we should catch this and refuse to run. if ( -f $0 ) { my $s = (stat($0))[9]; # If the modification time is only slightly in the future, # sleep briefly to remove the problem. my $a = $s - time; if ( $a > 0 and $a < 5 ) { sleep 5 } # Too far in the future, throw an error. my $t = time; if ( $s > $t ) { die <<"END_DIE" } Your installer $0 has a modification time in the future ($s > $t). This is known to create infinite loops in make. Please correct this, then run $0 again. END_DIE } # Build.PL was formerly supported, but no longer is due to excessive # difficulty in implementing every single feature twice. if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" } Module::Install no longer supports Build.PL. It was impossible to maintain duel backends, and has been deprecated. Please remove all Build.PL files and only use the Makefile.PL installer. END_DIE #------------------------------------------------------------- # To save some more typing in Module::Install installers, every... # use inc::Module::Install # ...also acts as an implicit use strict. $^H |= strict::bits(qw(refs subs vars)); #------------------------------------------------------------- unless ( -f $self->{file} ) { foreach my $key (keys %INC) { delete $INC{$key} if $key =~ /Module\/Install/; } local $^W; require "$self->{path}/$self->{dispatch}.pm"; File::Path::mkpath("$self->{prefix}/$self->{author}"); $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self ); $self->{admin}->init; @_ = ($class, _self => $self); goto &{"$self->{name}::import"}; } local $^W; *{"${who}::AUTOLOAD"} = $self->autoload; $self->preload; # Unregister loader and worker packages so subdirs can use them again delete $INC{'inc/Module/Install.pm'}; delete $INC{'Module/Install.pm'}; # Save to the singleton $MAIN = $self; return 1; } sub autoload { my $self = shift; my $who = $self->_caller; my $cwd = Cwd::cwd(); my $sym = "${who}::AUTOLOAD"; $sym->{$cwd} = sub { my $pwd = Cwd::cwd(); if ( my $code = $sym->{$pwd} ) { # Delegate back to parent dirs goto &$code unless $cwd eq $pwd; } unless ($$sym =~ s/([^:]+)$//) { # XXX: it looks like we can't retrieve the missing function # via $$sym (usually $main::AUTOLOAD) in this case. # I'm still wondering if we should slurp Makefile.PL to # get some context or not ... my ($package, $file, $line) = caller; die <<"EOT"; Unknown function is found at $file line $line. Execution of $file aborted due to runtime errors. If you're a contributor to a project, you may need to install some Module::Install extensions from CPAN (or other repository). If you're a user of a module, please contact the author. EOT } my $method = $1; if ( uc($method) eq $method ) { # Do nothing return; } elsif ( $method =~ /^_/ and $self->can($method) ) { # Dispatch to the root M:I class return $self->$method(@_); } # Dispatch to the appropriate plugin unshift @_, ( $self, $1 ); goto &{$self->can('call')}; }; } sub preload { my $self = shift; unless ( $self->{extensions} ) { $self->load_extensions( "$self->{prefix}/$self->{path}", $self ); } my @exts = @{$self->{extensions}}; unless ( @exts ) { @exts = $self->{admin}->load_all_extensions; } my %seen; foreach my $obj ( @exts ) { while (my ($method, $glob) = each %{ref($obj) . '::'}) { next unless $obj->can($method); next if $method =~ /^_/; next if $method eq uc($method); $seen{$method}++; } } my $who = $self->_caller; foreach my $name ( sort keys %seen ) { local $^W; *{"${who}::$name"} = sub { ${"${who}::AUTOLOAD"} = "${who}::$name"; goto &{"${who}::AUTOLOAD"}; }; } } sub new { my ($class, %args) = @_; delete $INC{'FindBin.pm'}; { # to suppress the redefine warning local $SIG{__WARN__} = sub {}; require FindBin; } # ignore the prefix on extension modules built from top level. my $base_path = Cwd::abs_path($FindBin::Bin); unless ( Cwd::abs_path(Cwd::cwd()) eq $base_path ) { delete $args{prefix}; } return $args{_self} if $args{_self}; $args{dispatch} ||= 'Admin'; $args{prefix} ||= 'inc'; $args{author} ||= ($^O eq 'VMS' ? '_author' : '.author'); $args{bundle} ||= 'inc/BUNDLES'; $args{base} ||= $base_path; $class =~ s/^\Q$args{prefix}\E:://; $args{name} ||= $class; $args{version} ||= $class->VERSION; unless ( $args{path} ) { $args{path} = $args{name}; $args{path} =~ s!::!/!g; } $args{file} ||= "$args{base}/$args{prefix}/$args{path}.pm"; $args{wrote} = 0; bless( \%args, $class ); } sub call { my ($self, $method) = @_; my $obj = $self->load($method) or return; splice(@_, 0, 2, $obj); goto &{$obj->can($method)}; } sub load { my ($self, $method) = @_; $self->load_extensions( "$self->{prefix}/$self->{path}", $self ) unless $self->{extensions}; foreach my $obj (@{$self->{extensions}}) { return $obj if $obj->can($method); } my $admin = $self->{admin} or die <<"END_DIE"; The '$method' method does not exist in the '$self->{prefix}' path! Please remove the '$self->{prefix}' directory and run $0 again to load it. END_DIE my $obj = $admin->load($method, 1); push @{$self->{extensions}}, $obj; $obj; } sub load_extensions { my ($self, $path, $top) = @_; my $should_reload = 0; unless ( grep { ! ref $_ and lc $_ eq lc $self->{prefix} } @INC ) { unshift @INC, $self->{prefix}; $should_reload = 1; } foreach my $rv ( $self->find_extensions($path) ) { my ($file, $pkg) = @{$rv}; next if $self->{pathnames}{$pkg}; local $@; my $new = eval { local $^W; require $file; $pkg->can('new') }; unless ( $new ) { warn $@ if $@; next; } $self->{pathnames}{$pkg} = $should_reload ? delete $INC{$file} : $INC{$file}; push @{$self->{extensions}}, &{$new}($pkg, _top => $top ); } $self->{extensions} ||= []; } sub find_extensions { my ($self, $path) = @_; my @found; File::Find::find( sub { my $file = $File::Find::name; return unless $file =~ m!^\Q$path\E/(.+)\.pm\Z!is; my $subpath = $1; return if lc($subpath) eq lc($self->{dispatch}); $file = "$self->{path}/$subpath.pm"; my $pkg = "$self->{name}::$subpath"; $pkg =~ s!/!::!g; # If we have a mixed-case package name, assume case has been preserved # correctly. Otherwise, root through the file to locate the case-preserved # version of the package name. if ( $subpath eq lc($subpath) || $subpath eq uc($subpath) ) { my $content = Module::Install::_read($subpath . '.pm'); my $in_pod = 0; foreach ( split //, $content ) { $in_pod = 1 if /^=\w/; $in_pod = 0 if /^=cut/; next if ($in_pod || /^=cut/); # skip pod text next if /^\s*#/; # and comments if ( m/^\s*package\s+($pkg)\s*;/i ) { $pkg = $1; last; } } } push @found, [ $file, $pkg ]; }, $path ) if -d $path; @found; } ##################################################################### # Common Utility Functions sub _caller { my $depth = 0; my $call = caller($depth); while ( $call eq __PACKAGE__ ) { $depth++; $call = caller($depth); } return $call; } # Done in evals to avoid confusing Perl::MinimumVersion eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@; sub _read { local *FH; open( FH, '<', $_[0] ) or die "open($_[0]): $!"; my $string = do { local $/; }; close FH or die "close($_[0]): $!"; return $string; } END_NEW sub _read { local *FH; open( FH, "< $_[0]" ) or die "open($_[0]): $!"; my $string = do { local $/; }; close FH or die "close($_[0]): $!"; return $string; } END_OLD sub _readperl { my $string = Module::Install::_read($_[0]); $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg; $string =~ s/(\n)\n*__(?:DATA|END)__\b.*\z/$1/s; $string =~ s/\n\n=\w+.+?\n\n=cut\b.+?\n+/\n\n/sg; return $string; } sub _readpod { my $string = Module::Install::_read($_[0]); $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg; return $string if $_[0] =~ /\.pod\z/; $string =~ s/(^|\n=cut\b.+?\n+)[^=\s].+?\n(\n=\w+|\z)/$1$2/sg; $string =~ s/\n*=pod\b[^\n]*\n+/\n\n/sg; $string =~ s/\n*=cut\b[^\n]*\n+/\n\n/sg; $string =~ s/^\n+//s; return $string; } # Done in evals to avoid confusing Perl::MinimumVersion eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@; sub _write { local *FH; open( FH, '>', $_[0] ) or die "open($_[0]): $!"; foreach ( 1 .. $#_ ) { print FH $_[$_] or die "print($_[0]): $!"; } close FH or die "close($_[0]): $!"; } END_NEW sub _write { local *FH; open( FH, "> $_[0]" ) or die "open($_[0]): $!"; foreach ( 1 .. $#_ ) { print FH $_[$_] or die "print($_[0]): $!"; } close FH or die "close($_[0]): $!"; } END_OLD # _version is for processing module versions (eg, 1.03_05) not # Perl versions (eg, 5.8.1). sub _version ($) { my $s = shift || 0; my $d =()= $s =~ /(\.)/g; if ( $d >= 2 ) { # Normalise multipart versions $s =~ s/(\.)(\d{1,3})/sprintf("$1%03d",$2)/eg; } $s =~ s/^(\d+)\.?//; my $l = $1 || 0; my @v = map { $_ . '0' x (3 - length $_) } $s =~ /(\d{1,3})\D?/g; $l = $l . '.' . join '', @v if @v; return $l + 0; } sub _cmp ($$) { _version($_[0]) <=> _version($_[1]); } # Cloned from Params::Util::_CLASS sub _CLASS ($) { ( defined $_[0] and ! ref $_[0] and $_[0] =~ m/^[^\W\d]\w*(?:::\w+)*\z/s ) ? $_[0] : undef; } 1; # Copyright 2008 - 2011 Adam Kennedy. CGI-PSGI-0.15/inc/Module/Install/AuthorTests.pm000644 000771 000024 00000002215 11564560727 022004 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::AuthorTests; use 5.005; use strict; use Module::Install::Base; use Carp (); #line 16 use vars qw{$VERSION $ISCORE @ISA}; BEGIN { $VERSION = '0.002'; $ISCORE = 1; @ISA = qw{Module::Install::Base}; } #line 42 sub author_tests { my ($self, @dirs) = @_; _add_author_tests($self, \@dirs, 0); } #line 56 sub recursive_author_tests { my ($self, @dirs) = @_; _add_author_tests($self, \@dirs, 1); } sub _wanted { my $href = shift; sub { /\.t$/ and -f $_ and $href->{$File::Find::dir} = 1 } } sub _add_author_tests { my ($self, $dirs, $recurse) = @_; return unless $Module::Install::AUTHOR; my @tests = $self->tests ? (split / /, $self->tests) : 't/*.t'; # XXX: pick a default, later -- rjbs, 2008-02-24 my @dirs = @$dirs ? @$dirs : Carp::confess "no dirs given to author_tests"; @dirs = grep { -d } @dirs; if ($recurse) { require File::Find; my %test_dir; File::Find::find(_wanted(\%test_dir), @dirs); $self->tests( join ' ', @tests, map { "$_/*.t" } sort keys %test_dir ); } else { $self->tests( join ' ', @tests, map { "$_/*.t" } sort @dirs ); } } #line 107 1; CGI-PSGI-0.15/inc/Module/Install/Base.pm000644 000771 000024 00000002147 11564560727 020375 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Base; use strict 'vars'; use vars qw{$VERSION}; BEGIN { $VERSION = '1.01'; } # Suspend handler for "redefined" warnings BEGIN { my $w = $SIG{__WARN__}; $SIG{__WARN__} = sub { $w }; } #line 42 sub new { my $class = shift; unless ( defined &{"${class}::call"} ) { *{"${class}::call"} = sub { shift->_top->call(@_) }; } unless ( defined &{"${class}::load"} ) { *{"${class}::load"} = sub { shift->_top->load(@_) }; } bless { @_ }, $class; } #line 61 sub AUTOLOAD { local $@; my $func = eval { shift->_top->autoload } or return; goto &$func; } #line 75 sub _top { $_[0]->{_top}; } #line 90 sub admin { $_[0]->_top->{admin} or Module::Install::Base::FakeAdmin->new; } #line 106 sub is_admin { ! $_[0]->admin->isa('Module::Install::Base::FakeAdmin'); } sub DESTROY {} package Module::Install::Base::FakeAdmin; use vars qw{$VERSION}; BEGIN { $VERSION = $Module::Install::Base::VERSION; } my $fake; sub new { $fake ||= bless(\@_, $_[0]); } sub AUTOLOAD {} sub DESTROY {} # Restore warning handler BEGIN { $SIG{__WARN__} = $SIG{__WARN__}->(); } 1; #line 159 CGI-PSGI-0.15/inc/Module/Install/Can.pm000644 000771 000024 00000003333 11564560727 020222 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Can; use strict; use Config (); use File::Spec (); use ExtUtils::MakeMaker (); use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } # check if we can load some module ### Upgrade this to not have to load the module if possible sub can_use { my ($self, $mod, $ver) = @_; $mod =~ s{::|\\}{/}g; $mod .= '.pm' unless $mod =~ /\.pm$/i; my $pkg = $mod; $pkg =~ s{/}{::}g; $pkg =~ s{\.pm$}{}i; local $@; eval { require $mod; $pkg->VERSION($ver || 0); 1 }; } # check if we can run some command sub can_run { my ($self, $cmd) = @_; my $_cmd = $cmd; return $_cmd if (-x $_cmd or $_cmd = MM->maybe_command($_cmd)); for my $dir ((split /$Config::Config{path_sep}/, $ENV{PATH}), '.') { next if $dir eq ''; my $abs = File::Spec->catfile($dir, $_[1]); return $abs if (-x $abs or $abs = MM->maybe_command($abs)); } return; } # can we locate a (the) C compiler sub can_cc { my $self = shift; my @chunks = split(/ /, $Config::Config{cc}) or return; # $Config{cc} may contain args; try to find out the program part while (@chunks) { return $self->can_run("@chunks") || (pop(@chunks), next); } return; } # Fix Cygwin bug on maybe_command(); if ( $^O eq 'cygwin' ) { require ExtUtils::MM_Cygwin; require ExtUtils::MM_Win32; if ( ! defined(&ExtUtils::MM_Cygwin::maybe_command) ) { *ExtUtils::MM_Cygwin::maybe_command = sub { my ($self, $file) = @_; if ($file =~ m{^/cygdrive/}i and ExtUtils::MM_Win32->can('maybe_command')) { ExtUtils::MM_Win32->maybe_command($file); } else { ExtUtils::MM_Unix->maybe_command($file); } } } } 1; __END__ #line 156 CGI-PSGI-0.15/inc/Module/Install/Fetch.pm000644 000771 000024 00000004627 11564560727 020561 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Fetch; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub get_file { my ($self, %args) = @_; my ($scheme, $host, $path, $file) = $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return; if ( $scheme eq 'http' and ! eval { require LWP::Simple; 1 } ) { $args{url} = $args{ftp_url} or (warn("LWP support unavailable!\n"), return); ($scheme, $host, $path, $file) = $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return; } $|++; print "Fetching '$file' from $host... "; unless (eval { require Socket; Socket::inet_aton($host) }) { warn "'$host' resolve failed!\n"; return; } return unless $scheme eq 'ftp' or $scheme eq 'http'; require Cwd; my $dir = Cwd::getcwd(); chdir $args{local_dir} or return if exists $args{local_dir}; if (eval { require LWP::Simple; 1 }) { LWP::Simple::mirror($args{url}, $file); } elsif (eval { require Net::FTP; 1 }) { eval { # use Net::FTP to get past firewall my $ftp = Net::FTP->new($host, Passive => 1, Timeout => 600); $ftp->login("anonymous", 'anonymous@example.com'); $ftp->cwd($path); $ftp->binary; $ftp->get($file) or (warn("$!\n"), return); $ftp->quit; } } elsif (my $ftp = $self->can_run('ftp')) { eval { # no Net::FTP, fallback to ftp.exe require FileHandle; my $fh = FileHandle->new; local $SIG{CHLD} = 'IGNORE'; unless ($fh->open("|$ftp -n")) { warn "Couldn't open ftp: $!\n"; chdir $dir; return; } my @dialog = split(/\n/, <<"END_FTP"); open $host user anonymous anonymous\@example.com cd $path binary get $file $file quit END_FTP foreach (@dialog) { $fh->print("$_\n") } $fh->close; } } else { warn "No working 'ftp' program available!\n"; chdir $dir; return; } unless (-f $file) { warn "Fetching failed: $@\n"; chdir $dir; return; } return if exists $args{size} and -s $file != $args{size}; system($args{run}) if exists $args{run}; unlink($file) if $args{remove}; print(((!exists $args{check_for} or -e $args{check_for}) ? "done!" : "failed! ($!)"), "\n"); chdir $dir; return !$?; } 1; CGI-PSGI-0.15/inc/Module/Install/Makefile.pm000644 000771 000024 00000027032 11564560727 021240 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Makefile; use strict 'vars'; use ExtUtils::MakeMaker (); use Module::Install::Base (); use Fcntl qw/:flock :seek/; use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } sub Makefile { $_[0] } my %seen = (); sub prompt { shift; # Infinite loop protection my @c = caller(); if ( ++$seen{"$c[1]|$c[2]|$_[0]"} > 3 ) { die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])"; } # In automated testing or non-interactive session, always use defaults if ( ($ENV{AUTOMATED_TESTING} or -! -t STDIN) and ! $ENV{PERL_MM_USE_DEFAULT} ) { local $ENV{PERL_MM_USE_DEFAULT} = 1; goto &ExtUtils::MakeMaker::prompt; } else { goto &ExtUtils::MakeMaker::prompt; } } # Store a cleaned up version of the MakeMaker version, # since we need to behave differently in a variety of # ways based on the MM version. my $makemaker = eval $ExtUtils::MakeMaker::VERSION; # If we are passed a param, do a "newer than" comparison. # Otherwise, just return the MakeMaker version. sub makemaker { ( @_ < 2 or $makemaker >= eval($_[1]) ) ? $makemaker : 0 } # Ripped from ExtUtils::MakeMaker 6.56, and slightly modified # as we only need to know here whether the attribute is an array # or a hash or something else (which may or may not be appendable). my %makemaker_argtype = ( C => 'ARRAY', CONFIG => 'ARRAY', # CONFIGURE => 'CODE', # ignore DIR => 'ARRAY', DL_FUNCS => 'HASH', DL_VARS => 'ARRAY', EXCLUDE_EXT => 'ARRAY', EXE_FILES => 'ARRAY', FUNCLIST => 'ARRAY', H => 'ARRAY', IMPORTS => 'HASH', INCLUDE_EXT => 'ARRAY', LIBS => 'ARRAY', # ignore '' MAN1PODS => 'HASH', MAN3PODS => 'HASH', META_ADD => 'HASH', META_MERGE => 'HASH', PL_FILES => 'HASH', PM => 'HASH', PMLIBDIRS => 'ARRAY', PMLIBPARENTDIRS => 'ARRAY', PREREQ_PM => 'HASH', CONFIGURE_REQUIRES => 'HASH', SKIP => 'ARRAY', TYPEMAPS => 'ARRAY', XS => 'HASH', # VERSION => ['version',''], # ignore # _KEEP_AFTER_FLUSH => '', clean => 'HASH', depend => 'HASH', dist => 'HASH', dynamic_lib=> 'HASH', linkext => 'HASH', macro => 'HASH', postamble => 'HASH', realclean => 'HASH', test => 'HASH', tool_autosplit => 'HASH', # special cases where you can use makemaker_append CCFLAGS => 'APPENDABLE', DEFINE => 'APPENDABLE', INC => 'APPENDABLE', LDDLFLAGS => 'APPENDABLE', LDFROM => 'APPENDABLE', ); sub makemaker_args { my ($self, %new_args) = @_; my $args = ( $self->{makemaker_args} ||= {} ); foreach my $key (keys %new_args) { if ($makemaker_argtype{$key}) { if ($makemaker_argtype{$key} eq 'ARRAY') { $args->{$key} = [] unless defined $args->{$key}; unless (ref $args->{$key} eq 'ARRAY') { $args->{$key} = [$args->{$key}] } push @{$args->{$key}}, ref $new_args{$key} eq 'ARRAY' ? @{$new_args{$key}} : $new_args{$key}; } elsif ($makemaker_argtype{$key} eq 'HASH') { $args->{$key} = {} unless defined $args->{$key}; foreach my $skey (keys %{ $new_args{$key} }) { $args->{$key}{$skey} = $new_args{$key}{$skey}; } } elsif ($makemaker_argtype{$key} eq 'APPENDABLE') { $self->makemaker_append($key => $new_args{$key}); } } else { if (defined $args->{$key}) { warn qq{MakeMaker attribute "$key" is overriden; use "makemaker_append" to append values\n}; } $args->{$key} = $new_args{$key}; } } return $args; } # For mm args that take multiple space-seperated args, # append an argument to the current list. sub makemaker_append { my $self = shift; my $name = shift; my $args = $self->makemaker_args; $args->{$name} = defined $args->{$name} ? join( ' ', $args->{$name}, @_ ) : join( ' ', @_ ); } sub build_subdirs { my $self = shift; my $subdirs = $self->makemaker_args->{DIR} ||= []; for my $subdir (@_) { push @$subdirs, $subdir; } } sub clean_files { my $self = shift; my $clean = $self->makemaker_args->{clean} ||= {}; %$clean = ( %$clean, FILES => join ' ', grep { length $_ } ($clean->{FILES} || (), @_), ); } sub realclean_files { my $self = shift; my $realclean = $self->makemaker_args->{realclean} ||= {}; %$realclean = ( %$realclean, FILES => join ' ', grep { length $_ } ($realclean->{FILES} || (), @_), ); } sub libs { my $self = shift; my $libs = ref $_[0] ? shift : [ shift ]; $self->makemaker_args( LIBS => $libs ); } sub inc { my $self = shift; $self->makemaker_args( INC => shift ); } sub _wanted_t { } sub tests_recursive { my $self = shift; my $dir = shift || 't'; unless ( -d $dir ) { die "tests_recursive dir '$dir' does not exist"; } my %tests = map { $_ => 1 } split / /, ($self->tests || ''); require File::Find; File::Find::find( sub { /\.t$/ and -f $_ and $tests{"$File::Find::dir/*.t"} = 1 }, $dir ); $self->tests( join ' ', sort keys %tests ); } sub write { my $self = shift; die "&Makefile->write() takes no arguments\n" if @_; # Check the current Perl version my $perl_version = $self->perl_version; if ( $perl_version ) { eval "use $perl_version; 1" or die "ERROR: perl: Version $] is installed, " . "but we need version >= $perl_version"; } # Make sure we have a new enough MakeMaker require ExtUtils::MakeMaker; if ( $perl_version and $self->_cmp($perl_version, '5.006') >= 0 ) { # MakeMaker can complain about module versions that include # an underscore, even though its own version may contain one! # Hence the funny regexp to get rid of it. See RT #35800 # for details. my $v = $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/; $self->build_requires( 'ExtUtils::MakeMaker' => $v ); $self->configure_requires( 'ExtUtils::MakeMaker' => $v ); } else { # Allow legacy-compatibility with 5.005 by depending on the # most recent EU:MM that supported 5.005. $self->build_requires( 'ExtUtils::MakeMaker' => 6.42 ); $self->configure_requires( 'ExtUtils::MakeMaker' => 6.42 ); } # Generate the MakeMaker params my $args = $self->makemaker_args; $args->{DISTNAME} = $self->name; $args->{NAME} = $self->module_name || $self->name; $args->{NAME} =~ s/-/::/g; $args->{VERSION} = $self->version or die <<'EOT'; ERROR: Can't determine distribution version. Please specify it explicitly via 'version' in Makefile.PL, or set a valid $VERSION in a module, and provide its file path via 'version_from' (or 'all_from' if you prefer) in Makefile.PL. EOT $DB::single = 1; if ( $self->tests ) { my @tests = split ' ', $self->tests; my %seen; $args->{test} = { TESTS => (join ' ', grep {!$seen{$_}++} @tests), }; } elsif ( $Module::Install::ExtraTests::use_extratests ) { # Module::Install::ExtraTests doesn't set $self->tests and does its own tests via harness. # So, just ignore our xt tests here. } elsif ( -d 'xt' and ($Module::Install::AUTHOR or $ENV{RELEASE_TESTING}) ) { $args->{test} = { TESTS => join( ' ', map { "$_/*.t" } grep { -d $_ } qw{ t xt } ), }; } if ( $] >= 5.005 ) { $args->{ABSTRACT} = $self->abstract; $args->{AUTHOR} = join ', ', @{$self->author || []}; } if ( $self->makemaker(6.10) ) { $args->{NO_META} = 1; #$args->{NO_MYMETA} = 1; } if ( $self->makemaker(6.17) and $self->sign ) { $args->{SIGN} = 1; } unless ( $self->is_admin ) { delete $args->{SIGN}; } if ( $self->makemaker(6.31) and $self->license ) { $args->{LICENSE} = $self->license; } my $prereq = ($args->{PREREQ_PM} ||= {}); %$prereq = ( %$prereq, map { @$_ } # flatten [module => version] map { @$_ } grep $_, ($self->requires) ); # Remove any reference to perl, PREREQ_PM doesn't support it delete $args->{PREREQ_PM}->{perl}; # Merge both kinds of requires into BUILD_REQUIRES my $build_prereq = ($args->{BUILD_REQUIRES} ||= {}); %$build_prereq = ( %$build_prereq, map { @$_ } # flatten [module => version] map { @$_ } grep $_, ($self->configure_requires, $self->build_requires) ); # Remove any reference to perl, BUILD_REQUIRES doesn't support it delete $args->{BUILD_REQUIRES}->{perl}; # Delete bundled dists from prereq_pm, add it to Makefile DIR my $subdirs = ($args->{DIR} || []); if ($self->bundles) { my %processed; foreach my $bundle (@{ $self->bundles }) { my ($mod_name, $dist_dir) = @$bundle; delete $prereq->{$mod_name}; $dist_dir = File::Basename::basename($dist_dir); # dir for building this module if (not exists $processed{$dist_dir}) { if (-d $dist_dir) { # List as sub-directory to be processed by make push @$subdirs, $dist_dir; } # Else do nothing: the module is already present on the system $processed{$dist_dir} = undef; } } } unless ( $self->makemaker('6.55_03') ) { %$prereq = (%$prereq,%$build_prereq); delete $args->{BUILD_REQUIRES}; } if ( my $perl_version = $self->perl_version ) { eval "use $perl_version; 1" or die "ERROR: perl: Version $] is installed, " . "but we need version >= $perl_version"; if ( $self->makemaker(6.48) ) { $args->{MIN_PERL_VERSION} = $perl_version; } } if ($self->installdirs) { warn qq{old INSTALLDIRS (probably set by makemaker_args) is overriden by installdirs\n} if $args->{INSTALLDIRS}; $args->{INSTALLDIRS} = $self->installdirs; } my %args = map { ( $_ => $args->{$_} ) } grep {defined($args->{$_} ) } keys %$args; my $user_preop = delete $args{dist}->{PREOP}; if ( my $preop = $self->admin->preop($user_preop) ) { foreach my $key ( keys %$preop ) { $args{dist}->{$key} = $preop->{$key}; } } my $mm = ExtUtils::MakeMaker::WriteMakefile(%args); $self->fix_up_makefile($mm->{FIRST_MAKEFILE} || 'Makefile'); } sub fix_up_makefile { my $self = shift; my $makefile_name = shift; my $top_class = ref($self->_top) || ''; my $top_version = $self->_top->VERSION || ''; my $preamble = $self->preamble ? "# Preamble by $top_class $top_version\n" . $self->preamble : ''; my $postamble = "# Postamble by $top_class $top_version\n" . ($self->postamble || ''); local *MAKEFILE; open MAKEFILE, "+< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!"; eval { flock MAKEFILE, LOCK_EX }; my $makefile = do { local $/; }; $makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /; $makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g; $makefile =~ s/( "-I\$\(INST_LIB\)")/ "-Iinc"$1/g; $makefile =~ s/^(FULLPERL = .*)/$1 "-Iinc"/m; $makefile =~ s/^(PERL = .*)/$1 "-Iinc"/m; # Module::Install will never be used to build the Core Perl # Sometimes PERL_LIB and PERL_ARCHLIB get written anyway, which breaks # PREFIX/PERL5LIB, and thus, install_share. Blank them if they exist $makefile =~ s/^PERL_LIB = .+/PERL_LIB =/m; #$makefile =~ s/^PERL_ARCHLIB = .+/PERL_ARCHLIB =/m; # Perl 5.005 mentions PERL_LIB explicitly, so we have to remove that as well. $makefile =~ s/(\"?)-I\$\(PERL_LIB\)\1//g; # XXX - This is currently unused; not sure if it breaks other MM-users # $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg; seek MAKEFILE, 0, SEEK_SET; truncate MAKEFILE, 0; print MAKEFILE "$preamble$makefile$postamble" or die $!; close MAKEFILE or die $!; 1; } sub preamble { my ($self, $text) = @_; $self->{preamble} = $text . $self->{preamble} if defined $text; $self->{preamble}; } sub postamble { my ($self, $text) = @_; $self->{postamble} ||= $self->admin->postamble; $self->{postamble} .= $text if defined $text; $self->{postamble} } 1; __END__ #line 541 CGI-PSGI-0.15/inc/Module/Install/Metadata.pm000644 000771 000024 00000043123 11564560727 021242 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Metadata; use strict 'vars'; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } my @boolean_keys = qw{ sign }; my @scalar_keys = qw{ name module_name abstract version distribution_type tests installdirs }; my @tuple_keys = qw{ configure_requires build_requires requires recommends bundles resources }; my @resource_keys = qw{ homepage bugtracker repository }; my @array_keys = qw{ keywords author }; *authors = \&author; sub Meta { shift } sub Meta_BooleanKeys { @boolean_keys } sub Meta_ScalarKeys { @scalar_keys } sub Meta_TupleKeys { @tuple_keys } sub Meta_ResourceKeys { @resource_keys } sub Meta_ArrayKeys { @array_keys } foreach my $key ( @boolean_keys ) { *$key = sub { my $self = shift; if ( defined wantarray and not @_ ) { return $self->{values}->{$key}; } $self->{values}->{$key} = ( @_ ? $_[0] : 1 ); return $self; }; } foreach my $key ( @scalar_keys ) { *$key = sub { my $self = shift; return $self->{values}->{$key} if defined wantarray and !@_; $self->{values}->{$key} = shift; return $self; }; } foreach my $key ( @array_keys ) { *$key = sub { my $self = shift; return $self->{values}->{$key} if defined wantarray and !@_; $self->{values}->{$key} ||= []; push @{$self->{values}->{$key}}, @_; return $self; }; } foreach my $key ( @resource_keys ) { *$key = sub { my $self = shift; unless ( @_ ) { return () unless $self->{values}->{resources}; return map { $_->[1] } grep { $_->[0] eq $key } @{ $self->{values}->{resources} }; } return $self->{values}->{resources}->{$key} unless @_; my $uri = shift or die( "Did not provide a value to $key()" ); $self->resources( $key => $uri ); return 1; }; } foreach my $key ( grep { $_ ne "resources" } @tuple_keys) { *$key = sub { my $self = shift; return $self->{values}->{$key} unless @_; my @added; while ( @_ ) { my $module = shift or last; my $version = shift || 0; push @added, [ $module, $version ]; } push @{ $self->{values}->{$key} }, @added; return map {@$_} @added; }; } # Resource handling my %lc_resource = map { $_ => 1 } qw{ homepage license bugtracker repository }; sub resources { my $self = shift; while ( @_ ) { my $name = shift or last; my $value = shift or next; if ( $name eq lc $name and ! $lc_resource{$name} ) { die("Unsupported reserved lowercase resource '$name'"); } $self->{values}->{resources} ||= []; push @{ $self->{values}->{resources} }, [ $name, $value ]; } $self->{values}->{resources}; } # Aliases for build_requires that will have alternative # meanings in some future version of META.yml. sub test_requires { shift->build_requires(@_) } sub install_requires { shift->build_requires(@_) } # Aliases for installdirs options sub install_as_core { $_[0]->installdirs('perl') } sub install_as_cpan { $_[0]->installdirs('site') } sub install_as_site { $_[0]->installdirs('site') } sub install_as_vendor { $_[0]->installdirs('vendor') } sub dynamic_config { my $self = shift; unless ( @_ ) { warn "You MUST provide an explicit true/false value to dynamic_config\n"; return $self; } $self->{values}->{dynamic_config} = $_[0] ? 1 : 0; return 1; } sub perl_version { my $self = shift; return $self->{values}->{perl_version} unless @_; my $version = shift or die( "Did not provide a value to perl_version()" ); # Normalize the version $version = $self->_perl_version($version); # We don't support the reall old versions unless ( $version >= 5.005 ) { die "Module::Install only supports 5.005 or newer (use ExtUtils::MakeMaker)\n"; } $self->{values}->{perl_version} = $version; } sub all_from { my ( $self, $file ) = @_; unless ( defined($file) ) { my $name = $self->name or die( "all_from called with no args without setting name() first" ); $file = join('/', 'lib', split(/-/, $name)) . '.pm'; $file =~ s{.*/}{} unless -e $file; unless ( -e $file ) { die("all_from cannot find $file from $name"); } } unless ( -f $file ) { die("The path '$file' does not exist, or is not a file"); } $self->{values}{all_from} = $file; # Some methods pull from POD instead of code. # If there is a matching .pod, use that instead my $pod = $file; $pod =~ s/\.pm$/.pod/i; $pod = $file unless -e $pod; # Pull the different values $self->name_from($file) unless $self->name; $self->version_from($file) unless $self->version; $self->perl_version_from($file) unless $self->perl_version; $self->author_from($pod) unless @{$self->author || []}; $self->license_from($pod) unless $self->license; $self->abstract_from($pod) unless $self->abstract; return 1; } sub provides { my $self = shift; my $provides = ( $self->{values}->{provides} ||= {} ); %$provides = (%$provides, @_) if @_; return $provides; } sub auto_provides { my $self = shift; return $self unless $self->is_admin; unless (-e 'MANIFEST') { warn "Cannot deduce auto_provides without a MANIFEST, skipping\n"; return $self; } # Avoid spurious warnings as we are not checking manifest here. local $SIG{__WARN__} = sub {1}; require ExtUtils::Manifest; local *ExtUtils::Manifest::manicheck = sub { return }; require Module::Build; my $build = Module::Build->new( dist_name => $self->name, dist_version => $self->version, license => $self->license, ); $self->provides( %{ $build->find_dist_packages || {} } ); } sub feature { my $self = shift; my $name = shift; my $features = ( $self->{values}->{features} ||= [] ); my $mods; if ( @_ == 1 and ref( $_[0] ) ) { # The user used ->feature like ->features by passing in the second # argument as a reference. Accomodate for that. $mods = $_[0]; } else { $mods = \@_; } my $count = 0; push @$features, ( $name => [ map { ref($_) ? ( ref($_) eq 'HASH' ) ? %$_ : @$_ : $_ } @$mods ] ); return @$features; } sub features { my $self = shift; while ( my ( $name, $mods ) = splice( @_, 0, 2 ) ) { $self->feature( $name, @$mods ); } return $self->{values}->{features} ? @{ $self->{values}->{features} } : (); } sub no_index { my $self = shift; my $type = shift; push @{ $self->{values}->{no_index}->{$type} }, @_ if $type; return $self->{values}->{no_index}; } sub read { my $self = shift; $self->include_deps( 'YAML::Tiny', 0 ); require YAML::Tiny; my $data = YAML::Tiny::LoadFile('META.yml'); # Call methods explicitly in case user has already set some values. while ( my ( $key, $value ) = each %$data ) { next unless $self->can($key); if ( ref $value eq 'HASH' ) { while ( my ( $module, $version ) = each %$value ) { $self->can($key)->($self, $module => $version ); } } else { $self->can($key)->($self, $value); } } return $self; } sub write { my $self = shift; return $self unless $self->is_admin; $self->admin->write_meta; return $self; } sub version_from { require ExtUtils::MM_Unix; my ( $self, $file ) = @_; $self->version( ExtUtils::MM_Unix->parse_version($file) ); # for version integrity check $self->makemaker_args( VERSION_FROM => $file ); } sub abstract_from { require ExtUtils::MM_Unix; my ( $self, $file ) = @_; $self->abstract( bless( { DISTNAME => $self->name }, 'ExtUtils::MM_Unix' )->parse_abstract($file) ); } # Add both distribution and module name sub name_from { my ($self, $file) = @_; if ( Module::Install::_read($file) =~ m/ ^ \s* package \s* ([\w:]+) \s* ; /ixms ) { my ($name, $module_name) = ($1, $1); $name =~ s{::}{-}g; $self->name($name); unless ( $self->module_name ) { $self->module_name($module_name); } } else { die("Cannot determine name from $file\n"); } } sub _extract_perl_version { if ( $_[0] =~ m/ ^\s* (?:use|require) \s* v? ([\d_\.]+) \s* ; /ixms ) { my $perl_version = $1; $perl_version =~ s{_}{}g; return $perl_version; } else { return; } } sub perl_version_from { my $self = shift; my $perl_version=_extract_perl_version(Module::Install::_read($_[0])); if ($perl_version) { $self->perl_version($perl_version); } else { warn "Cannot determine perl version info from $_[0]\n"; return; } } sub author_from { my $self = shift; my $content = Module::Install::_read($_[0]); if ($content =~ m/ =head \d \s+ (?:authors?)\b \s* ([^\n]*) | =head \d \s+ (?:licen[cs]e|licensing|copyright|legal)\b \s* .*? copyright .*? \d\d\d[\d.]+ \s* (?:\bby\b)? \s* ([^\n]*) /ixms) { my $author = $1 || $2; # XXX: ugly but should work anyway... if (eval "require Pod::Escapes; 1") { # Pod::Escapes has a mapping table. # It's in core of perl >= 5.9.3, and should be installed # as one of the Pod::Simple's prereqs, which is a prereq # of Pod::Text 3.x (see also below). $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> } { defined $2 ? chr($2) : defined $Pod::Escapes::Name2character_number{$1} ? chr($Pod::Escapes::Name2character_number{$1}) : do { warn "Unknown escape: E<$1>"; "E<$1>"; }; }gex; } elsif (eval "require Pod::Text; 1" && $Pod::Text::VERSION < 3) { # Pod::Text < 3.0 has yet another mapping table, # though the table name of 2.x and 1.x are different. # (1.x is in core of Perl < 5.6, 2.x is in core of # Perl < 5.9.3) my $mapping = ($Pod::Text::VERSION < 2) ? \%Pod::Text::HTML_Escapes : \%Pod::Text::ESCAPES; $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> } { defined $2 ? chr($2) : defined $mapping->{$1} ? $mapping->{$1} : do { warn "Unknown escape: E<$1>"; "E<$1>"; }; }gex; } else { $author =~ s{E}{<}g; $author =~ s{E}{>}g; } $self->author($author); } else { warn "Cannot determine author info from $_[0]\n"; } } #Stolen from M::B my %license_urls = ( perl => 'http://dev.perl.org/licenses/', apache => 'http://apache.org/licenses/LICENSE-2.0', apache_1_1 => 'http://apache.org/licenses/LICENSE-1.1', artistic => 'http://opensource.org/licenses/artistic-license.php', artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php', lgpl => 'http://opensource.org/licenses/lgpl-license.php', lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php', lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html', bsd => 'http://opensource.org/licenses/bsd-license.php', gpl => 'http://opensource.org/licenses/gpl-license.php', gpl2 => 'http://opensource.org/licenses/gpl-2.0.php', gpl3 => 'http://opensource.org/licenses/gpl-3.0.html', mit => 'http://opensource.org/licenses/mit-license.php', mozilla => 'http://opensource.org/licenses/mozilla1.1.php', open_source => undef, unrestricted => undef, restrictive => undef, unknown => undef, ); sub license { my $self = shift; return $self->{values}->{license} unless @_; my $license = shift or die( 'Did not provide a value to license()' ); $license = __extract_license($license) || lc $license; $self->{values}->{license} = $license; # Automatically fill in license URLs if ( $license_urls{$license} ) { $self->resources( license => $license_urls{$license} ); } return 1; } sub _extract_license { my $pod = shift; my $matched; return __extract_license( ($matched) = $pod =~ m/ (=head \d \s+ L(?i:ICEN[CS]E|ICENSING)\b.*?) (=head \d.*|=cut.*|)\z /xms ) || __extract_license( ($matched) = $pod =~ m/ (=head \d \s+ (?:C(?i:OPYRIGHTS?)|L(?i:EGAL))\b.*?) (=head \d.*|=cut.*|)\z /xms ); } sub __extract_license { my $license_text = shift or return; my @phrases = ( '(?:under )?the same (?:terms|license) as (?:perl|the perl (?:\d )?programming language)' => 'perl', 1, '(?:under )?the terms of (?:perl|the perl programming language) itself' => 'perl', 1, 'Artistic and GPL' => 'perl', 1, 'GNU general public license' => 'gpl', 1, 'GNU public license' => 'gpl', 1, 'GNU lesser general public license' => 'lgpl', 1, 'GNU lesser public license' => 'lgpl', 1, 'GNU library general public license' => 'lgpl', 1, 'GNU library public license' => 'lgpl', 1, 'GNU Free Documentation license' => 'unrestricted', 1, 'GNU Affero General Public License' => 'open_source', 1, '(?:Free)?BSD license' => 'bsd', 1, 'Artistic license 2\.0' => 'artistic_2', 1, 'Artistic license' => 'artistic', 1, 'Apache (?:Software )?license' => 'apache', 1, 'GPL' => 'gpl', 1, 'LGPL' => 'lgpl', 1, 'BSD' => 'bsd', 1, 'Artistic' => 'artistic', 1, 'MIT' => 'mit', 1, 'Mozilla Public License' => 'mozilla', 1, 'Q Public License' => 'open_source', 1, 'OpenSSL License' => 'unrestricted', 1, 'SSLeay License' => 'unrestricted', 1, 'zlib License' => 'open_source', 1, 'proprietary' => 'proprietary', 0, ); while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) { $pattern =~ s#\s+#\\s+#gs; if ( $license_text =~ /\b$pattern\b/i ) { return $license; } } return ''; } sub license_from { my $self = shift; if (my $license=_extract_license(Module::Install::_read($_[0]))) { $self->license($license); } else { warn "Cannot determine license info from $_[0]\n"; return 'unknown'; } } sub _extract_bugtracker { my @links = $_[0] =~ m#L<( https?\Q://rt.cpan.org/\E[^>]+| https?\Q://github.com/\E[\w_]+/[\w_]+/issues| https?\Q://code.google.com/p/\E[\w_\-]+/issues/list )>#gx; my %links; @links{@links}=(); @links=keys %links; return @links; } sub bugtracker_from { my $self = shift; my $content = Module::Install::_read($_[0]); my @links = _extract_bugtracker($content); unless ( @links ) { warn "Cannot determine bugtracker info from $_[0]\n"; return 0; } if ( @links > 1 ) { warn "Found more than one bugtracker link in $_[0]\n"; return 0; } # Set the bugtracker bugtracker( $links[0] ); return 1; } sub requires_from { my $self = shift; my $content = Module::Install::_readperl($_[0]); my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg; while ( @requires ) { my $module = shift @requires; my $version = shift @requires; $self->requires( $module => $version ); } } sub test_requires_from { my $self = shift; my $content = Module::Install::_readperl($_[0]); my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg; while ( @requires ) { my $module = shift @requires; my $version = shift @requires; $self->test_requires( $module => $version ); } } # Convert triple-part versions (eg, 5.6.1 or 5.8.9) to # numbers (eg, 5.006001 or 5.008009). # Also, convert double-part versions (eg, 5.8) sub _perl_version { my $v = $_[-1]; $v =~ s/^([1-9])\.([1-9]\d?\d?)$/sprintf("%d.%03d",$1,$2)/e; $v =~ s/^([1-9])\.([1-9]\d?\d?)\.(0|[1-9]\d?\d?)$/sprintf("%d.%03d%03d",$1,$2,$3 || 0)/e; $v =~ s/(\.\d\d\d)000$/$1/; $v =~ s/_.+$//; if ( ref($v) ) { # Numify $v = $v + 0; } return $v; } sub add_metadata { my $self = shift; my %hash = @_; for my $key (keys %hash) { warn "add_metadata: $key is not prefixed with 'x_'.\n" . "Use appopriate function to add non-private metadata.\n" unless $key =~ /^x_/; $self->{values}->{$key} = $hash{$key}; } } ###################################################################### # MYMETA Support sub WriteMyMeta { die "WriteMyMeta has been deprecated"; } sub write_mymeta_yaml { my $self = shift; # We need YAML::Tiny to write the MYMETA.yml file unless ( eval { require YAML::Tiny; 1; } ) { return 1; } # Generate the data my $meta = $self->_write_mymeta_data or return 1; # Save as the MYMETA.yml file print "Writing MYMETA.yml\n"; YAML::Tiny::DumpFile('MYMETA.yml', $meta); } sub write_mymeta_json { my $self = shift; # We need JSON to write the MYMETA.json file unless ( eval { require JSON; 1; } ) { return 1; } # Generate the data my $meta = $self->_write_mymeta_data or return 1; # Save as the MYMETA.yml file print "Writing MYMETA.json\n"; Module::Install::_write( 'MYMETA.json', JSON->new->pretty(1)->canonical->encode($meta), ); } sub _write_mymeta_data { my $self = shift; # If there's no existing META.yml there is nothing we can do return undef unless -f 'META.yml'; # We need Parse::CPAN::Meta to load the file unless ( eval { require Parse::CPAN::Meta; 1; } ) { return undef; } # Merge the perl version into the dependencies my $val = $self->Meta->{values}; my $perl = delete $val->{perl_version}; if ( $perl ) { $val->{requires} ||= []; my $requires = $val->{requires}; # Canonize to three-dot version after Perl 5.6 if ( $perl >= 5.006 ) { $perl =~ s{^(\d+)\.(\d\d\d)(\d*)}{join('.', $1, int($2||0), int($3||0))}e } unshift @$requires, [ perl => $perl ]; } # Load the advisory META.yml file my @yaml = Parse::CPAN::Meta::LoadFile('META.yml'); my $meta = $yaml[0]; # Overwrite the non-configure dependency hashs delete $meta->{requires}; delete $meta->{build_requires}; delete $meta->{recommends}; if ( exists $val->{requires} ) { $meta->{requires} = { map { @$_ } @{ $val->{requires} } }; } if ( exists $val->{build_requires} ) { $meta->{build_requires} = { map { @$_ } @{ $val->{build_requires} } }; } return $meta; } 1; CGI-PSGI-0.15/inc/Module/Install/Repository.pm000644 000771 000024 00000004256 11564560727 021705 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Repository; use strict; use 5.005; use vars qw($VERSION); $VERSION = '0.06'; use base qw(Module::Install::Base); sub _execute { my ($command) = @_; `$command`; } sub auto_set_repository { my $self = shift; return unless $Module::Install::AUTHOR; my $repo = _find_repo(\&_execute); if ($repo) { $self->repository($repo); } else { warn "Cannot determine repository URL\n"; } } sub _find_repo { my ($execute) = @_; if (-e ".git") { # TODO support remote besides 'origin'? if ($execute->('git remote show -n origin') =~ /URL: (.*)$/m) { # XXX Make it public clone URL, but this only works with github my $git_url = $1; $git_url =~ s![\w\-]+\@([^:]+):!git://$1/!; return $git_url; } elsif ($execute->('git svn info') =~ /URL: (.*)$/m) { return $1; } } elsif (-e ".svn") { if (`svn info` =~ /URL: (.*)$/m) { return $1; } } elsif (-e "_darcs") { # defaultrepo is better, but that is more likely to be ssh, not http if (my $query_repo = `darcs query repo`) { if ($query_repo =~ m!Default Remote: (http://.+)!) { return $1; } } open my $handle, '<', '_darcs/prefs/repos' or return; while (<$handle>) { chomp; return $_ if m!^http://!; } } elsif (-e ".hg") { if ($execute->('hg paths') =~ /default = (.*)$/m) { my $mercurial_url = $1; $mercurial_url =~ s!^ssh://hg\@(bitbucket\.org/)!https://$1!; return $mercurial_url; } } elsif (-e "$ENV{HOME}/.svk") { # Is there an explicit way to check if it's an svk checkout? my $svk_info = `svk info` or return; SVK_INFO: { if ($svk_info =~ /Mirrored From: (.*), Rev\./) { return $1; } if ($svk_info =~ m!Merged From: (/mirror/.*), Rev\.!) { $svk_info = `svk info /$1` or return; redo SVK_INFO; } } return; } } 1; __END__ =encoding utf-8 #line 128 CGI-PSGI-0.15/inc/Module/Install/Win32.pm000644 000771 000024 00000003403 11564560727 020421 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::Win32; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = 'Module::Install::Base'; $ISCORE = 1; } # determine if the user needs nmake, and download it if needed sub check_nmake { my $self = shift; $self->load('can_run'); $self->load('get_file'); require Config; return unless ( $^O eq 'MSWin32' and $Config::Config{make} and $Config::Config{make} =~ /^nmake\b/i and ! $self->can_run('nmake') ); print "The required 'nmake' executable not found, fetching it...\n"; require File::Basename; my $rv = $self->get_file( url => 'http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe', ftp_url => 'ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe', local_dir => File::Basename::dirname($^X), size => 51928, run => 'Nmake15.exe /o > nul', check_for => 'Nmake.exe', remove => 1, ); die <<'END_MESSAGE' unless $rv; ------------------------------------------------------------------------------- Since you are using Microsoft Windows, you will need the 'nmake' utility before installation. It's available at: http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe or ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe Please download the file manually, save it to a directory in %PATH% (e.g. C:\WINDOWS\COMMAND\), then launch the MS-DOS command line shell, "cd" to that directory, and run "Nmake15.exe" from there; that will create the 'nmake.exe' file needed by this module. You may then resume the installation process described in README. ------------------------------------------------------------------------------- END_MESSAGE } 1; CGI-PSGI-0.15/inc/Module/Install/WriteAll.pm000644 000771 000024 00000002376 11564560727 021252 0ustar00miyagawastaff000000 000000 #line 1 package Module::Install::WriteAll; use strict; use Module::Install::Base (); use vars qw{$VERSION @ISA $ISCORE}; BEGIN { $VERSION = '1.01'; @ISA = qw{Module::Install::Base}; $ISCORE = 1; } sub WriteAll { my $self = shift; my %args = ( meta => 1, sign => 0, inline => 0, check_nmake => 1, @_, ); $self->sign(1) if $args{sign}; $self->admin->WriteAll(%args) if $self->is_admin; $self->check_nmake if $args{check_nmake}; unless ( $self->makemaker_args->{PL_FILES} ) { # XXX: This still may be a bit over-defensive... unless ($self->makemaker(6.25)) { $self->makemaker_args( PL_FILES => {} ) if -f 'Build.PL'; } } # Until ExtUtils::MakeMaker support MYMETA.yml, make sure # we clean it up properly ourself. $self->realclean_files('MYMETA.yml'); if ( $args{inline} ) { $self->Inline->write; } else { $self->Makefile->write; } # The Makefile write process adds a couple of dependencies, # so write the META.yml files after the Makefile. if ( $args{meta} ) { $self->Meta->write; } # Experimental support for MYMETA if ( $ENV{X_MYMETA} ) { if ( $ENV{X_MYMETA} eq 'JSON' ) { $self->Meta->write_mymeta_json; } else { $self->Meta->write_mymeta_yaml; } } return 1; } 1;