SIGN => 1 support for MakeMaker
[p5sagit/p5-mst-13.2.git] / lib / ExtUtils / Command.pm
index 8c4fd7a..12e2b99 100644 (file)
@@ -1,6 +1,8 @@
 package ExtUtils::Command;
+
+use 5.00503;
 use strict;
-# use AutoLoader;
+use Carp;
 use File::Copy;
 use File::Compare;
 use File::Basename;
@@ -9,40 +11,62 @@ require Exporter;
 use vars qw(@ISA @EXPORT $VERSION);
 @ISA     = qw(Exporter);
 @EXPORT  = qw(cp rm_f rm_rf mv cat eqtime mkpath touch test_f);
-$VERSION = '1.00';
+$VERSION = '1.05';
+
+my $Is_VMS = $^O eq 'VMS';
 
 =head1 NAME
 
 ExtUtils::Command - utilities to replace common UNIX commands in Makefiles etc.
 
-=head1 SYNOPSYS
+=head1 SYNOPSIS
 
-  perl -MExtUtils::command -e cat files... > destination
-  perl -MExtUtils::command -e mv source... destination
-  perl -MExtUtils::command -e cp source... destination
-  perl -MExtUtils::command -e touch files...
-  perl -MExtUtils::command -e rm_f file...
-  perl -MExtUtils::command -e rm_rf directories...
-  perl -MExtUtils::command -e mkpath directories...
-  perl -MExtUtils::command -e eqtime source destination
-  perl -MExtUtils::command -e chmod mode files...
-  perl -MExtUtils::command -e test_f file
+  perl -MExtUtils::Command       -e cat files... > destination
+  perl -MExtUtils::Command       -e mv source... destination
+  perl -MExtUtils::Command       -e cp source... destination
+  perl -MExtUtils::Command       -e touch files...
+  perl -MExtUtils::Command       -e rm_f files...
+  perl -MExtUtils::Command       -e rm_rf directories...
+  perl -MExtUtils::Command       -e mkpath directories...
+  perl -MExtUtils::Command       -e eqtime source destination
+  perl -MExtUtils::Command       -e test_f file
+  perl -MExtUtils::Command=chmod -e chmod mode files...
 
 =head1 DESCRIPTION
 
-The module is used in Win32 port to replace common UNIX commands.
-Most commands are wrapers on generic modules File::Path and File::Basename.
+The module is used to replace common UNIX commands.  In all cases the
+functions work from @ARGV rather than taking arguments.  This makes
+them easier to deal with in Makefiles.
+
+  perl -MExtUtils::Command -e some_command some files to work on
+
+I<NOT>
+
+  perl -MExtUtils::Command -e 'some_command qw(some files to work on)'
+
+Filenames with * and ? will be glob expanded.
 
 =over 4
 
+=cut
+
+# VMS uses % instead of ? to mean "one character"
+my $wild_regex = $Is_VMS ? '*%' : '*?';
+sub expand_wildcards
+{
+ @ARGV = map(/[$wild_regex]/o ? glob($_) : $_,@ARGV);
+}
+
+
 =item cat 
 
-Concatenates all files menthion on command line to STDOUT.
+Concatenates all files mentioned on command line to STDOUT.
 
 =cut 
 
 sub cat ()
 {
+ expand_wildcards();
  print while (<>);
 }
 
@@ -55,12 +79,11 @@ Sets modified time of dst to that of src
 sub eqtime
 {
  my ($src,$dst) = @ARGV;
- open(F,">$dst");
- close(F);
+ local @ARGV = ($dst);  touch();  # in case $dst doesn't exist
  utime((stat($src))[8,9],$dst);
 }
 
-=item rm_f files....
+=item rm_rf files....
 
 Removes directories - recursively (even if readonly)
 
@@ -68,7 +91,8 @@ Removes directories - recursively (even if readonly)
 
 sub rm_rf
 {
- rmtree([@ARGV],0,0);
+ expand_wildcards();
+ rmtree([grep -e $_,@ARGV],0,0);
 }
 
 =item rm_f files....
@@ -79,12 +103,14 @@ Removes files (even if readonly)
 
 sub rm_f
 {
+ expand_wildcards();
  foreach (@ARGV)
   {
-   next unless -e $_;
+   next unless -f $_;
+   next if unlink($_);
    chmod(0777,$_);
-   next if (-f $_ and unlink($_));
-   die "Cannot delete $_:$!";
+   next if unlink($_);
+   carp "Cannot delete $_:$!";
   }
 }
 
@@ -94,14 +120,14 @@ Makes files exist, with current timestamp
 
 =cut 
 
-sub touch
-{
- while (@ARGV)
-  {
-   my $file = shift(@ARGV);               
-   open(FILE,">>$file") || die "Cannot write $file:$!";
-   close(FILE);
-  }
+sub touch {
+    my $t    = time;
+    expand_wildcards();
+    foreach my $file (@ARGV) {
+        open(FILE,">>$file") || die "Cannot write $file:$!";
+        close(FILE);
+        utime($t,$t,$file);
+    }
 }
 
 =item mv source... destination
@@ -111,23 +137,13 @@ Multiple sources are allowed if destination is an existing directory.
 
 =cut 
 
-sub mv
-{
- my $dst = pop(@ARGV);
- if (-d $dst)
-  {
-   while (@ARGV)
-    {
-     my $src = shift(@ARGV);               
-     my $leaf = basename($src);            
-     move($src,"$dst/$leaf");  # fixme
+sub mv {
+    my $dst = pop(@ARGV);
+    expand_wildcards();
+    croak("Too many arguments") if (@ARGV > 1 && ! -d $dst);
+    foreach my $src (@ARGV) {
+        move($src,$dst);
     }
-  }
- else
-  {
-   my $src = shift(@ARGV);
-   move($src,$dst) || die "Cannot move $src $dst:$!";
-  }
 }
 
 =item cp source... destination
@@ -135,35 +151,27 @@ sub mv
 Copies source to destination.
 Multiple sources are allowed if destination is an existing directory.
 
-=cut 
+=cut
 
-sub cp
-{
- my $dst = pop(@ARGV);
- if (-d $dst)
-  {
-   while (@ARGV)
-    {
-     my $src = shift(@ARGV);               
-     my $leaf = basename($src);            
-     copy($src,"$dst/$leaf");  # fixme
+sub cp {
+    my $dst = pop(@ARGV);
+    expand_wildcards();
+    croak("Too many arguments") if (@ARGV > 1 && ! -d $dst);
+    foreach my $src (@ARGV) {
+        copy($src,$dst);
     }
-  }
- else
-  {
-   copy(shift,$dst);
-  }
 }
 
 =item chmod mode files...
 
-Sets UNIX like permissions 'mode' on all the files.
+Sets UNIX like permissions 'mode' on all the files.  e.g. 0666
 
 =cut 
 
-sub chmod
-{
- chmod(@ARGV) || die "Cannot chmod ".join(' ',@ARGV).":$!";
+sub chmod {
+    my $mode = shift(@ARGV);
+    expand_wildcards();
+    chmod(oct $mode,@ARGV) || die "Cannot chmod ".join(' ',$mode,@ARGV).":$!";
 }
 
 =item mkpath directory...
@@ -174,7 +182,8 @@ Creates directory, including any parent directories.
 
 sub mkpath
 {
- File::Path::mkpath([@ARGV],1,0777);
+ expand_wildcards();
+ File::Path::mkpath([@ARGV],0,0777);
 }
 
 =item test_f file
@@ -188,6 +197,7 @@ sub test_f
  exit !-f shift(@ARGV);
 }
 
+
 1;
 __END__ 
 
@@ -195,9 +205,6 @@ __END__
 
 =head1 BUGS
 
-eqtime does not work right on Win32 due to problems with utime() built-in
-command.
-
 Should probably be Auto/Self loaded.
 
 =head1 SEE ALSO