Add the capability to include/exclude branches.
[p5sagit/p5-mst-13.2.git] / Porting / genlog
1 #!/l/local/bin/perl -w
2 #
3 # Generate a nice changelist by querying perforce.
4 #
5 # Each change is described with the change number, description,
6 # which branch the change happened in, files modified,
7 # and who was responsible for entering the change.
8 #
9 # Can be called with a list of change numbers or a range of the
10 # form "12..42".  Changelog will be printed from highest number
11 # to lowest.
12 #
13 # Outputs the changelist to stdout.
14 #
15 # Gurusamy Sarathy <gsar@activestate.com>
16 #
17
18 use Text::Wrap;
19
20 $0 =~ s|^.*/||;
21 unless (@ARGV) {
22     die <<USAGE;
23         $0 [-p \$P4PORT] [-bi branch_include] [-be branch_exclude] <change numbers or from..to>
24 USAGE
25 }
26
27 my @changes;
28
29 my %editkind;
30 @editkind{ qw(   add      edit    delete integrate   branch )}
31          = qw(     +         !         -        !>       +> );
32
33 my $p4port = $ENV{P4PORT} || 'localhost:1666';
34
35 my @branch_include;
36 my @branch_exclude;
37 my %branch_include;
38 my %branch_exclude;
39
40 while (@ARGV) {
41     $_ = shift;
42     if (/^(\d+)\.\.(\d+)$/) {
43         push @changes, $1 .. $2;
44     }
45     elsif (/^\d+$/) {
46         push @changes, $_;
47     }
48     elsif (/^-p(.*)$/) {
49         $p4port = $1 || shift;
50     }
51     elsif (/^-bi(.*)$/) {
52         push @branch_include, $1 || shift;
53     }
54     elsif (/^-be(.*)$/) {
55         push @branch_exclude, $1 || shift;
56     }
57     else {
58         warn "Arguments must be change numbers, ignoring `$_'\n";
59     }
60 }
61
62 @changes = sort { $b <=> $a } @changes;
63
64 @branch_include{@branch_include} = @branch_include if @branch_include;
65 @branch_exclude{@branch_exclude} = @branch_exclude if @branch_exclude;
66
67 my @desc = `p4 -p $p4port describe -s @changes`;
68 if ($?) {
69     die "$0: `p4 -p $p4port describe -s @changes` failed, status[$?]\n";
70 }
71 else {
72     chomp @desc;
73     while (@desc) {
74         my ($change,$who,$date,$time,@log,$branch,$file,$type,%files);
75         my $skip = 0;
76         $_ = shift @desc;
77         if (/^Change (\d+) by (\w+)\@.+ on (\S+) (\S+)\s*$/) {
78             ($change, $who, $date, $time) = ($1,$2,$3,$4);
79             $_ = shift @desc;  # get rid of empty line
80             while (@desc) {
81                 $_ = shift @desc;
82                 last if /^Affected/;
83                 push @log, $_;    
84             }
85             if (/^Affected/) {
86                 $_ = shift @desc;  # get rid of empty line
87                 while ($_ = shift @desc) {
88                     last unless /^\.\.\./;
89                     if (m{^\.\.\. //depot/(.*?perl|[^/]*)/([^#]+)#\d+ (\w+)\s*$}) {
90                         ($branch,$file,$type) = ($1,$2,$3);
91                         if (exists $branch_exclude{$branch} or
92                             @branch_include and
93                             not exists $branch_include{$branch}) {
94                             $skip++;
95                         }
96                         $files{$branch} = {} unless exists $files{$branch};
97                         $files{$branch}{$type} = [] unless exists $files{$branch}{$type};
98                         push @{$files{$branch}{$type}}, $file;
99                     }
100                     else {
101                         warn "Unknown line [$_], ignoring\n";
102                     }
103                 }
104             }
105         }
106         next if not $change or $skip;
107         print "_" x 76, "\n";
108         printf <<EOT, $change, $who, $date, $time;
109 [%6s] By: %-25s             on %9s %9s
110 EOT
111         print "        Log: ";
112         my $i = 0;
113         while (@log) {
114             $_ = shift @log;
115             s/^\s*//;
116             s/^\[.*\]\s*// unless $i ;
117             # don't print last empty line
118             if ($_ or @log) {
119                 print "             " if $i++;
120                 print "$_\n";
121             }
122         }
123         for my $branch (sort keys %files) {
124             printf "%11s: $branch\n", 'Branch';
125             for my $kind (sort keys %{$files{$branch}}) {
126                 warn("### $kind ###\n"), next unless exists $editkind{$kind};
127                 my $files = $files{$branch}{$kind};
128                 # don't show large branches and integrations
129                 $files = ["($kind " . scalar(@$files) . ' files)']
130                     if (@$files > 25 && ($kind eq 'integrate'
131                                          || $kind eq 'branch'))
132                        || @$files > 100;
133                 print wrap(sprintf("%12s ", $editkind{$kind}),
134                            sprintf("%12s ", $editkind{$kind}),
135                            "@$files\n");
136             }
137         }
138     }
139 }