home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / perl560.zip / lib / CPAN / FirstTime.pm next >
Text File  |  2000-02-03  |  16KB  |  542 lines
  1. package CPAN::Mirrored::By;
  2.  
  3. sub new { 
  4.     my($self,@arg) = @_;
  5.     bless [@arg], $self;
  6. }
  7. sub continent { shift->[0] }
  8. sub country { shift->[1] }
  9. sub url { shift->[2] }
  10.  
  11. package CPAN::FirstTime;
  12.  
  13. use strict;
  14. use ExtUtils::MakeMaker qw(prompt);
  15. use FileHandle ();
  16. use File::Basename ();
  17. use File::Path ();
  18. use vars qw($VERSION);
  19. $VERSION = substr q$Revision: 1.38 $, 10;
  20.  
  21. =head1 NAME
  22.  
  23. CPAN::FirstTime - Utility for CPAN::Config file Initialization
  24.  
  25. =head1 SYNOPSIS
  26.  
  27. CPAN::FirstTime::init()
  28.  
  29. =head1 DESCRIPTION
  30.  
  31. The init routine asks a few questions and writes a CPAN::Config
  32. file. Nothing special.
  33.  
  34. =cut
  35.  
  36.  
  37. sub init {
  38.     my($configpm) = @_;
  39.     use Config;
  40.     unless ($CPAN::VERSION) {
  41.     require CPAN::Nox;
  42.     }
  43.     eval {require CPAN::Config;};
  44.     $CPAN::Config ||= {};
  45.     local($/) = "\n";
  46.     local($\) = "";
  47.     local($|) = 1;
  48.  
  49.     my($ans,$default,$local,$cont,$url,$expected_size);
  50.  
  51.     #
  52.     # Files, directories
  53.     #
  54.  
  55.     print qq[
  56.  
  57. CPAN is the world-wide archive of perl resources. It consists of about
  58. 100 sites that all replicate the same contents all around the globe.
  59. Many countries have at least one CPAN site already. The resources
  60. found on CPAN are easily accessible with the CPAN.pm module. If you
  61. want to use CPAN.pm, you have to configure it properly.
  62.  
  63. If you do not want to enter a dialog now, you can answer 'no' to this
  64. question and I\'ll try to autoconfigure. (Note: you can revisit this
  65. dialog anytime later by typing 'o conf init' at the cpan prompt.)
  66.  
  67. ];
  68.  
  69.     my $manual_conf =
  70.     ExtUtils::MakeMaker::prompt("Are you ready for manual configuration?",
  71.                     "yes");
  72.     my $fastread;
  73.     {
  74.       local $^W;
  75.       if ($manual_conf =~ /^\s*y/i) {
  76.     $fastread = 0;
  77.     *prompt = \&ExtUtils::MakeMaker::prompt;
  78.       } else {
  79.     $fastread = 1;
  80.     $CPAN::Config->{urllist} ||= [];
  81.     # prototype should match that of &MakeMaker::prompt
  82.     *prompt = sub ($;$) {
  83.       my($q,$a) = @_;
  84.       my($ret) = defined $a ? $a : "";
  85.       printf qq{%s [%s]\n\n}, $q, $ret;
  86.       $ret;
  87.     };
  88.       }
  89.     }
  90.     print qq{
  91.  
  92. The following questions are intended to help you with the
  93. configuration. The CPAN module needs a directory of its own to cache
  94. important index files and maybe keep a temporary mirror of CPAN files.
  95. This may be a site-wide directory or a personal directory.
  96.  
  97. };
  98.  
  99.     my $cpan_home = $CPAN::Config->{cpan_home} || MM->catdir($ENV{HOME}, ".cpan");
  100.     if (-d $cpan_home) {
  101.     print qq{
  102.  
  103. I see you already have a  directory
  104.     $cpan_home
  105. Shall we use it as the general CPAN build and cache directory?
  106.  
  107. };
  108.     } else {
  109.     print qq{
  110.  
  111. First of all, I\'d like to create this directory. Where?
  112.  
  113. };
  114.     }
  115.  
  116.     $default = $cpan_home;
  117.     while ($ans = prompt("CPAN build and cache directory?",$default)) {
  118.       eval { File::Path::mkpath($ans); }; # dies if it can't
  119.       if ($@) {
  120.     warn "Couldn't create directory $ans.
  121. Please retry.\n";
  122.     next;
  123.       }
  124.       if (-d $ans && -w _) {
  125.     last;
  126.       } else {
  127.     warn "Couldn't find directory $ans
  128.   or directory is not writable. Please retry.\n";
  129.       }
  130.     }
  131.     $CPAN::Config->{cpan_home} = $ans;
  132.  
  133.     print qq{
  134.  
  135. If you want, I can keep the source files after a build in the cpan
  136. home directory. If you choose so then future builds will take the
  137. files from there. If you don\'t want to keep them, answer 0 to the
  138. next question.
  139.  
  140. };
  141.  
  142.     $CPAN::Config->{keep_source_where} = MM->catdir($CPAN::Config->{cpan_home},"sources");
  143.     $CPAN::Config->{build_dir} = MM->catdir($CPAN::Config->{cpan_home},"build");
  144.  
  145.     #
  146.     # Cache size, Index expire
  147.     #
  148.  
  149.     print qq{
  150.  
  151. How big should the disk cache be for keeping the build directories
  152. with all the intermediate files?
  153.  
  154. };
  155.  
  156.     $default = $CPAN::Config->{build_cache} || 10;
  157.     $ans = prompt("Cache size for build directory (in MB)?", $default);
  158.     $CPAN::Config->{build_cache} = $ans;
  159.  
  160.     # XXX This the time when we refetch the index files (in days)
  161.     $CPAN::Config->{'index_expire'} = 1;
  162.  
  163.     print qq{
  164.  
  165. By default, each time the CPAN module is started, cache scanning
  166. is performed to keep the cache size in sync. To prevent from this,
  167. disable the cache scanning with 'never'.
  168.  
  169. };
  170.  
  171.     $default = $CPAN::Config->{scan_cache} || 'atstart';
  172.     do {
  173.         $ans = prompt("Perform cache scanning (atstart or never)?", $default);
  174.     } while ($ans ne 'atstart' && $ans ne 'never');
  175.     $CPAN::Config->{scan_cache} = $ans;
  176.  
  177.     #
  178.     # prerequisites_policy
  179.     # Do we follow PREREQ_PM?
  180.     #
  181.     print qq{
  182.  
  183. The CPAN module can detect when a module that which you are trying to
  184. build depends on prerequisites. If this happens, it can build the
  185. prerequisites for you automatically ('follow'), ask you for
  186. confirmation ('ask'), or just ignore them ('ignore'). Please set your
  187. policy to one of the three values.
  188.  
  189. };
  190.  
  191.     $default = $CPAN::Config->{prerequisites_policy} || 'follow';
  192.     do {
  193.       $ans =
  194.       prompt("Policy on building prerequisites (follow, ask or ignore)?",
  195.          $default);
  196.     } while ($ans ne 'follow' && $ans ne 'ask' && $ans ne 'ignore');
  197.     $CPAN::Config->{prerequisites_policy} = $ans;
  198.  
  199.     #
  200.     # External programs
  201.     #
  202.  
  203.     print qq{
  204.  
  205. The CPAN module will need a few external programs to work
  206. properly. Please correct me, if I guess the wrong path for a program.
  207. Don\'t panic if you do not have some of them, just press ENTER for
  208. those.
  209.  
  210. };
  211.  
  212.     my $old_warn = $^W;
  213.     local $^W if $^O eq 'MacOS';
  214.     my(@path) = split /$Config{'path_sep'}/, $ENV{'PATH'};
  215.     local $^W = $old_warn;
  216.     my $progname;
  217.     for $progname (qw/gzip tar unzip make lynx ncftpget ncftp ftp/){
  218.       if ($^O eq 'MacOS') {
  219.           $CPAN::Config->{$progname} = 'not_here';
  220.           next;
  221.       }
  222.       my $progcall = $progname;
  223.       # we don't need ncftp if we have ncftpget
  224.       next if $progname eq "ncftp" && $CPAN::Config->{ncftpget} gt " ";
  225.       my $path = $CPAN::Config->{$progname} 
  226.       || $Config::Config{$progname}
  227.           || "";
  228.       if (MM->file_name_is_absolute($path)) {
  229.     # testing existence is not good enough, some have these exe
  230.     # extensions
  231.  
  232.     # warn "Warning: configured $path does not exist\n" unless -e $path;
  233.     # $path = "";
  234.       } else {
  235.     $path = '';
  236.       }
  237.       unless ($path) {
  238.     # e.g. make -> nmake
  239.     $progcall = $Config::Config{$progname} if $Config::Config{$progname};
  240.       }
  241.  
  242.       $path ||= find_exe($progcall,[@path]);
  243.       warn "Warning: $progcall not found in PATH\n" unless
  244.       $path; # not -e $path, because find_exe already checked that
  245.       $ans = prompt("Where is your $progname program?",$path) || $path;
  246.       $CPAN::Config->{$progname} = $ans;
  247.     }
  248.     my $path = $CPAN::Config->{'pager'} || 
  249.     $ENV{PAGER} || find_exe("less",[@path]) || 
  250.         find_exe("more",[@path]) || ($^O eq 'MacOS' ? $ENV{EDITOR} : 0 )
  251.         || "more";
  252.     $ans = prompt("What is your favorite pager program?",$path);
  253.     $CPAN::Config->{'pager'} = $ans;
  254.     $path = $CPAN::Config->{'shell'};
  255.     if (MM->file_name_is_absolute($path)) {
  256.     warn "Warning: configured $path does not exist\n" unless -e $path;
  257.     $path = "";
  258.     }
  259.     $path ||= $ENV{SHELL};
  260.     if ($^O eq 'MacOS') {
  261.         $CPAN::Config->{'shell'} = 'not_here';
  262.     } else {
  263.         $path =~ s,\\,/,g if $^O eq 'os2';    # Cosmetic only
  264.         $ans = prompt("What is your favorite shell?",$path);
  265.         $CPAN::Config->{'shell'} = $ans;
  266.     }
  267.  
  268.     #
  269.     # Arguments to make etc.
  270.     #
  271.  
  272.     print qq{
  273.  
  274. Every Makefile.PL is run by perl in a separate process. Likewise we
  275. run \'make\' and \'make install\' in processes. If you have any parameters
  276. \(e.g. PREFIX, INSTALLPRIVLIB, UNINST or the like\) you want to pass to
  277. the calls, please specify them here.
  278.  
  279. If you don\'t understand this question, just press ENTER.
  280.  
  281. };
  282.  
  283.     $default = $CPAN::Config->{makepl_arg} || "";
  284.     $CPAN::Config->{makepl_arg} =
  285.     prompt("Parameters for the 'perl Makefile.PL' command?",$default);
  286.     $default = $CPAN::Config->{make_arg} || "";
  287.     $CPAN::Config->{make_arg} = prompt("Parameters for the 'make' command?",$default);
  288.  
  289.     $default = $CPAN::Config->{make_install_arg} || $CPAN::Config->{make_arg} || "";
  290.     $CPAN::Config->{make_install_arg} =
  291.     prompt("Parameters for the 'make install' command?",$default);
  292.  
  293.     #
  294.     # Alarm period
  295.     #
  296.  
  297.     print qq{
  298.  
  299. Sometimes you may wish to leave the processes run by CPAN alone
  300. without caring about them. As sometimes the Makefile.PL contains
  301. question you\'re expected to answer, you can set a timer that will
  302. kill a 'perl Makefile.PL' process after the specified time in seconds.
  303.  
  304. If you set this value to 0, these processes will wait forever. This is
  305. the default and recommended setting.
  306.  
  307. };
  308.  
  309.     $default = $CPAN::Config->{inactivity_timeout} || 0;
  310.     $CPAN::Config->{inactivity_timeout} =
  311.     prompt("Timeout for inactivity during Makefile.PL?",$default);
  312.  
  313.     # Proxies
  314.  
  315.     print qq{
  316.  
  317. If you\'re accessing the net via proxies, you can specify them in the
  318. CPAN configuration or via environment variables. The variable in
  319. the \$CPAN::Config takes precedence.
  320.  
  321. };
  322.  
  323.     for (qw/ftp_proxy http_proxy no_proxy/) {
  324.     $default = $CPAN::Config->{$_} || $ENV{$_};
  325.     $CPAN::Config->{$_} = prompt("Your $_?",$default);
  326.     }
  327.  
  328.     #
  329.     # MIRRORED.BY
  330.     #
  331.  
  332.     conf_sites() unless $fastread;
  333.  
  334.     unless (@{$CPAN::Config->{'wait_list'}||[]}) {
  335.     print qq{
  336.  
  337. WAIT support is available as a Plugin. You need the CPAN::WAIT module
  338. to actually use it.  But we need to know your favorite WAIT server. If
  339. you don\'t know a WAIT server near you, just press ENTER.
  340.  
  341. };
  342.     $default = "wait://ls6.informatik.uni-dortmund.de:1404";
  343.     $ans = prompt("Your favorite WAIT server?\n  ",$default);
  344.     push @{$CPAN::Config->{'wait_list'}}, $ans;
  345.     }
  346.  
  347.     # We don't ask that now, it will be noticed in time, won't it?
  348.     $CPAN::Config->{'inhibit_startup_message'} = 0;
  349.     $CPAN::Config->{'getcwd'} = 'cwd';
  350.  
  351.     print "\n\n";
  352.     CPAN::Config->commit($configpm);
  353. }
  354.  
  355. sub conf_sites {
  356.   my $m = 'MIRRORED.BY';
  357.   my $mby = MM->catfile($CPAN::Config->{keep_source_where},$m);
  358.   File::Path::mkpath(File::Basename::dirname($mby));
  359.   if (-f $mby && -f $m && -M $m < -M $mby) {
  360.     require File::Copy;
  361.     File::Copy::copy($m,$mby) or die "Could not update $mby: $!";
  362.   }
  363.   my $loopcount = 0;
  364.   while () {
  365.     if ( ! -f $mby ){
  366.       print qq{You have no $mby
  367.   I\'m trying to fetch one
  368. };
  369.       $mby = CPAN::FTP->localize($m,$mby,3);
  370.     } elsif (-M $mby > 60 && $loopcount == 0) {
  371.       print qq{Your $mby is older than 60 days,
  372.   I\'m trying to fetch one
  373. };
  374.       $mby = CPAN::FTP->localize($m,$mby,3);
  375.       $loopcount++;
  376.     } elsif (-s $mby == 0) {
  377.       print qq{You have an empty $mby,
  378.   I\'m trying to fetch one
  379. };
  380.       $mby = CPAN::FTP->localize($m,$mby,3);
  381.     } else {
  382.       last;
  383.     }
  384.   }
  385.   read_mirrored_by($mby);
  386. }
  387.  
  388. sub find_exe {
  389.     my($exe,$path) = @_;
  390.     my($dir);
  391.     #warn "in find_exe exe[$exe] path[@$path]";
  392.     for $dir (@$path) {
  393.     my $abs = MM->catfile($dir,$exe);
  394.     if (($abs = MM->maybe_command($abs))) {
  395.         return $abs;
  396.     }
  397.     }
  398. }
  399.  
  400. sub picklist {
  401.     my($items,$prompt,$default,$require_nonempty,$empty_warning)=@_;
  402.     $default ||= '';
  403.  
  404.     my ($item, $i);
  405.     for $item (@$items) {
  406.     printf "(%d) %s\n", ++$i, $item;
  407.     }
  408.  
  409.     my @nums;
  410.     while (1) {
  411.     my $num = prompt($prompt,$default);
  412.     @nums = split (' ', $num);
  413.     (warn "invalid items entered, try again\n"), next
  414.         if grep (/\D/ || $_ < 1 || $_ > $i, @nums);
  415.     if ($require_nonempty) {
  416.         (warn "$empty_warning\n"), next
  417.         unless @nums;
  418.     }
  419.     last;
  420.     }
  421.     print "\n";
  422.     for (@nums) { $_-- }
  423.     @{$items}[@nums];
  424. }
  425.  
  426. sub read_mirrored_by {
  427.     my($local) = @_;
  428.     my(%all,$url,$expected_size,$default,$ans,$host,$dst,$country,$continent,@location);
  429.     my $fh = FileHandle->new;
  430.     $fh->open($local) or die "Couldn't open $local: $!";
  431.     local $/ = "\012";
  432.     while (<$fh>) {
  433.     ($host) = /^([\w\.\-]+)/ unless defined $host;
  434.     next unless defined $host;
  435.     next unless /\s+dst_(dst|location)/;
  436.     /location\s+=\s+\"([^\"]+)/ and @location = (split /\s*,\s*/, $1) and
  437.         ($continent, $country) = @location[-1,-2];
  438.     $continent =~ s/\s\(.*//;
  439.     $continent =~ s/\W+$//; # if Jarkko doesn't know latitude/longitude
  440.     /dst_dst\s+=\s+\"([^\"]+)/  and $dst = $1;
  441.     next unless $host && $dst && $continent && $country;
  442.     $all{$continent}{$country}{$dst} = CPAN::Mirrored::By->new($continent,$country,$dst);
  443.     undef $host;
  444.     $dst=$continent=$country="";
  445.     }
  446.     $fh->close;
  447.     $CPAN::Config->{urllist} ||= [];
  448.     my(@previous_urls);
  449.     if (@previous_urls = @{$CPAN::Config->{urllist}}) {
  450.     $CPAN::Config->{urllist} = [];
  451.     }
  452.  
  453.     print qq{
  454.  
  455. Now we need to know where your favorite CPAN sites are located. Push
  456. a few sites onto the array (just in case the first on the array won\'t
  457. work). If you are mirroring CPAN to your local workstation, specify a
  458. file: URL.
  459.  
  460. First, pick a nearby continent and country (you can pick several of
  461. each, separated by spaces, or none if you just want to keep your
  462. existing selections). Then, you will be presented with a list of URLs
  463. of CPAN mirrors in the countries you selected, along with previously
  464. selected URLs. Select some of those URLs, or just keep the old list.
  465. Finally, you will be prompted for any extra URLs -- file:, ftp:, or
  466. http: -- that host a CPAN mirror.
  467.  
  468. };
  469.  
  470.     my (@cont, $cont, %cont, @countries, @urls, %seen);
  471.     my $no_previous_warn = 
  472.        "Sorry! since you don't have any existing picks, you must make a\n" .
  473.        "geographic selection.";
  474.     @cont = picklist([sort keys %all],
  475.                      "Select your continent (or several nearby continents)",
  476.                      '',
  477.                      ! @previous_urls,
  478.                      $no_previous_warn);
  479.  
  480.  
  481.     foreach $cont (@cont) {
  482.         my @c = sort keys %{$all{$cont}};
  483.         @cont{@c} = map ($cont, 0..$#c);
  484.         @c = map ("$_ ($cont)", @c) if @cont > 1;
  485.         push (@countries, @c);
  486.     }
  487.  
  488.     if (@countries) {
  489.         @countries = picklist (\@countries,
  490.                                "Select your country (or several nearby countries)",
  491.                                '',
  492.                                ! @previous_urls,
  493.                                $no_previous_warn);
  494.         %seen = map (($_ => 1), @previous_urls);
  495.         # hmmm, should take list of defaults from CPAN::Config->{'urllist'}...
  496.         foreach $country (@countries) {
  497.             (my $bare_country = $country) =~ s/ \(.*\)//;
  498.             my @u = sort keys %{$all{$cont{$bare_country}}{$bare_country}};
  499.             @u = grep (! $seen{$_}, @u);
  500.             @u = map ("$_ ($bare_country)", @u)
  501.                if @countries > 1;
  502.             push (@urls, @u);
  503.         }
  504.     }
  505.     push (@urls, map ("$_ (previous pick)", @previous_urls));
  506.     my $prompt = "Select as many URLs as you like";
  507.     if (@previous_urls) {
  508.        $default = join (' ', ((scalar @urls) - (scalar @previous_urls) + 1) ..
  509.                              (scalar @urls));
  510.        $prompt .= "\n(or just hit RETURN to keep your previous picks)";
  511.     }
  512.  
  513.     @urls = picklist (\@urls, $prompt, $default);
  514.     foreach (@urls) { s/ \(.*\)//; }
  515.     %seen = map (($_ => 1), @urls);
  516.  
  517.     do {
  518.         $ans = prompt ("Enter another URL or RETURN to quit:", "");
  519.  
  520.         if ($ans) {
  521.             $ans =~ s|/?$|/|; # has to end with one slash
  522.             $ans = "file:$ans" unless $ans =~ /:/; # without a scheme is a file:
  523.             if ($ans =~ /^\w+:\/./) {
  524.                push @urls, $ans 
  525.                   unless $seen{$ans};
  526.             }
  527.             else {
  528.                 print qq{"$ans" doesn\'t look like an URL at first sight.
  529. I\'ll ignore it for now.  You can add it to $INC{'CPAN/MyConfig.pm'}
  530. later if you\'re sure it\'s right.\n};
  531.             }
  532.         }
  533.     } while $ans;
  534.  
  535.     push @{$CPAN::Config->{urllist}}, @urls;
  536.     # xxx delete or comment these out when you're happy that it works
  537.     print "New set of picks:\n";
  538.     map { print "  $_\n" } @{$CPAN::Config->{urllist}};
  539. }
  540.  
  541. 1;
  542.