Adjust docs to reflect that DynaLoader, as of change 27549,
[p5sagit/p5-mst-13.2.git] / lib / ExtUtils / t / Manifest.t
1 #!/usr/bin/perl -w
2
3 BEGIN {
4     if( $ENV{PERL_CORE} ) {
5         chdir 't' if -d 't';
6         unshift @INC, '../lib';
7     }
8     else {
9         unshift @INC, 't/lib';
10     }
11 }
12 chdir 't';
13
14 use strict;
15
16 use Test::More tests => 49;
17 use Cwd;
18
19 use File::Spec;
20 use File::Path;
21 use File::Find;
22
23 my $Is_VMS = $^O eq 'VMS';
24
25 # We're going to be chdir'ing and modules are sometimes loaded on the
26 # fly in this test, so we need an absolute @INC.
27 @INC = map { File::Spec->rel2abs($_) } @INC;
28
29 # keep track of everything added so it can all be deleted
30 my %Files;
31 sub add_file {
32     my ($file, $data) = @_;
33     $data ||= 'foo';
34     1 while unlink $file;  # or else we'll get multiple versions on VMS
35     open( T, '>'.$file) or return;
36     print T $data;
37     ++$Files{$file};
38     close T;
39 }
40
41 sub read_manifest {
42     open( M, 'MANIFEST' ) or return;
43     chomp( my @files = <M> );
44     close M;
45     return @files;
46 }
47
48 sub catch_warning {
49     my $warn;
50     local $SIG{__WARN__} = sub { $warn .= $_[0] };
51     return join('', $_[0]->() ), $warn;
52 }
53
54 sub remove_dir {
55     ok( rmdir( $_ ), "remove $_ directory" ) for @_;
56 }
57
58 # use module, import functions
59 BEGIN { 
60     use_ok( 'ExtUtils::Manifest', 
61             qw( mkmanifest manicheck filecheck fullcheck 
62                 maniread manicopy skipcheck maniadd) ); 
63 }
64
65 my $cwd = Cwd::getcwd();
66
67 # Just in case any old files were lying around.
68 rmtree('mantest');
69
70 ok( mkdir( 'mantest', 0777 ), 'make mantest directory' );
71 ok( chdir( 'mantest' ), 'chdir() to mantest' );
72 ok( add_file('foo'), 'add a temporary file' );
73
74 # there shouldn't be a MANIFEST there
75 my ($res, $warn) = catch_warning( \&mkmanifest ); 
76 # Canonize the order.
77 $warn = join("", map { "$_|" } 
78                  sort { lc($a) cmp lc($b) } split /\r?\n/, $warn);
79 is( $warn, "Added to MANIFEST: foo|Added to MANIFEST: MANIFEST|",
80     "mkmanifest() displayed its additions" );
81
82 # and now you see it
83 ok( -e 'MANIFEST', 'create MANIFEST file' );
84
85 my @list = read_manifest();
86 is( @list, 2, 'check files in MANIFEST' );
87 ok( ! ExtUtils::Manifest::filecheck(), 'no additional files in directory' );
88
89 # after adding bar, the MANIFEST is out of date
90 ok( add_file( 'bar' ), 'add another file' );
91 ok( ! manicheck(), 'MANIFEST now out of sync' );
92
93 # it reports that bar has been added and throws a warning
94 ($res, $warn) = catch_warning( \&filecheck );
95
96 like( $warn, qr/^Not in MANIFEST: bar/, 'warning that bar has been added' );
97 is( $res, 'bar', 'bar reported as new' );
98
99 # now quiet the warning that bar was added and test again
100 ($res, $warn) = do { local $ExtUtils::Manifest::Quiet = 1; 
101                      catch_warning( \&skipcheck ) 
102                 };
103 ok( ! defined $warn, 'disabled warnings' );
104
105 # add a skip file with a rule to skip itself (and the nonexistent glob '*baz*')
106 add_file( 'MANIFEST.SKIP', "baz\n.SKIP" );
107
108 # this'll skip the new file
109 ($res, $warn) = catch_warning( \&skipcheck );
110 like( $warn, qr/^Skipping MANIFEST\.SKIP/i, 'got skipping warning' );
111
112 my @skipped;
113 catch_warning( sub {
114         @skipped = skipcheck()
115 });
116
117 is( join( ' ', @skipped ), 'MANIFEST.SKIP', 'listed skipped files' );
118
119 {
120         local $ExtUtils::Manifest::Quiet = 1;
121         is( join(' ', filecheck() ), 'bar', 'listing skipped with filecheck()' );
122 }
123
124 # add a subdirectory and a file there that should be found
125 ok( mkdir( 'moretest', 0777 ), 'created moretest directory' );
126 add_file( File::Spec->catfile('moretest', 'quux'), 'quux' );
127 ok( exists( ExtUtils::Manifest::manifind()->{'moretest/quux'} ), 
128                                         "manifind found moretest/quux" );
129
130 # only MANIFEST and foo are in the manifest
131 $_ = 'foo';
132 my $files = maniread();
133 is( keys %$files, 2, 'two files found' );
134 is( join(' ', sort { lc($a) cmp lc($b) } keys %$files), 'foo MANIFEST', 
135                                         'both files found' );
136 is( $_, 'foo', q{maniread() doesn't clobber $_} );
137
138 ok( mkdir( 'copy', 0777 ), 'made copy directory' );
139
140 # Check that manicopy copies files.
141 manicopy( $files, 'copy', 'cp' );
142 my @copies = ();
143 find( sub { push @copies, $_ if -f }, 'copy' );
144 @copies = map { s/\.$//; $_ } @copies if $Is_VMS;  # VMS likes to put dots on
145                                                    # the end of files.
146 # Have to compare insensitively for non-case preserving VMS
147 is_deeply( [sort map { lc } @copies], [sort map { lc } keys %$files] );
148
149 # cp would leave files readonly, so check permissions.
150 foreach my $orig (@copies) {
151     my $copy = "copy/$orig";
152     ok( -r $copy,               "$copy: must be readable" );
153
154   SKIP: {
155     skip "       original was not writable", 1 unless -w $orig;
156     ok(-w $copy, "       writable if original was" );
157   }
158
159   SKIP: {
160     skip "       original was not executable", 1 unless -x $orig;
161     ok(-x $copy, "       executable if original was" );
162   }
163 }
164 rmtree('copy');
165
166
167 # poison the manifest, and add a comment that should be reported
168 add_file( 'MANIFEST', 'none #none' );
169 is( ExtUtils::Manifest::maniread()->{none}, '#none', 
170                                         'maniread found comment' );
171
172 ok( mkdir( 'copy', 0777 ), 'made copy directory' );
173 $files = maniread();
174 eval { (undef, $warn) = catch_warning( sub {
175                 manicopy( $files, 'copy', 'cp' ) }) 
176 };
177 like( $@, qr/^Can't read none: /, 'croaked about none' );
178
179 # a newline comes through, so get rid of it
180 chomp($warn);
181
182 # the copy should have given one warning and one error
183 like($warn, qr/^Skipping MANIFEST.SKIP/i, 'warned about MANIFEST.SKIP' );
184
185 # tell ExtUtils::Manifest to use a different file
186 {
187         local $ExtUtils::Manifest::MANIFEST = 'albatross'; 
188         ($res, $warn) = catch_warning( \&mkmanifest );
189         like( $warn, qr/Added to albatross: /, 'using a new manifest file' );
190         
191         # add the new file to the list of files to be deleted
192         $Files{'albatross'}++;
193 }
194
195
196 # Make sure MANIFEST.SKIP is using complete relative paths
197 add_file( 'MANIFEST.SKIP' => "^moretest/q\n" );
198
199 # This'll skip moretest/quux
200 ($res, $warn) = catch_warning( \&skipcheck );
201 like( $warn, qr{^Skipping moretest/quux$}i, 'got skipping warning again' );
202
203
204 # There was a bug where entries in MANIFEST would be blotted out
205 # by MANIFEST.SKIP rules.
206 add_file( 'MANIFEST.SKIP' => 'foo' );
207 add_file( 'MANIFEST'      => "foobar\n"   );
208 add_file( 'foobar'        => '123' );
209 ($res, $warn) = catch_warning( \&manicheck );
210 is( $res,  '',      'MANIFEST overrides MANIFEST.SKIP' );
211 is( $warn, undef,   'MANIFEST overrides MANIFEST.SKIP, no warnings' );
212
213 $files = maniread;
214 ok( !$files->{wibble},     'MANIFEST in good state' );
215 maniadd({ wibble => undef });
216 maniadd({ yarrow => "hock" });
217 $files = maniread;
218 is( $files->{wibble}, '',    'maniadd() with undef comment' );
219 is( $files->{yarrow}, 'hock','          with comment' );
220 is( $files->{foobar}, '',    '          preserved old entries' );
221
222 add_file('MANIFEST'   => 'Makefile.PL');
223 maniadd({ foo  => 'bar' });
224 $files = maniread;
225 # VMS downcases the MANIFEST.  We normalize it here to match.
226 %$files = map { (lc $_ => $files->{$_}) } keys %$files;
227 my %expect = ( 'makefile.pl' => '',
228                'foo'    => 'bar'
229              );
230 is_deeply( $files, \%expect, 'maniadd() vs MANIFEST without trailing newline');
231
232 add_file('MANIFEST'   => 'Makefile.PL');
233 maniadd({ foo => 'bar' });
234
235 SKIP: {
236     chmod( 0400, 'MANIFEST' );
237     skip "Can't make MANIFEST read-only", 2 if -w 'MANIFEST';
238
239     eval {
240         maniadd({ 'foo' => 'bar' });
241     };
242     is( $@, '',  "maniadd() won't open MANIFEST if it doesn't need to" );
243
244     eval {
245         maniadd({ 'grrrwoof' => 'yippie' });
246     };
247     like( $@, qr/^\Qmaniadd() could not open MANIFEST:\E/,  
248                  "maniadd() dies if it can't open the MANIFEST" );
249
250     chmod( 0600, 'MANIFEST' );
251 }
252
253
254 END {
255         is( unlink( keys %Files ), keys %Files, 'remove all added files' );
256         remove_dir( 'moretest', 'copy' );
257
258         # now get rid of the parent directory
259         ok( chdir( $cwd ), 'return to parent directory' );
260         remove_dir( 'mantest' );
261 }
262