Merge branch 'sg/index-format-doc-update' into maint
[git/debian.git] / git-cvsexportcommit.perl
blob289d4bc684dc26256f497636ca5c080fc6589226
1 #!/usr/bin/perl
3 use 5.008;
4 use strict;
5 use warnings;
6 use Getopt::Std;
7 use File::Temp qw(tempdir);
8 use Data::Dumper;
9 use File::Basename qw(basename dirname);
10 use File::Spec;
11 use Git;
13 our ($opt_h, $opt_P, $opt_p, $opt_v, $opt_c, $opt_f, $opt_a, $opt_m, $opt_d, $opt_u, $opt_w, $opt_W, $opt_k);
15 getopts('uhPpvcfkam:d:w:W');
17 $opt_h && usage();
19 die "Need at least one commit identifier!" unless @ARGV;
21 # Get git-config settings
22 my $repo = Git->repository();
23 $opt_w = $repo->config('cvsexportcommit.cvsdir') unless defined $opt_w;
25 my $tmpdir = File::Temp::tempdir(CLEANUP => 1);
26 my $hash_algo = $repo->config('extensions.objectformat') || 'sha1';
27 my $hexsz = $hash_algo eq 'sha256' ? 64 : 40;
29 if ($opt_w || $opt_W) {
30 # Remember where GIT_DIR is before changing to CVS checkout
31 unless ($ENV{GIT_DIR}) {
32 # No GIT_DIR set. Figure it out for ourselves
33 my $gd =`git rev-parse --git-dir`;
34 chomp($gd);
35 $ENV{GIT_DIR} = $gd;
38 # On MSYS, convert a Windows-style path to an MSYS-style path
39 # so that rel2abs() below works correctly.
40 if ($^O eq 'msys') {
41 $ENV{GIT_DIR} =~ s#^([[:alpha:]]):/#/$1/#;
44 # Make sure GIT_DIR is absolute
45 $ENV{GIT_DIR} = File::Spec->rel2abs($ENV{GIT_DIR});
48 if ($opt_w) {
49 if (! -d $opt_w."/CVS" ) {
50 die "$opt_w is not a CVS checkout";
52 chdir $opt_w or die "Cannot change to CVS checkout at $opt_w";
54 unless ($ENV{GIT_DIR} && -r $ENV{GIT_DIR}){
55 die "GIT_DIR is not defined or is unreadable";
59 my @cvs;
60 if ($opt_d) {
61 @cvs = ('cvs', '-d', $opt_d);
62 } else {
63 @cvs = ('cvs');
66 # resolve target commit
67 my $commit;
68 $commit = pop @ARGV;
69 $commit = safe_pipe_capture('git', 'rev-parse', '--verify', "$commit^0");
70 chomp $commit;
71 if ($?) {
72 die "The commit reference $commit did not resolve!";
75 # resolve what parent we want
76 my $parent;
77 if (@ARGV) {
78 $parent = pop @ARGV;
79 $parent = safe_pipe_capture('git', 'rev-parse', '--verify', "$parent^0");
80 chomp $parent;
81 if ($?) {
82 die "The parent reference did not resolve!";
86 # find parents from the commit itself
87 my @commit = safe_pipe_capture('git', 'cat-file', 'commit', $commit);
88 my @parents;
89 my $committer;
90 my $author;
91 my $stage = 'headers'; # headers, msg
92 my $title;
93 my $msg = '';
95 foreach my $line (@commit) {
96 chomp $line;
97 if ($stage eq 'headers' && $line eq '') {
98 $stage = 'msg';
99 next;
102 if ($stage eq 'headers') {
103 if ($line =~ m/^parent ([0-9a-f]{$hexsz})$/) { # found a parent
104 push @parents, $1;
105 } elsif ($line =~ m/^author (.+) \d+ [-+]\d+$/) {
106 $author = $1;
107 } elsif ($line =~ m/^committer (.+) \d+ [-+]\d+$/) {
108 $committer = $1;
110 } else {
111 $msg .= $line . "\n";
112 unless ($title) {
113 $title = $line;
118 my $noparent = "0" x $hexsz;
119 if ($parent) {
120 my $found;
121 # double check that it's a valid parent
122 foreach my $p (@parents) {
123 if ($p eq $parent) {
124 $found = 1;
125 last;
126 }; # found it
128 die "Did not find $parent in the parents for this commit!" if !$found and !$opt_P;
129 } else { # we don't have a parent from the cmdline...
130 if (@parents == 1) { # it's safe to get it from the commit
131 $parent = $parents[0];
132 } elsif (@parents == 0) { # there is no parent
133 $parent = $noparent;
134 } else { # cannot choose automatically from multiple parents
135 die "This commit has more than one parent -- please name the parent you want to use explicitly";
139 my $go_back_to = 0;
141 if ($opt_W) {
142 $opt_v && print "Resetting to $parent\n";
143 $go_back_to = `git symbolic-ref HEAD 2> /dev/null ||
144 git rev-parse HEAD` || die "Could not determine current branch";
145 system("git checkout -q $parent^0") && die "Could not check out $parent^0";
148 $opt_v && print "Applying to CVS commit $commit from parent $parent\n";
150 # grab the commit message
151 open(MSG, ">.msg") or die "Cannot open .msg for writing";
152 if ($opt_m) {
153 print MSG $opt_m;
155 print MSG $msg;
156 if ($opt_a) {
157 print MSG "\n\nAuthor: $author\n";
158 if ($author ne $committer) {
159 print MSG "Committer: $committer\n";
162 close MSG;
164 if ($parent eq $noparent) {
165 `git diff-tree --binary -p --root $commit >.cvsexportcommit.diff`;# || die "Cannot diff";
166 } else {
167 `git diff-tree --binary -p $parent $commit >.cvsexportcommit.diff`;# || die "Cannot diff";
170 ## apply non-binary changes
172 # In pedantic mode require all lines of context to match. In normal
173 # mode, be compatible with diff/patch: assume 3 lines of context and
174 # require at least one line match, i.e. ignore at most 2 lines of
175 # context, like diff/patch do by default.
176 my $context = $opt_p ? '' : '-C1';
178 print "Checking if patch will apply\n";
180 my @stat;
181 open APPLY, "GIT_INDEX_FILE=$tmpdir/index git apply $context --summary --numstat<.cvsexportcommit.diff|" || die "cannot patch";
182 @stat=<APPLY>;
183 close APPLY || die "Cannot patch";
184 my (@bfiles,@files,@afiles,@dfiles);
185 chomp @stat;
186 foreach (@stat) {
187 push (@bfiles,$1) if m/^-\t-\t(.*)$/;
188 push (@files, $1) if m/^-\t-\t(.*)$/;
189 push (@files, $1) if m/^\d+\t\d+\t(.*)$/;
190 push (@afiles,$1) if m/^ create mode [0-7]+ (.*)$/;
191 push (@dfiles,$1) if m/^ delete mode [0-7]+ (.*)$/;
193 map { s/^"(.*)"$/$1/g } @bfiles,@files;
194 map { s/\\([0-7]{3})/sprintf('%c',oct $1)/eg } @bfiles,@files;
196 # check that the files are clean and up to date according to cvs
197 my $dirty;
198 my @dirs;
199 foreach my $p (@afiles) {
200 my $path = dirname $p;
201 while (!-d $path and ! grep { $_ eq $path } @dirs) {
202 unshift @dirs, $path;
203 $path = dirname $path;
207 # ... check dirs,
208 foreach my $d (@dirs) {
209 if (-e $d) {
210 $dirty = 1;
211 warn "$d exists and is not a directory!\n";
215 # ... query status of all files that we have a directory for and parse output of 'cvs status' to %cvsstat.
216 my @canstatusfiles;
217 foreach my $f (@files) {
218 my $path = dirname $f;
219 next if (grep { $_ eq $path } @dirs);
220 push @canstatusfiles, $f;
223 my %cvsstat;
224 if (@canstatusfiles) {
225 if ($opt_u) {
226 my @updated = xargs_safe_pipe_capture([@cvs, 'update'], @canstatusfiles);
227 print @updated;
229 # "cvs status" reorders the parameters, notably when there are multiple
230 # arguments with the same basename. So be precise here.
232 my %added = map { $_ => 1 } @afiles;
233 my %todo = map { $_ => 1 } @canstatusfiles;
235 while (%todo) {
236 my @canstatusfiles2 = ();
237 my %fullname = ();
238 foreach my $name (keys %todo) {
239 my $basename = basename($name);
241 # CVS reports files that don't exist in the current revision as
242 # "no file $basename" in its "status" output, so we should
243 # anticipate that. Totally unknown files will have a status
244 # "Unknown". However, if they exist in the Attic, their status
245 # will be "Up-to-date" (this means they were added once but have
246 # been removed).
247 $basename = "no file $basename" if $added{$basename};
249 $basename =~ s/^\s+//;
250 $basename =~ s/\s+$//;
252 if (!exists($fullname{$basename})) {
253 $fullname{$basename} = $name;
254 push (@canstatusfiles2, $name);
255 delete($todo{$name});
258 my @cvsoutput;
259 @cvsoutput = xargs_safe_pipe_capture([@cvs, 'status'], @canstatusfiles2);
260 foreach my $l (@cvsoutput) {
261 chomp $l;
262 next unless
263 my ($file, $status) = $l =~ /^File:\s+(.*\S)\s+Status: (.*)$/;
265 my $fullname = $fullname{$file};
266 print STDERR "Huh? Status '$status' reported for unexpected file '$file'\n"
267 unless defined $fullname;
269 # This response means the file does not exist except in
270 # CVS's attic, so set the status accordingly
271 $status = "In-attic"
272 if $file =~ /^no file /
273 && $status eq 'Up-to-date';
275 $cvsstat{$fullname{$file}} = $status
276 if defined $fullname{$file};
281 # ... Validate that new files have the correct status
282 foreach my $f (@afiles) {
283 next unless defined(my $stat = $cvsstat{$f});
285 # This means the file has never been seen before
286 next if $stat eq 'Unknown';
288 # This means the file has been seen before but was removed
289 next if $stat eq 'In-attic';
291 $dirty = 1;
292 warn "File $f is already known in your CVS checkout -- perhaps it has been added by another user. Or this may indicate that it exists on a different branch. If this is the case, use -f to force the merge.\n";
293 warn "Status was: $cvsstat{$f}\n";
296 # ... validate known files.
297 foreach my $f (@files) {
298 next if grep { $_ eq $f } @afiles;
299 # TODO:we need to handle removed in cvs
300 unless (defined ($cvsstat{$f}) and $cvsstat{$f} eq "Up-to-date") {
301 $dirty = 1;
302 warn "File $f not up to date but has status '$cvsstat{$f}' in your CVS checkout!\n";
305 # Depending on how your GIT tree got imported from CVS you may
306 # have a conflict between expanded keywords in your CVS tree and
307 # unexpanded keywords in the patch about to be applied.
308 if ($opt_k) {
309 my $orig_file ="$f.orig";
310 rename $f, $orig_file;
311 open(FILTER_IN, "<$orig_file") or die "Cannot open $orig_file\n";
312 open(FILTER_OUT, ">$f") or die "Cannot open $f\n";
313 while (<FILTER_IN>)
315 my $line = $_;
316 $line =~ s/\$([A-Z][a-z]+):[^\$]+\$/\$$1\$/g;
317 print FILTER_OUT $line;
319 close FILTER_IN;
320 close FILTER_OUT;
324 if ($dirty) {
325 if ($opt_f) { warn "The tree is not clean -- forced merge\n";
326 $dirty = 0;
327 } else {
328 die "Exiting: your CVS tree is not clean for this merge.";
332 print "Applying\n";
333 if ($opt_W) {
334 system("git checkout -q $commit^0") && die "cannot patch";
335 } else {
336 `GIT_INDEX_FILE=$tmpdir/index git apply $context --summary --numstat --apply <.cvsexportcommit.diff` || die "cannot patch";
339 print "Patch applied successfully. Adding new files and directories to CVS\n";
340 my $dirtypatch = 0;
343 # We have to add the directories in order otherwise we will have
344 # problems when we try and add the sub-directory of a directory we
345 # have not added yet.
347 # Luckily this is easy to deal with by sorting the directories and
348 # dealing with the shortest ones first.
350 @dirs = sort { length $a <=> length $b} @dirs;
352 foreach my $d (@dirs) {
353 if (system(@cvs,'add',$d)) {
354 $dirtypatch = 1;
355 warn "Failed to cvs add directory $d -- you may need to do it manually";
359 foreach my $f (@afiles) {
360 if (grep { $_ eq $f } @bfiles) {
361 system(@cvs, 'add','-kb',$f);
362 } else {
363 system(@cvs, 'add', $f);
365 if ($?) {
366 $dirtypatch = 1;
367 warn "Failed to cvs add $f -- you may need to do it manually";
371 foreach my $f (@dfiles) {
372 system(@cvs, 'rm', '-f', $f);
373 if ($?) {
374 $dirtypatch = 1;
375 warn "Failed to cvs rm -f $f -- you may need to do it manually";
379 print "Commit to CVS\n";
380 print "Patch title (first comment line): $title\n";
381 my @commitfiles = map { unless (m/\s/) { '\''.$_.'\''; } else { $_; }; } (@files);
382 my $cmd = join(' ', @cvs)." commit -F .msg @commitfiles";
384 if ($dirtypatch) {
385 print "NOTE: One or more hunks failed to apply cleanly.\n";
386 print "You'll need to apply the patch in .cvsexportcommit.diff manually\n";
387 print "using a patch program. After applying the patch and resolving the\n";
388 print "problems you may commit using:";
389 print "\n cd \"$opt_w\"" if $opt_w;
390 print "\n $cmd\n";
391 print "\n git checkout $go_back_to\n" if $go_back_to;
392 print "\n";
393 exit(1);
396 if ($opt_c) {
397 print "Autocommit\n $cmd\n";
398 print xargs_safe_pipe_capture([@cvs, 'commit', '-F', '.msg'], @files);
399 if ($?) {
400 die "Exiting: The commit did not succeed";
402 print "Committed successfully to CVS\n";
403 # clean up
404 unlink(".msg");
405 } else {
406 print "Ready for you to commit, just run:\n\n $cmd\n";
409 # clean up
410 unlink(".cvsexportcommit.diff");
412 if ($opt_W) {
413 system("git checkout $go_back_to") && die "cannot move back to $go_back_to";
414 if (!($go_back_to =~ /^[0-9a-fA-F]{$hexsz}$/)) {
415 system("git symbolic-ref HEAD $go_back_to") &&
416 die "cannot move back to $go_back_to";
420 # CVS version 1.11.x and 1.12.x sleeps the wrong way to ensure the timestamp
421 # used by CVS and the one set by subsequence file modifications are different.
422 # If they are not different CVS will not detect changes.
423 sleep(1);
425 sub usage {
426 print STDERR <<END;
427 usage: GIT_DIR=/path/to/.git git cvsexportcommit [-h] [-p] [-v] [-c] [-f] [-u] [-k] [-w cvsworkdir] [-m msgprefix] [ parent ] commit
429 exit(1);
432 # An alternative to `command` that allows input to be passed as an array
433 # to work around shell problems with weird characters in arguments
434 # if the exec returns non-zero we die
435 sub safe_pipe_capture {
436 my @output;
437 if (my $pid = open my $child, '-|') {
438 binmode($child, ":crlf");
439 @output = (<$child>);
440 close $child or die join(' ',@_).": $! $?";
441 } else {
442 exec(@_) or die "$! $?"; # exec() can fail the executable can't be found
444 return wantarray ? @output : join('',@output);
447 sub xargs_safe_pipe_capture {
448 my $MAX_ARG_LENGTH = 65536;
449 my $cmd = shift;
450 my @output;
451 my $output;
452 while(@_) {
453 my @args;
454 my $length = 0;
455 while(@_ && $length < $MAX_ARG_LENGTH) {
456 push @args, shift;
457 $length += length($args[$#args]);
459 if (wantarray) {
460 push @output, safe_pipe_capture(@$cmd, @args);
462 else {
463 $output .= safe_pipe_capture(@$cmd, @args);
466 return wantarray ? @output : $output;