Introduce NVef, NVff, and NVgf, use the middle one.
[perl.git] / lib / validate.pl
1 ;# $RCSfile: validate.pl,v $$Revision: 4.1 $$Date: 92/08/07 18:24:19 $
2
3 ;# The validate routine takes a single multiline string consisting of
4 ;# lines containing a filename plus a file test to try on it.  (The
5 ;# file test may also be a 'cd', causing subsequent relative filenames
6 ;# to be interpreted relative to that directory.)  After the file test
7 ;# you may put '|| die' to make it a fatal error if the file test fails.
8 ;# The default is '|| warn'.  The file test may optionally have a ! prepended
9 ;# to test for the opposite condition.  If you do a cd and then list some
10 ;# relative filenames, you may want to indent them slightly for readability.
11 ;# If you supply your own "die" or "warn" message, you can use $file to
12 ;# interpolate the filename.
13
14 ;# Filetests may be bunched:  -rwx tests for all of -r, -w and -x.
15 ;# Only the first failed test of the bunch will produce a warning.
16
17 ;# The routine returns the number of warnings issued.
18
19 ;# Usage:
20 ;#      require "validate.pl";
21 ;#      $warnings += do validate('
22 ;#      /vmunix                 -e || die
23 ;#      /boot                   -e || die
24 ;#      /bin                    cd
25 ;#          csh                 -ex
26 ;#          csh                 !-ug
27 ;#          sh                  -ex
28 ;#          sh                  !-ug
29 ;#      /usr                    -d || warn "What happened to $file?\n"
30 ;#      ');
31
32 sub validate {
33     local($file,$test,$warnings,$oldwarnings);
34     foreach $check (split(/\n/,$_[0])) {
35         next if $check =~ /^#/;
36         next if $check =~ /^$/;
37         ($file,$test) = split(' ',$check,2);
38         if ($test =~ s/^(!?-)(\w{2,}\b)/$1Z/) {
39             $testlist = $2;
40             @testlist = split(//,$testlist);
41         }
42         else {
43             @testlist = ('Z');
44         }
45         $oldwarnings = $warnings;
46         foreach $one (@testlist) {
47             $this = $test;
48             $this =~ s/(-\w\b)/$1 \$file/g;
49             $this =~ s/-Z/-$one/;
50             $this .= ' || warn' unless $this =~ /\|\|/;
51             $this =~ s/^(.*\S)\s*\|\|\s*(die|warn)$/$1 || do valmess('$2','$1')/;
52             $this =~ s/\bcd\b/chdir (\$cwd = \$file)/g;
53             eval $this;
54             last if $warnings > $oldwarnings;
55         }
56     }
57     $warnings;
58 }
59
60 sub valmess {
61     local($disposition,$this) = @_;
62     $file = $cwd . '/' . $file unless $file =~ m|^/|;
63     if ($this =~ /^(!?)-(\w)\s+\$file\s*$/) {
64         $neg = $1;
65         $tmp = $2;
66         $tmp eq 'r' && ($mess = "$file is not readable by uid $>.");
67         $tmp eq 'w' && ($mess = "$file is not writable by uid $>.");
68         $tmp eq 'x' && ($mess = "$file is not executable by uid $>.");
69         $tmp eq 'o' && ($mess = "$file is not owned by uid $>.");
70         $tmp eq 'R' && ($mess = "$file is not readable by you.");
71         $tmp eq 'W' && ($mess = "$file is not writable by you.");
72         $tmp eq 'X' && ($mess = "$file is not executable by you.");
73         $tmp eq 'O' && ($mess = "$file is not owned by you.");
74         $tmp eq 'e' && ($mess = "$file does not exist.");
75         $tmp eq 'z' && ($mess = "$file does not have zero size.");
76         $tmp eq 's' && ($mess = "$file does not have non-zero size.");
77         $tmp eq 'f' && ($mess = "$file is not a plain file.");
78         $tmp eq 'd' && ($mess = "$file is not a directory.");
79         $tmp eq 'l' && ($mess = "$file is not a symbolic link.");
80         $tmp eq 'p' && ($mess = "$file is not a named pipe (FIFO).");
81         $tmp eq 'S' && ($mess = "$file is not a socket.");
82         $tmp eq 'b' && ($mess = "$file is not a block special file.");
83         $tmp eq 'c' && ($mess = "$file is not a character special file.");
84         $tmp eq 'u' && ($mess = "$file does not have the setuid bit set.");
85         $tmp eq 'g' && ($mess = "$file does not have the setgid bit set.");
86         $tmp eq 'k' && ($mess = "$file does not have the sticky bit set.");
87         $tmp eq 'T' && ($mess = "$file is not a text file.");
88         $tmp eq 'B' && ($mess = "$file is not a binary file.");
89         if ($neg eq '!') {
90             $mess =~ s/ is not / should not be / ||
91             $mess =~ s/ does not / should not / ||
92             $mess =~ s/ not / /;
93         }
94         print STDERR $mess,"\n";
95     }
96     else {
97         $this =~ s/\$file/'$file'/g;
98         print STDERR "Can't do $this.\n";
99     }
100     if ($disposition eq 'die') { exit 1; }
101     ++$warnings;
102 }
103
104 1;