scripts/perl.prov

   1 #!/usr/bin/perl
   2
   3 # RPM (and it's source code) is covered under two separate licenses.
   4
   5 # The entire code base may be distributed under the terms of the GNU
   6 # General Public License (GPL), which appears immediately below.
   7 # Alternatively, all of the source code in the lib subdirectory of the
   8 # RPM source code distribution as well as any code derived from that
   9 # code may instead be distributed under the GNU Library General Public
  10 # License (LGPL), at the choice of the distributor. The complete text
  11 # of the LGPL appears at the bottom of this file.
  12
  13 # This alternative is allowed to enable applications to be linked
  14 # against the RPM library (commonly called librpm) without forcing
  15 # such applications to be distributed under the GPL.
  16
  17 # Any questions regarding the licensing of RPM should be addressed to
  18 # Erik Troan <ewt@redhat.com>.
  19
  20 # a simple script to print the proper name for perl libraries.
  21
  22 # To save development time I do not parse the perl grammmar but
  23 # instead just lex it looking for what I want.  I take special care to
  24 # ignore comments and pod's.
  25
  26 # it would be much better if perl could tell us the proper name of a
  27 # given script.
  28
  29 # The filenames to scan are either passed on the command line or if
  30 # that is empty they are passed via stdin.
  31
  32 # If there are lines in the file which match the pattern
  33 #      (m/^\s*\$VERSION\s*=\s+/)
  34 # then these are taken to be the version numbers of the modules.
  35 # Special care is taken with a few known idioms for specifying version
  36 # numbers of files under rcs/cvs control.
  37
  38 # If there are strings in the file which match the pattern
  39 #     m/^\s*\$RPM_Provides\s*=\s*["'](.*)['"]/i
  40 # then these are treated as additional names which are provided by the
  41 # file and are printed as well.
  42
  43 # I plan to rewrite this in C so that perl is not required by RPM at
  44 # build time.
  45
  46 # by Ken Estes Mail.com kestes@staff.mail.com
  47
  48 if ("@ARGV") {
  49   foreach (@ARGV) {
  50     process_file($_);
  51   }
  52 } else {
  53
  54   # notice we are passed a list of filenames NOT as common in unix the
  55   # contents of the file.
  56
  57   foreach (<>) {
  58     process_file($_);
  59   }
  60 }
  61
  62
  63 foreach $module (sort keys %require) {
  64   if (length($require{$module}) == 0) {
  65     print "perl($module)\n";
  66   } else {
  67
  68     # I am not using rpm3.0 so I do not want spaces arround my
  69     # operators. Also I will need to change the processing of the
  70     # $RPM_* variable when I upgrade.
  71
  72     print "perl($module) = $require{$module}\n";
  73   }
  74 }
  75
  76 exit 0;
  77
  78
  79
  80 sub process_file {
  81
  82   my ($file) = @_;
  83   chomp $file;
  84
  85   open(FILE, "<$file") || return;
  86
  87   my ($package, $version) = ();
  88
  89   while (<FILE>) {
  90
  91     # skip the documentation
  92
  93     # we should not need to have item in this if statement (it
  94     # properly belongs in the over/back section) but people do not
  95     # read the perldoc.
  96
  97     if ( (m/^=(head1|head2|pod|item)/) .. (m/^=(cut)/) ) {
  98       next;
  99     }
 100
 101     if ( (m/^=(over)/) .. (m/^=(back)/) ) {
 102       next;
 103     }
 104
 105     # skip the data section
 106     if (m/^__(DATA|END)__$/) {
 107       last;
 108     }
 109
 110     # not everyone puts the package name of the file as the first
 111     # package name so we report all namespaces as if they were
 112     # provided packages (really ugly).
 113
 114     if (m/^\s*package\s+([_:a-zA-Z0-9]+)\s*;/) {
 115       $package=$1;
 116       undef $version;
 117       $require{$package}=undef;
 118     }
 119
 120     # after we found the package name take the first assignment to
 121     # $VERSION as the version number. Exporter requires that the
 122     # variable be called VERSION so we are safe.
 123
 124     # here are examples of VERSION lines from the perl distribution
 125
 126     #FindBin.pm:$VERSION = $VERSION = sprintf("%d.%02d", q$Revision: 1.4 $ =~ /(\d+)\.(\d+)/);
 127     #ExtUtils/Install.pm:$VERSION = substr q$Revision: 1.4 $, 10;
 128     #CGI/Apache.pm:$VERSION = (qw$Revision: 1.4 $)[1];
 129     #DynaLoader.pm:$VERSION = $VERSION = "1.03";     # avoid typo warning
 130
 131     if (
 132         ($package) &&
 133         (m/^\s*\$VERSION\s*=\s+/)
 134        ) {
 135
 136       # first see if the version string contains the string
 137       # '$Revision' this often causes bizzare strings and is the most
 138       # common method of non static numbering.
 139
 140       if (m/(\$Revision: (\d+[.0-9]+))/) {
 141         $version= $2;
 142       } elsif (m/[\'\"]?(\d+[.0-9]+)[\'\"]?/) {
 143
 144         # look for a static number hard coded in the script
 145
 146         $version= $1;
 147       }
 148       $require{$package}=$version;
 149     }
 150
 151     # Each keyword can appear multiple times.  Don't
 152     #  bother with datastructures to store these strings,
 153     #  if we need to print it print it now.
 154
 155     if ( m/^\s*\$RPM_Provides\s*=\s*["'](.*)['"]/i) {
 156       foreach $_ (spit(/\s+/, $1)) {
 157         print "$_\n";
 158       }
 159     }
 160
 161   }
 162
 163   close(FILE) ||
 164     die("$0: Could not close file: '$file' : $!\n");
 165
 166   return ;
 167 }