| 1 | # -*- Mode: cperl; coding: utf-8; cperl-indent-level: 4 -*-
|
|---|
| 2 | package CPAN::Mirrored::By;
|
|---|
| 3 |
|
|---|
| 4 | sub new {
|
|---|
| 5 | my($self,@arg) = @_;
|
|---|
| 6 | bless [@arg], $self;
|
|---|
| 7 | }
|
|---|
| 8 | sub continent { shift->[0] }
|
|---|
| 9 | sub country { shift->[1] }
|
|---|
| 10 | sub url { shift->[2] }
|
|---|
| 11 |
|
|---|
| 12 | package CPAN::FirstTime;
|
|---|
| 13 |
|
|---|
| 14 | use strict;
|
|---|
| 15 | use ExtUtils::MakeMaker qw(prompt);
|
|---|
| 16 | use FileHandle ();
|
|---|
| 17 | use File::Basename ();
|
|---|
| 18 | use File::Path ();
|
|---|
| 19 | use File::Spec;
|
|---|
| 20 | use vars qw($VERSION);
|
|---|
| 21 | $VERSION = substr q$Revision: 1.60 $, 10;
|
|---|
| 22 |
|
|---|
| 23 | =head1 NAME
|
|---|
| 24 |
|
|---|
| 25 | CPAN::FirstTime - Utility for CPAN::Config file Initialization
|
|---|
| 26 |
|
|---|
| 27 | =head1 SYNOPSIS
|
|---|
| 28 |
|
|---|
| 29 | CPAN::FirstTime::init()
|
|---|
| 30 |
|
|---|
| 31 | =head1 DESCRIPTION
|
|---|
| 32 |
|
|---|
| 33 | The init routine asks a few questions and writes a CPAN::Config
|
|---|
| 34 | file. Nothing special.
|
|---|
| 35 |
|
|---|
| 36 | =cut
|
|---|
| 37 |
|
|---|
| 38 |
|
|---|
| 39 | sub init {
|
|---|
| 40 | my($configpm) = @_;
|
|---|
| 41 | use Config;
|
|---|
| 42 | unless ($CPAN::VERSION) {
|
|---|
| 43 | require CPAN::Nox;
|
|---|
| 44 | }
|
|---|
| 45 | eval {require CPAN::Config;};
|
|---|
| 46 | $CPAN::Config ||= {};
|
|---|
| 47 | local($/) = "\n";
|
|---|
| 48 | local($\) = "";
|
|---|
| 49 | local($|) = 1;
|
|---|
| 50 |
|
|---|
| 51 | my($ans,$default);
|
|---|
| 52 |
|
|---|
| 53 | #
|
|---|
| 54 | # Files, directories
|
|---|
| 55 | #
|
|---|
| 56 |
|
|---|
| 57 | print qq[
|
|---|
| 58 |
|
|---|
| 59 | CPAN is the world-wide archive of perl resources. It consists of about
|
|---|
| 60 | 100 sites that all replicate the same contents all around the globe.
|
|---|
| 61 | Many countries have at least one CPAN site already. The resources
|
|---|
| 62 | found on CPAN are easily accessible with the CPAN.pm module. If you
|
|---|
| 63 | want to use CPAN.pm, you have to configure it properly.
|
|---|
| 64 |
|
|---|
| 65 | If you do not want to enter a dialog now, you can answer 'no' to this
|
|---|
| 66 | question and I\'ll try to autoconfigure. (Note: you can revisit this
|
|---|
| 67 | dialog anytime later by typing 'o conf init' at the cpan prompt.)
|
|---|
| 68 |
|
|---|
| 69 | ];
|
|---|
| 70 |
|
|---|
| 71 | my $manual_conf =
|
|---|
| 72 | ExtUtils::MakeMaker::prompt("Are you ready for manual configuration?",
|
|---|
| 73 | "yes");
|
|---|
| 74 | my $fastread;
|
|---|
| 75 | {
|
|---|
| 76 | local $^W;
|
|---|
| 77 | if ($manual_conf =~ /^\s*y/i) {
|
|---|
| 78 | $fastread = 0;
|
|---|
| 79 | *prompt = \&ExtUtils::MakeMaker::prompt;
|
|---|
| 80 | } else {
|
|---|
| 81 | $fastread = 1;
|
|---|
| 82 | $CPAN::Config->{urllist} ||= [];
|
|---|
| 83 | # prototype should match that of &MakeMaker::prompt
|
|---|
| 84 | *prompt = sub ($;$) {
|
|---|
| 85 | my($q,$a) = @_;
|
|---|
| 86 | my($ret) = defined $a ? $a : "";
|
|---|
| 87 | printf qq{%s [%s]\n\n}, $q, $ret;
|
|---|
| 88 | $ret;
|
|---|
| 89 | };
|
|---|
| 90 | }
|
|---|
| 91 | }
|
|---|
| 92 | print qq{
|
|---|
| 93 |
|
|---|
| 94 | The following questions are intended to help you with the
|
|---|
| 95 | configuration. The CPAN module needs a directory of its own to cache
|
|---|
| 96 | important index files and maybe keep a temporary mirror of CPAN files.
|
|---|
| 97 | This may be a site-wide directory or a personal directory.
|
|---|
| 98 |
|
|---|
| 99 | };
|
|---|
| 100 |
|
|---|
| 101 | my $cpan_home = $CPAN::Config->{cpan_home} || File::Spec->catdir($ENV{HOME}, ".cpan");
|
|---|
| 102 | if (-d $cpan_home) {
|
|---|
| 103 | print qq{
|
|---|
| 104 |
|
|---|
| 105 | I see you already have a directory
|
|---|
| 106 | $cpan_home
|
|---|
| 107 | Shall we use it as the general CPAN build and cache directory?
|
|---|
| 108 |
|
|---|
| 109 | };
|
|---|
| 110 | } else {
|
|---|
| 111 | print qq{
|
|---|
| 112 |
|
|---|
| 113 | First of all, I\'d like to create this directory. Where?
|
|---|
| 114 |
|
|---|
| 115 | };
|
|---|
| 116 | }
|
|---|
| 117 |
|
|---|
| 118 | $default = $cpan_home;
|
|---|
| 119 | while ($ans = prompt("CPAN build and cache directory?",$default)) {
|
|---|
| 120 | unless (File::Spec->file_name_is_absolute($ans)) {
|
|---|
| 121 | require Cwd;
|
|---|
| 122 | my $cwd = Cwd::cwd();
|
|---|
| 123 | my $absans = File::Spec->catdir($cwd,$ans);
|
|---|
| 124 | warn "The path '$ans' is not an absolute path. Please specify an absolute path\n";
|
|---|
| 125 | $default = $absans;
|
|---|
| 126 | next;
|
|---|
| 127 | }
|
|---|
| 128 | eval { File::Path::mkpath($ans); }; # dies if it can't
|
|---|
| 129 | if ($@) {
|
|---|
| 130 | warn "Couldn't create directory $ans.
|
|---|
| 131 | Please retry.\n";
|
|---|
| 132 | next;
|
|---|
| 133 | }
|
|---|
| 134 | if (-d $ans && -w _) {
|
|---|
| 135 | last;
|
|---|
| 136 | } else {
|
|---|
| 137 | warn "Couldn't find directory $ans
|
|---|
| 138 | or directory is not writable. Please retry.\n";
|
|---|
| 139 | }
|
|---|
| 140 | }
|
|---|
| 141 | $CPAN::Config->{cpan_home} = $ans;
|
|---|
| 142 |
|
|---|
| 143 | print qq{
|
|---|
| 144 |
|
|---|
| 145 | If you want, I can keep the source files after a build in the cpan
|
|---|
| 146 | home directory. If you choose so then future builds will take the
|
|---|
| 147 | files from there. If you don\'t want to keep them, answer 0 to the
|
|---|
| 148 | next question.
|
|---|
| 149 |
|
|---|
| 150 | };
|
|---|
| 151 |
|
|---|
| 152 | $CPAN::Config->{keep_source_where} = File::Spec->catdir($CPAN::Config->{cpan_home},"sources");
|
|---|
| 153 | $CPAN::Config->{build_dir} = File::Spec->catdir($CPAN::Config->{cpan_home},"build");
|
|---|
| 154 |
|
|---|
| 155 | #
|
|---|
| 156 | # Cache size, Index expire
|
|---|
| 157 | #
|
|---|
| 158 |
|
|---|
| 159 | print qq{
|
|---|
| 160 |
|
|---|
| 161 | How big should the disk cache be for keeping the build directories
|
|---|
| 162 | with all the intermediate files\?
|
|---|
| 163 |
|
|---|
| 164 | };
|
|---|
| 165 |
|
|---|
| 166 | $default = $CPAN::Config->{build_cache} || 10;
|
|---|
| 167 | $ans = prompt("Cache size for build directory (in MB)?", $default);
|
|---|
| 168 | $CPAN::Config->{build_cache} = $ans;
|
|---|
| 169 |
|
|---|
| 170 | # XXX This the time when we refetch the index files (in days)
|
|---|
| 171 | $CPAN::Config->{'index_expire'} = 1;
|
|---|
| 172 |
|
|---|
| 173 | print qq{
|
|---|
| 174 |
|
|---|
| 175 | By default, each time the CPAN module is started, cache scanning
|
|---|
| 176 | is performed to keep the cache size in sync. To prevent from this,
|
|---|
| 177 | disable the cache scanning with 'never'.
|
|---|
| 178 |
|
|---|
| 179 | };
|
|---|
| 180 |
|
|---|
| 181 | $default = $CPAN::Config->{scan_cache} || 'atstart';
|
|---|
| 182 | do {
|
|---|
| 183 | $ans = prompt("Perform cache scanning (atstart or never)?", $default);
|
|---|
| 184 | } while ($ans ne 'atstart' && $ans ne 'never');
|
|---|
| 185 | $CPAN::Config->{scan_cache} = $ans;
|
|---|
| 186 |
|
|---|
| 187 | #
|
|---|
| 188 | # cache_metadata
|
|---|
| 189 | #
|
|---|
| 190 | print qq{
|
|---|
| 191 |
|
|---|
| 192 | To considerably speed up the initial CPAN shell startup, it is
|
|---|
| 193 | possible to use Storable to create a cache of metadata. If Storable
|
|---|
| 194 | is not available, the normal index mechanism will be used.
|
|---|
| 195 |
|
|---|
| 196 | };
|
|---|
| 197 |
|
|---|
| 198 | defined($default = $CPAN::Config->{cache_metadata}) or $default = 1;
|
|---|
| 199 | do {
|
|---|
| 200 | $ans = prompt("Cache metadata (yes/no)?", ($default ? 'yes' : 'no'));
|
|---|
| 201 | } while ($ans !~ /^\s*[yn]/i);
|
|---|
| 202 | $CPAN::Config->{cache_metadata} = ($ans =~ /^\s*y/i ? 1 : 0);
|
|---|
| 203 |
|
|---|
| 204 | #
|
|---|
| 205 | # term_is_latin
|
|---|
| 206 | #
|
|---|
| 207 | print qq{
|
|---|
| 208 |
|
|---|
| 209 | The next option deals with the charset your terminal supports. In
|
|---|
| 210 | general CPAN is English speaking territory, thus the charset does not
|
|---|
| 211 | matter much, but some of the aliens out there who upload their
|
|---|
| 212 | software to CPAN bear names that are outside the ASCII range. If your
|
|---|
| 213 | terminal supports UTF-8, you say no to the next question, if it
|
|---|
| 214 | supports ISO-8859-1 (also known as LATIN1) then you say yes, and if it
|
|---|
| 215 | supports neither nor, your answer does not matter, you will not be
|
|---|
| 216 | able to read the names of some authors anyway. If you answer no, names
|
|---|
| 217 | will be output in UTF-8.
|
|---|
| 218 |
|
|---|
| 219 | };
|
|---|
| 220 |
|
|---|
| 221 | defined($default = $CPAN::Config->{term_is_latin}) or $default = 1;
|
|---|
| 222 | do {
|
|---|
| 223 | $ans = prompt("Your terminal expects ISO-8859-1 (yes/no)?",
|
|---|
| 224 | ($default ? 'yes' : 'no'));
|
|---|
| 225 | } while ($ans !~ /^\s*[yn]/i);
|
|---|
| 226 | $CPAN::Config->{term_is_latin} = ($ans =~ /^\s*y/i ? 1 : 0);
|
|---|
| 227 |
|
|---|
| 228 | #
|
|---|
| 229 | # save history in file histfile
|
|---|
| 230 | #
|
|---|
| 231 | print qq{
|
|---|
| 232 |
|
|---|
| 233 | If you have one of the readline packages (Term::ReadLine::Perl,
|
|---|
| 234 | Term::ReadLine::Gnu, possibly others) installed, the interactive CPAN
|
|---|
| 235 | shell will have history support. The next two questions deal with the
|
|---|
| 236 | filename of the history file and with its size. If you do not want to
|
|---|
| 237 | set this variable, please hit SPACE RETURN to the following question.
|
|---|
| 238 |
|
|---|
| 239 | };
|
|---|
| 240 |
|
|---|
| 241 | defined($default = $CPAN::Config->{histfile}) or
|
|---|
| 242 | $default = File::Spec->catfile($CPAN::Config->{cpan_home},"histfile");
|
|---|
| 243 | $ans = prompt("File to save your history?", $default);
|
|---|
| 244 | $ans =~ s/^\s+//;
|
|---|
| 245 | $ans =~ s/\s+\z//;
|
|---|
| 246 | $CPAN::Config->{histfile} = $ans;
|
|---|
| 247 |
|
|---|
| 248 | if ($CPAN::Config->{histfile}) {
|
|---|
| 249 | defined($default = $CPAN::Config->{histsize}) or $default = 100;
|
|---|
| 250 | $ans = prompt("Number of lines to save?", $default);
|
|---|
| 251 | $CPAN::Config->{histsize} = $ans;
|
|---|
| 252 | }
|
|---|
| 253 |
|
|---|
| 254 | #
|
|---|
| 255 | # prerequisites_policy
|
|---|
| 256 | # Do we follow PREREQ_PM?
|
|---|
| 257 | #
|
|---|
| 258 | print qq{
|
|---|
| 259 |
|
|---|
| 260 | The CPAN module can detect when a module that which you are trying to
|
|---|
| 261 | build depends on prerequisites. If this happens, it can build the
|
|---|
| 262 | prerequisites for you automatically ('follow'), ask you for
|
|---|
| 263 | confirmation ('ask'), or just ignore them ('ignore'). Please set your
|
|---|
| 264 | policy to one of the three values.
|
|---|
| 265 |
|
|---|
| 266 | };
|
|---|
| 267 |
|
|---|
| 268 | $default = $CPAN::Config->{prerequisites_policy} || 'ask';
|
|---|
| 269 | do {
|
|---|
| 270 | $ans =
|
|---|
| 271 | prompt("Policy on building prerequisites (follow, ask or ignore)?",
|
|---|
| 272 | $default);
|
|---|
| 273 | } while ($ans ne 'follow' && $ans ne 'ask' && $ans ne 'ignore');
|
|---|
| 274 | $CPAN::Config->{prerequisites_policy} = $ans;
|
|---|
| 275 |
|
|---|
| 276 | #
|
|---|
| 277 | # External programs
|
|---|
| 278 | #
|
|---|
| 279 |
|
|---|
| 280 | print qq{
|
|---|
| 281 |
|
|---|
| 282 | The CPAN module will need a few external programs to work properly.
|
|---|
| 283 | Please correct me, if I guess the wrong path for a program. Don\'t
|
|---|
| 284 | panic if you do not have some of them, just press ENTER for those. To
|
|---|
| 285 | disable the use of a download program, you can type a space followed
|
|---|
| 286 | by ENTER.
|
|---|
| 287 |
|
|---|
| 288 | };
|
|---|
| 289 |
|
|---|
| 290 | my $old_warn = $^W;
|
|---|
| 291 | local $^W if $^O eq 'MacOS';
|
|---|
| 292 | my(@path) = split /$Config{'path_sep'}/, $ENV{'PATH'};
|
|---|
| 293 | local $^W = $old_warn;
|
|---|
| 294 | my $progname;
|
|---|
| 295 | for $progname (qw/gzip tar unzip make lynx wget ncftpget ncftp ftp gpg/){
|
|---|
| 296 | if ($^O eq 'MacOS') {
|
|---|
| 297 | $CPAN::Config->{$progname} = 'not_here';
|
|---|
| 298 | next;
|
|---|
| 299 | }
|
|---|
| 300 | my $progcall = $progname;
|
|---|
| 301 | # we don't need ncftp if we have ncftpget
|
|---|
| 302 | next if $progname eq "ncftp" && $CPAN::Config->{ncftpget} gt " ";
|
|---|
| 303 | my $path = $CPAN::Config->{$progname}
|
|---|
| 304 | || $Config::Config{$progname}
|
|---|
| 305 | || "";
|
|---|
| 306 | if (File::Spec->file_name_is_absolute($path)) {
|
|---|
| 307 | # testing existence is not good enough, some have these exe
|
|---|
| 308 | # extensions
|
|---|
| 309 |
|
|---|
| 310 | # warn "Warning: configured $path does not exist\n" unless -e $path;
|
|---|
| 311 | # $path = "";
|
|---|
| 312 | } else {
|
|---|
| 313 | $path = '';
|
|---|
| 314 | }
|
|---|
| 315 | unless ($path) {
|
|---|
| 316 | # e.g. make -> nmake
|
|---|
| 317 | $progcall = $Config::Config{$progname} if $Config::Config{$progname};
|
|---|
| 318 | }
|
|---|
| 319 |
|
|---|
| 320 | $path ||= find_exe($progcall,[@path]);
|
|---|
| 321 | warn "Warning: $progcall not found in PATH\n" unless
|
|---|
| 322 | $path; # not -e $path, because find_exe already checked that
|
|---|
| 323 | $ans = prompt("Where is your $progname program?",$path) || $path;
|
|---|
| 324 | $CPAN::Config->{$progname} = $ans;
|
|---|
| 325 | }
|
|---|
| 326 | my $path = $CPAN::Config->{'pager'} ||
|
|---|
| 327 | $ENV{PAGER} || find_exe("less",[@path]) ||
|
|---|
| 328 | find_exe("more",[@path]) || ($^O eq 'MacOS' ? $ENV{EDITOR} : 0 )
|
|---|
| 329 | || "more";
|
|---|
| 330 | $ans = prompt("What is your favorite pager program?",$path);
|
|---|
| 331 | $CPAN::Config->{'pager'} = $ans;
|
|---|
| 332 | $path = $CPAN::Config->{'shell'};
|
|---|
| 333 | if (File::Spec->file_name_is_absolute($path)) {
|
|---|
| 334 | warn "Warning: configured $path does not exist\n" unless -e $path;
|
|---|
| 335 | $path = "";
|
|---|
| 336 | }
|
|---|
| 337 | $path ||= $ENV{SHELL};
|
|---|
| 338 | if ($^O eq 'MacOS') {
|
|---|
| 339 | $CPAN::Config->{'shell'} = 'not_here';
|
|---|
| 340 | } else {
|
|---|
| 341 | $path =~ s,\\,/,g if $^O eq 'os2'; # Cosmetic only
|
|---|
| 342 | $ans = prompt("What is your favorite shell?",$path);
|
|---|
| 343 | $CPAN::Config->{'shell'} = $ans;
|
|---|
| 344 | }
|
|---|
| 345 |
|
|---|
| 346 | #
|
|---|
| 347 | # Arguments to make etc.
|
|---|
| 348 | #
|
|---|
| 349 |
|
|---|
| 350 | print qq{
|
|---|
| 351 |
|
|---|
| 352 | Every Makefile.PL is run by perl in a separate process. Likewise we
|
|---|
| 353 | run \'make\' and \'make install\' in processes. If you have any
|
|---|
| 354 | parameters \(e.g. PREFIX, LIB, UNINST or the like\) you want to pass
|
|---|
| 355 | to the calls, please specify them here.
|
|---|
| 356 |
|
|---|
| 357 | If you don\'t understand this question, just press ENTER.
|
|---|
| 358 |
|
|---|
| 359 | };
|
|---|
| 360 |
|
|---|
| 361 | $default = $CPAN::Config->{makepl_arg} || "";
|
|---|
| 362 | $CPAN::Config->{makepl_arg} =
|
|---|
| 363 | prompt("Parameters for the 'perl Makefile.PL' command?
|
|---|
| 364 | Typical frequently used settings:
|
|---|
| 365 |
|
|---|
| 366 | PREFIX=~/perl non-root users (please see manual for more hints)
|
|---|
| 367 |
|
|---|
| 368 | Your choice: ",$default);
|
|---|
| 369 | $default = $CPAN::Config->{make_arg} || "";
|
|---|
| 370 | $CPAN::Config->{make_arg} = prompt("Parameters for the 'make' command?
|
|---|
| 371 | Typical frequently used setting:
|
|---|
| 372 |
|
|---|
| 373 | -j3 dual processor system
|
|---|
| 374 |
|
|---|
| 375 | Your choice: ",$default);
|
|---|
| 376 |
|
|---|
| 377 | $default = $CPAN::Config->{make_install_arg} || $CPAN::Config->{make_arg} || "";
|
|---|
| 378 | $CPAN::Config->{make_install_arg} =
|
|---|
| 379 | prompt("Parameters for the 'make install' command?
|
|---|
| 380 | Typical frequently used setting:
|
|---|
| 381 |
|
|---|
| 382 | UNINST=1 to always uninstall potentially conflicting files
|
|---|
| 383 |
|
|---|
| 384 | Your choice: ",$default);
|
|---|
| 385 |
|
|---|
| 386 | #
|
|---|
| 387 | # Alarm period
|
|---|
| 388 | #
|
|---|
| 389 |
|
|---|
| 390 | print qq{
|
|---|
| 391 |
|
|---|
| 392 | Sometimes you may wish to leave the processes run by CPAN alone
|
|---|
| 393 | without caring about them. As sometimes the Makefile.PL contains
|
|---|
| 394 | question you\'re expected to answer, you can set a timer that will
|
|---|
| 395 | kill a 'perl Makefile.PL' process after the specified time in seconds.
|
|---|
| 396 |
|
|---|
| 397 | If you set this value to 0, these processes will wait forever. This is
|
|---|
| 398 | the default and recommended setting.
|
|---|
| 399 |
|
|---|
| 400 | };
|
|---|
| 401 |
|
|---|
| 402 | $default = $CPAN::Config->{inactivity_timeout} || 0;
|
|---|
| 403 | $CPAN::Config->{inactivity_timeout} =
|
|---|
| 404 | prompt("Timeout for inactivity during Makefile.PL?",$default);
|
|---|
| 405 |
|
|---|
| 406 | # Proxies
|
|---|
| 407 |
|
|---|
| 408 | print qq{
|
|---|
| 409 |
|
|---|
| 410 | If you\'re accessing the net via proxies, you can specify them in the
|
|---|
| 411 | CPAN configuration or via environment variables. The variable in
|
|---|
| 412 | the \$CPAN::Config takes precedence.
|
|---|
| 413 |
|
|---|
| 414 | };
|
|---|
| 415 |
|
|---|
| 416 | for (qw/ftp_proxy http_proxy no_proxy/) {
|
|---|
| 417 | $default = $CPAN::Config->{$_} || $ENV{$_};
|
|---|
| 418 | $CPAN::Config->{$_} = prompt("Your $_?",$default);
|
|---|
| 419 | }
|
|---|
| 420 |
|
|---|
| 421 | if ($CPAN::Config->{ftp_proxy} ||
|
|---|
| 422 | $CPAN::Config->{http_proxy}) {
|
|---|
| 423 | $default = $CPAN::Config->{proxy_user} || $CPAN::LWP::UserAgent::USER;
|
|---|
| 424 | print qq{
|
|---|
| 425 |
|
|---|
|
|---|
