2 # Maintainers.pm - show information about maintainers
11 require "Maintainers.pl";
12 use vars qw(%Modules %Maintainers);
14 use vars qw(@ISA @EXPORT_OK);
16 @EXPORT_OK = qw(%Modules %Maintainers
17 get_module_files get_module_pat
18 show_results process_options);
25 if (open(MANIFEST, "MANIFEST")) {
27 if (/^(\S+)\t+(.+)$/) {
33 die "$0: Failed to open MANIFEST for reading: $!\n";
38 split ' ', $Modules{$m}{FILES};
41 sub get_module_files {
43 sort { lc $a cmp lc $b }
45 -f $_ ? # Files as-is.
47 -d _ ? # Recurse into directories.
52 push @files, $File::Find::name
53 if -f $_ && exists $MANIFEST{$File::Find::name};
57 : glob($_) # The rest are globbable patterns.
61 sub get_maintainer_modules {
63 sort { lc $a cmp lc $b }
64 grep { $Modules{$_}{MAINTAINER} eq $m }
70 $0: Usage: $0 [[--maintainer M --module M --files]|[--check] file ...]
71 --maintainer M list all maintainers matching M
72 --module M list all modules matching M
73 --files list all files
74 --check check consistency of Maintainers.pl
75 with a file checks if it has a maintainer
76 with a dir checks all files have a maintainer
77 otherwise checks for multiple maintainers
78 --opened list all modules of files opened by perforce
79 Matching is case-ignoring regexp, author matching is both by
80 the short id and by the full name and email. A "module" may
81 not be just a module, it may be a file or files or a subdirectory.
82 The options may be abbreviated to their unique prefixes
97 'maintainer=s' => \$Maintainer,
98 'module=s' => \$Module,
101 'opened' => \$Opened,
107 my @raw = `p4 opened`;
109 @Files = map {s!#.*!!s; s!^//depot/.*?/perl/!!; $_} @raw;
114 usage() if @Files && ($Maintainer || $Module || $Files);
116 for my $mean ($Maintainer, $Module) {
117 warn "$0: Did you mean '$0 $mean'?\n"
118 if $mean && -e $mean && $mean ne '.' && !$Files;
121 warn "$0: Did you mean '$0 -mo $Maintainer'?\n"
122 if defined $Maintainer && exists $Modules{$Maintainer};
124 warn "$0: Did you mean '$0 -ma $Module'?\n"
125 if defined $Module && exists $Maintainers{$Module};
127 return ($Maintainer, $Module, $Files, @Files);
131 my ($Maintainer, $Module, $Files, @Files) = @_;
134 for my $m (sort keys %Maintainers) {
135 if ($m =~ /$Maintainer/io || $Maintainers{$m} =~ /$Maintainer/io) {
136 my @modules = get_maintainer_modules($m);
138 @modules = grep { /$Module/io } @modules;
142 for my $module (@modules) {
143 push @files, get_module_files($module);
145 printf "%-15s @files\n", $m;
148 printf "%-15s @modules\n", $m;
150 printf "%-15s $Maintainers{$m}\n", $m;
156 for my $m (sort { lc $a cmp lc $b } keys %Modules) {
157 if ($m =~ /$Module/io) {
159 my @files = get_module_files($m);
160 printf "%-15s @files\n", $m;
162 printf "%-15s $Modules{$m}{MAINTAINER}\n", $m;
168 missing_maintainers( qr{\.(?:[chty]|p[lm]|xs)\z}msx, @Files)
171 duplicated_maintainers();
176 for (@Files) { s:^\./:: }
178 @ModuleByFile{@Files} = ();
180 # First try fast match.
183 for my $module (keys %Modules) {
184 for my $pat (get_module_pat($module)) {
185 $ModuleByPat{$pat} = $module;
190 for my $pat (keys %ModuleByPat) {
192 $ExpModuleByPat{$pat} = $ModuleByPat{$pat};
194 for my $exp (glob($pat)) {
195 $ExpModuleByPat{$exp} = $ModuleByPat{$pat};
199 %ModuleByPat = %ExpModuleByPat;
200 for my $file (@Files) {
201 $ModuleByFile{$file} = $ModuleByPat{$file}
202 if exists $ModuleByPat{$file};
205 # If still unresolved files...
206 if (my @ToDo = grep { !defined $ModuleByFile{$_} } keys %ModuleByFile) {
208 # Cannot match what isn't there.
209 @ToDo = grep { -e $_ } @ToDo;
212 # Try prefix matching.
214 # Remove trailing slashes.
215 for (@ToDo) { s|/$|| }
220 for my $pat (keys %ModuleByPat) {
221 last unless keys %ToDo;
224 for my $file (keys %ToDo) {
225 if ($file =~ m|^$pat|i) {
226 $ModuleByFile{$file} = $ModuleByPat{$pat};
236 for my $file (@Files) {
237 if (defined $ModuleByFile{$file}) {
238 my $module = $ModuleByFile{$file};
239 my $maintainer = $Modules{$ModuleByFile{$file}}{MAINTAINER};
240 printf "%-15s $module $maintainer $Maintainers{$maintainer}\n", $file;
242 printf "%-15s ?\n", $file;
251 sub warn_maintainer(_);
254 sub maintainers_files {
256 for my $k (keys %Modules) {
257 for my $f (get_module_files($k)) {
263 sub duplicated_maintainers {
265 for my $f (keys %files) {
266 if ($files{$f} > 1) {
267 warn "File $f appears $files{$f} times in Maintainers.pl\n";
272 sub missing_maintainers {
273 my($check, @path) = @_;
276 for (@path) { if( -d ) { push @dir, $_ } else { warn_maintainer() } }
277 find sub { warn_maintainer($File::Find::name) if /$check/; }, @dir
281 sub warn_maintainer(_) {
283 warn "File $name has no maintainer\n" if not $files{$name};