git-rewrite-author

#!/usr/bin/env perl
# Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
# Contact: http://www.qt-project.org/legal
#
# You may use this file under the terms of the 3-clause BSD license.
# See the file LICENSE from this package for details.
#

use strict;
use warnings;

use Getopt::Long;

sub usage {
    print STDERR
q{Usage: git rewrite-author --from <from> --to <to> [ -f | --force ]
    [--] [<rev-list options>...]

  Replace author and committer field in some commits.


EXAMPLE:

  You've accidentally made some commits like this:

    Author: bjones <bjones@localhost.localdomain>

  ... where it should have been:

    Author: Bob Jones <bob.jones@example.com>

  The first bad commit is a1b2c3d4...

  Fix it up by:

   $ git rewrite-author --from "bjones <bjones@localhost.localdomain>" \
      --to "Bob Jones <bob.jones@example.com>" a1b2c3d4^..HEAD

  If you omit a range of commits, this command will scan _all_ commits
  leading up to HEAD, which will take a long time for repositories with
  a large history.

  WARNING: this script will change the SHA1 of every commit including
  and following the first rewritten commit. You can't do this for commits
  you've already pushed unless you really know what you're doing!
};
}

sub parse_author
{
    my $author = shift;
    if ($author =~ /^(.*?) <([^>]+)>$/) {
        return ($1, $2);
    }
    else {
        die "Could not parse `$author'; expected something like \"Some Name <some.address\@example.com>\"";
    }
}


# Return a string single-quoted for use in shell
sub sh_squote
{
    my $out = shift;
    $out =~ s/'/'"'"'/g;
    return "'$out'";
}

# Return fragment of shell code to rewrite a specific env var
sub rewrite_env