home *** CD-ROM | disk | FTP | other *** search
- package File::CheckTree;
- require 5.000;
- require Exporter;
-
- =head1 NAME
-
- validate - run many filetest checks on a tree
-
- =head1 SYNOPSIS
-
- use File::CheckTree;
-
- $warnings += validate( q{
- /vmunix -e || die
- /boot -e || die
- /bin cd
- csh -ex
- csh !-ug
- sh -ex
- sh !-ug
- /usr -d || warn "What happened to $file?\n"
- });
-
- =head1 DESCRIPTION
-
- The validate() routine takes a single multiline string consisting of
- lines containing a filename plus a file test to try on it. (The
- file test may also be a "cd", causing subsequent relative filenames
- to be interpreted relative to that directory.) After the file test
- you may put C<|| die> to make it a fatal error if the file test fails.
- The default is C<|| warn>. The file test may optionally have a "!' prepended
- to test for the opposite condition. If you do a cd and then list some
- relative filenames, you may want to indent them slightly for readability.
- If you supply your own die() or warn() message, you can use $file to
- interpolate the filename.
-
- Filetests may be bunched: "-rwx" tests for all of C<-r>, C<-w>, and C<-x>.
- Only the first failed test of the bunch will produce a warning.
-
- The routine returns the number of warnings issued.
-
- =cut
-
- @ISA = qw(Exporter);
- @EXPORT = qw(validate);
-
- # $RCSfile: validate.pl,v $$Revision: 4.1 $$Date: 92/08/07 18:24:19 $
-
- # The validate routine takes a single multiline string consisting of
- # lines containing a filename plus a file test to try on it. (The
- # file test may also be a 'cd', causing subsequent relative filenames
- # to be interpreted relative to that directory.) After the file test
- # you may put '|| die' to make it a fatal error if the file test fails.
- # The default is '|| warn'. The file test may optionally have a ! prepended
- # to test for the opposite condition. If you do a cd and then list some
- # relative filenames, you may want to indent them slightly for readability.
- # If you supply your own "die" or "warn" message, you can use $file to
- # interpolate the filename.
-
- # Filetests may be bunched: -rwx tests for all of -r, -w and -x.
- # Only the first failed test of the bunch will produce a warning.
-
- # The routine returns the number of warnings issued.
-
- # Usage:
- # use File::CheckTree;
- # $warnings += validate('
- # /vmunix -e || die
- # /boot -e || die
- # /bin cd
- # csh -ex
- # csh !-ug
- # sh -ex
- # sh !-ug
- # /usr -d || warn "What happened to $file?\n"
- # ');
-
- sub validate {
- local($file,$test,$warnings,$oldwarnings);
- foreach $check (split(/\n/,$_[0])) {
- next if $check =~ /^#/;
- next if $check =~ /^$/;
- ($file,$test) = split(' ',$check,2);
- if ($test =~ s/^(!?-)(\w{2,}\b)/$1Z/) {
- $testlist = $2;
- @testlist = split(//,$testlist);
- }
- else {
- @testlist = ('Z');
- }
- $oldwarnings = $warnings;
- foreach $one (@testlist) {
- $this = $test;
- $this =~ s/(-\w\b)/$1 \$file/g;
- $this =~ s/-Z/-$one/;
- $this .= ' || warn' unless $this =~ /\|\|/;
- $this =~ s/^(.*\S)\s*\|\|\s*(die|warn)$/$1 || valmess('$2','$1')/;
- $this =~ s/\bcd\b/chdir (\$cwd = \$file)/g;
- eval $this;
- last if $warnings > $oldwarnings;
- }
- }
- $warnings;
- }
-
- sub valmess {
- local($disposition,$this) = @_;
- $file = $cwd . '/' . $file unless $file =~ m|^/|s;
- if ($this =~ /^(!?)-(\w)\s+\$file\s*$/) {
- $neg = $1;
- $tmp = $2;
- $tmp eq 'r' && ($mess = "$file is not readable by uid $>.");
- $tmp eq 'w' && ($mess = "$file is not writable by uid $>.");
- $tmp eq 'x' && ($mess = "$file is not executable by uid $>.");
- $tmp eq 'o' && ($mess = "$file is not owned by uid $>.");
- $tmp eq 'R' && ($mess = "$file is not readable by you.");
- $tmp eq 'W' && ($mess = "$file is not writable by you.");
- $tmp eq 'X' && ($mess = "$file is not executable by you.");
- $tmp eq 'O' && ($mess = "$file is not owned by you.");
- $tmp eq 'e' && ($mess = "$file does not exist.");
- $tmp eq 'z' && ($mess = "$file does not have zero size.");
- $tmp eq 's' && ($mess = "$file does not have non-zero size.");
- $tmp eq 'f' && ($mess = "$file is not a plain file.");
- $tmp eq 'd' && ($mess = "$file is not a directory.");
- $tmp eq 'l' && ($mess = "$file is not a symbolic link.");
- $tmp eq 'p' && ($mess = "$file is not a named pipe (FIFO).");
- $tmp eq 'S' && ($mess = "$file is not a socket.");
- $tmp eq 'b' && ($mess = "$file is not a block special file.");
- $tmp eq 'c' && ($mess = "$file is not a character special file.");
- $tmp eq 'u' && ($mess = "$file does not have the setuid bit set.");
- $tmp eq 'g' && ($mess = "$file does not have the setgid bit set.");
- $tmp eq 'k' && ($mess = "$file does not have the sticky bit set.");
- $tmp eq 'T' && ($mess = "$file is not a text file.");
- $tmp eq 'B' && ($mess = "$file is not a binary file.");
- if ($neg eq '!') {
- $mess =~ s/ is not / should not be / ||
- $mess =~ s/ does not / should not / ||
- $mess =~ s/ not / /;
- }
- }
- else {
- $this =~ s/\$file/'$file'/g;
- $mess = "Can't do $this.\n";
- }
- die "$mess\n" if $disposition eq 'die';
- warn "$mess\n";
- ++$warnings;
- }
-
- 1;
-
-