0266878120c452cac405c3b269797d172733ee6b
   1#!/usr/bin/perl
   2# Copyright (C) 2006, Eric Wong <normalperson@yhbt.net>
   3# License: GPL v2 or later
   4use 5.008;
   5use warnings;
   6use strict;
   7use vars qw/    $AUTHOR $VERSION
   8                $sha1 $sha1_short $_revision $_repository
   9                $_q $_authors $_authors_prog %users/;
  10$AUTHOR = 'Eric Wong <normalperson@yhbt.net>';
  11$VERSION = '@@GIT_VERSION@@';
  12
  13use Git::SVN;
  14use Git::SVN::Log;
  15use Git::SVN::Utils qw(fatal can_compress);
  16
  17use Git qw(
  18        git_cmd_try
  19        command
  20        command_oneline
  21        command_noisy
  22        command_output_pipe
  23        command_close_pipe
  24        command_bidi_pipe
  25        command_close_bidi_pipe
  26);
  27
  28
  29# From which subdir have we been invoked?
  30my $cmd_dir_prefix = eval {
  31        command_oneline([qw/rev-parse --show-prefix/], STDERR => 0)
  32} || '';
  33
  34my $git_dir_user_set = 1 if defined $ENV{GIT_DIR};
  35$ENV{GIT_DIR} ||= '.git';
  36$Git::SVN::Ra::_log_window_size = 100;
  37
  38if (! exists $ENV{SVN_SSH} && exists $ENV{GIT_SSH}) {
  39        $ENV{SVN_SSH} = $ENV{GIT_SSH};
  40}
  41
  42if (exists $ENV{SVN_SSH} && $^O eq 'msys') {
  43        $ENV{SVN_SSH} =~ s/\\/\\\\/g;
  44        $ENV{SVN_SSH} =~ s/(.*)/"$1"/;
  45}
  46
  47$Git::SVN::Log::TZ = $ENV{TZ};
  48$ENV{TZ} = 'UTC';
  49$| = 1; # unbuffer STDOUT
  50
  51# All SVN commands do it.  Otherwise we may die on SIGPIPE when the remote
  52# repository decides to close the connection which we expect to be kept alive.
  53$SIG{PIPE} = 'IGNORE';
  54
  55# Given a dot separated version number, "subtract" it from
  56# the SVN::Core::VERSION; non-negaitive return means the SVN::Core
  57# is at least at the version the caller asked for.
  58sub compare_svn_version {
  59        my (@ours) = split(/\./, $SVN::Core::VERSION);
  60        my (@theirs) = split(/\./, $_[0]);
  61        my ($i, $diff);
  62
  63        for ($i = 0; $i < @ours && $i < @theirs; $i++) {
  64                $diff = $ours[$i] - $theirs[$i];
  65                return $diff if ($diff);
  66        }
  67        return 1 if ($i < @ours);
  68        return -1 if ($i < @theirs);
  69        return 0;
  70}
  71
  72sub _req_svn {
  73        require SVN::Core; # use()-ing this causes segfaults for me... *shrug*
  74        require SVN::Ra;
  75        require SVN::Delta;
  76        if (::compare_svn_version('1.1.0') < 0) {
  77                fatal "Need SVN::Core 1.1.0 or better (got $SVN::Core::VERSION)";
  78        }
  79}
  80
  81use Carp qw/croak/;
  82use Digest::MD5;
  83use IO::File qw//;
  84use File::Basename qw/dirname basename/;
  85use File::Path qw/mkpath/;
  86use File::Spec;
  87use File::Find;
  88use Getopt::Long qw/:config gnu_getopt no_ignore_case auto_abbrev/;
  89use IPC::Open3;
  90use Git::SVN::Editor qw//;
  91use Git::SVN::Fetcher qw//;
  92use Git::SVN::Ra qw//;
  93use Git::SVN::Prompt qw//;
  94use Memoize;  # core since 5.8.0, Jul 2002
  95
  96BEGIN {
  97        Memoize::memoize 'Git::config';
  98        Memoize::memoize 'Git::config_bool';
  99}
 100
 101my ($SVN);
 102
 103$sha1 = qr/[a-f\d]{40}/;
 104$sha1_short = qr/[a-f\d]{4,40}/;
 105my ($_stdin, $_help, $_edit,
 106        $_message, $_file, $_branch_dest,
 107        $_template, $_shared,
 108        $_version, $_fetch_all, $_no_rebase, $_fetch_parent,
 109        $_merge, $_strategy, $_preserve_merges, $_dry_run, $_local,
 110        $_prefix, $_no_checkout, $_url, $_verbose,
 111        $_commit_url, $_tag, $_merge_info, $_interactive);
 112
 113# This is a refactoring artifact so Git::SVN can get at this git-svn switch.
 114sub opt_prefix { return $_prefix || '' }
 115
 116$Git::SVN::Fetcher::_placeholder_filename = ".gitignore";
 117$_q ||= 0;
 118my %remote_opts = ( 'username=s' => \$Git::SVN::Prompt::_username,
 119                    'config-dir=s' => \$Git::SVN::Ra::config_dir,
 120                    'no-auth-cache' => \$Git::SVN::Prompt::_no_auth_cache,
 121                    'ignore-paths=s' => \$Git::SVN::Fetcher::_ignore_regex,
 122                    'ignore-refs=s' => \$Git::SVN::Ra::_ignore_refs_regex );
 123my %fc_opts = ( 'follow-parent|follow!' => \$Git::SVN::_follow_parent,
 124                'authors-file|A=s' => \$_authors,
 125                'authors-prog=s' => \$_authors_prog,
 126                'repack:i' => \$Git::SVN::_repack,
 127                'noMetadata' => \$Git::SVN::_no_metadata,
 128                'useSvmProps' => \$Git::SVN::_use_svm_props,
 129                'useSvnsyncProps' => \$Git::SVN::_use_svnsync_props,
 130                'log-window-size=i' => \$Git::SVN::Ra::_log_window_size,
 131                'no-checkout' => \$_no_checkout,
 132                'quiet|q+' => \$_q,
 133                'repack-flags|repack-args|repack-opts=s' =>
 134                   \$Git::SVN::_repack_flags,
 135                'use-log-author' => \$Git::SVN::_use_log_author,
 136                'add-author-from' => \$Git::SVN::_add_author_from,
 137                'localtime' => \$Git::SVN::_localtime,
 138                %remote_opts );
 139
 140my ($_trunk, @_tags, @_branches, $_stdlayout);
 141my %icv;
 142my %init_opts = ( 'template=s' => \$_template, 'shared:s' => \$_shared,
 143                  'trunk|T=s' => \$_trunk, 'tags|t=s@' => \@_tags,
 144                  'branches|b=s@' => \@_branches, 'prefix=s' => \$_prefix,
 145                  'stdlayout|s' => \$_stdlayout,
 146                  'minimize-url|m!' => \$Git::SVN::_minimize_url,
 147                  'no-metadata' => sub { $icv{noMetadata} = 1 },
 148                  'use-svm-props' => sub { $icv{useSvmProps} = 1 },
 149                  'use-svnsync-props' => sub { $icv{useSvnsyncProps} = 1 },
 150                  'rewrite-root=s' => sub { $icv{rewriteRoot} = $_[1] },
 151                  'rewrite-uuid=s' => sub { $icv{rewriteUUID} = $_[1] },
 152                  %remote_opts );
 153my %cmt_opts = ( 'edit|e' => \$_edit,
 154                'rmdir' => \$Git::SVN::Editor::_rmdir,
 155                'find-copies-harder' => \$Git::SVN::Editor::_find_copies_harder,
 156                'l=i' => \$Git::SVN::Editor::_rename_limit,
 157                'copy-similarity|C=i'=> \$Git::SVN::Editor::_cp_similarity
 158);
 159
 160my %cmd = (
 161        fetch => [ \&cmd_fetch, "Download new revisions from SVN",
 162                        { 'revision|r=s' => \$_revision,
 163                          'fetch-all|all' => \$_fetch_all,
 164                          'parent|p' => \$_fetch_parent,
 165                           %fc_opts } ],
 166        clone => [ \&cmd_clone, "Initialize and fetch revisions",
 167                        { 'revision|r=s' => \$_revision,
 168                          'preserve-empty-dirs' =>
 169                                \$Git::SVN::Fetcher::_preserve_empty_dirs,
 170                          'placeholder-filename=s' =>
 171                                \$Git::SVN::Fetcher::_placeholder_filename,
 172                           %fc_opts, %init_opts } ],
 173        init => [ \&cmd_init, "Initialize a repo for tracking" .
 174                          " (requires URL argument)",
 175                          \%init_opts ],
 176        'multi-init' => [ \&cmd_multi_init,
 177                          "Deprecated alias for ".
 178                          "'$0 init -T<trunk> -b<branches> -t<tags>'",
 179                          \%init_opts ],
 180        dcommit => [ \&cmd_dcommit,
 181                     'Commit several diffs to merge with upstream',
 182                        { 'merge|m|M' => \$_merge,
 183                          'strategy|s=s' => \$_strategy,
 184                          'verbose|v' => \$_verbose,
 185                          'dry-run|n' => \$_dry_run,
 186                          'fetch-all|all' => \$_fetch_all,
 187                          'commit-url=s' => \$_commit_url,
 188                          'revision|r=i' => \$_revision,
 189                          'no-rebase' => \$_no_rebase,
 190                          'mergeinfo=s' => \$_merge_info,
 191                          'interactive|i' => \$_interactive,
 192                        %cmt_opts, %fc_opts } ],
 193        branch => [ \&cmd_branch,
 194                    'Create a branch in the SVN repository',
 195                    { 'message|m=s' => \$_message,
 196                      'destination|d=s' => \$_branch_dest,
 197                      'dry-run|n' => \$_dry_run,
 198                      'tag|t' => \$_tag,
 199                      'username=s' => \$Git::SVN::Prompt::_username,
 200                      'commit-url=s' => \$_commit_url } ],
 201        tag => [ sub { $_tag = 1; cmd_branch(@_) },
 202                 'Create a tag in the SVN repository',
 203                 { 'message|m=s' => \$_message,
 204                   'destination|d=s' => \$_branch_dest,
 205                   'dry-run|n' => \$_dry_run,
 206                   'username=s' => \$Git::SVN::Prompt::_username,
 207                   'commit-url=s' => \$_commit_url } ],
 208        'set-tree' => [ \&cmd_set_tree,
 209                        "Set an SVN repository to a git tree-ish",
 210                        { 'stdin' => \$_stdin, %cmt_opts, %fc_opts, } ],
 211        'create-ignore' => [ \&cmd_create_ignore,
 212                             'Create a .gitignore per svn:ignore',
 213                             { 'revision|r=i' => \$_revision
 214                             } ],
 215        'mkdirs' => [ \&cmd_mkdirs ,
 216                      "recreate empty directories after a checkout",
 217                      { 'revision|r=i' => \$_revision } ],
 218        'propget' => [ \&cmd_propget,
 219                       'Print the value of a property on a file or directory',
 220                       { 'revision|r=i' => \$_revision } ],
 221        'proplist' => [ \&cmd_proplist,
 222                       'List all properties of a file or directory',
 223                       { 'revision|r=i' => \$_revision } ],
 224        'show-ignore' => [ \&cmd_show_ignore, "Show svn:ignore listings",
 225                        { 'revision|r=i' => \$_revision
 226                        } ],
 227        'show-externals' => [ \&cmd_show_externals, "Show svn:externals listings",
 228                        { 'revision|r=i' => \$_revision
 229                        } ],
 230        'multi-fetch' => [ \&cmd_multi_fetch,
 231                           "Deprecated alias for $0 fetch --all",
 232                           { 'revision|r=s' => \$_revision, %fc_opts } ],
 233        'migrate' => [ sub { },
 234                       # no-op, we automatically run this anyways,
 235                       'Migrate configuration/metadata/layout from
 236                        previous versions of git-svn',
 237                       { 'minimize' => \$Git::SVN::Migration::_minimize,
 238                         %remote_opts } ],
 239        'log' => [ \&Git::SVN::Log::cmd_show_log, 'Show commit logs',
 240                        { 'limit=i' => \$Git::SVN::Log::limit,
 241                          'revision|r=s' => \$_revision,
 242                          'verbose|v' => \$Git::SVN::Log::verbose,
 243                          'incremental' => \$Git::SVN::Log::incremental,
 244                          'oneline' => \$Git::SVN::Log::oneline,
 245                          'show-commit' => \$Git::SVN::Log::show_commit,
 246                          'non-recursive' => \$Git::SVN::Log::non_recursive,
 247                          'authors-file|A=s' => \$_authors,
 248                          'color' => \$Git::SVN::Log::color,
 249                          'pager=s' => \$Git::SVN::Log::pager
 250                        } ],
 251        'find-rev' => [ \&cmd_find_rev,
 252                        "Translate between SVN revision numbers and tree-ish",
 253                        {} ],
 254        'rebase' => [ \&cmd_rebase, "Fetch and rebase your working directory",
 255                        { 'merge|m|M' => \$_merge,
 256                          'verbose|v' => \$_verbose,
 257                          'strategy|s=s' => \$_strategy,
 258                          'local|l' => \$_local,
 259                          'fetch-all|all' => \$_fetch_all,
 260                          'dry-run|n' => \$_dry_run,
 261                          'preserve-merges|p' => \$_preserve_merges,
 262                          %fc_opts } ],
 263        'commit-diff' => [ \&cmd_commit_diff,
 264                           'Commit a diff between two trees',
 265                        { 'message|m=s' => \$_message,
 266                          'file|F=s' => \$_file,
 267                          'revision|r=s' => \$_revision,
 268                        %cmt_opts } ],
 269        'info' => [ \&cmd_info,
 270                    "Show info about the latest SVN revision
 271                     on the current branch",
 272                    { 'url' => \$_url, } ],
 273        'blame' => [ \&Git::SVN::Log::cmd_blame,
 274                    "Show what revision and author last modified each line of a file",
 275                    { 'git-format' => \$Git::SVN::Log::_git_format } ],
 276        'reset' => [ \&cmd_reset,
 277                     "Undo fetches back to the specified SVN revision",
 278                     { 'revision|r=s' => \$_revision,
 279                       'parent|p' => \$_fetch_parent } ],
 280        'gc' => [ \&cmd_gc,
 281                  "Compress unhandled.log files in .git/svn and remove " .
 282                  "index files in .git/svn",
 283                {} ],
 284);
 285
 286use Term::ReadLine;
 287package FakeTerm;
 288sub new {
 289        my ($class, $reason) = @_;
 290        return bless \$reason, shift;
 291}
 292sub readline {
 293        my $self = shift;
 294        die "Cannot use readline on FakeTerm: $$self";
 295}
 296package main;
 297
 298my $term = eval {
 299        $ENV{"GIT_SVN_NOTTY"}
 300                ? new Term::ReadLine 'git-svn', \*STDIN, \*STDOUT
 301                : new Term::ReadLine 'git-svn';
 302};
 303if ($@) {
 304        $term = new FakeTerm "$@: going non-interactive";
 305}
 306
 307my $cmd;
 308for (my $i = 0; $i < @ARGV; $i++) {
 309        if (defined $cmd{$ARGV[$i]}) {
 310                $cmd = $ARGV[$i];
 311                splice @ARGV, $i, 1;
 312                last;
 313        } elsif ($ARGV[$i] eq 'help') {
 314                $cmd = $ARGV[$i+1];
 315                usage(0);
 316        }
 317};
 318
 319# make sure we're always running at the top-level working directory
 320unless ($cmd && $cmd =~ /(?:clone|init|multi-init)$/) {
 321        unless (-d $ENV{GIT_DIR}) {
 322                if ($git_dir_user_set) {
 323                        die "GIT_DIR=$ENV{GIT_DIR} explicitly set, ",
 324                            "but it is not a directory\n";
 325                }
 326                my $git_dir = delete $ENV{GIT_DIR};
 327                my $cdup = undef;
 328                git_cmd_try {
 329                        $cdup = command_oneline(qw/rev-parse --show-cdup/);
 330                        $git_dir = '.' unless ($cdup);
 331                        chomp $cdup if ($cdup);
 332                        $cdup = "." unless ($cdup && length $cdup);
 333                } "Already at toplevel, but $git_dir not found\n";
 334                chdir $cdup or die "Unable to chdir up to '$cdup'\n";
 335                unless (-d $git_dir) {
 336                        die "$git_dir still not found after going to ",
 337                            "'$cdup'\n";
 338                }
 339                $ENV{GIT_DIR} = $git_dir;
 340        }
 341        $_repository = Git->repository(Repository => $ENV{GIT_DIR});
 342}
 343
 344my %opts = %{$cmd{$cmd}->[2]} if (defined $cmd);
 345
 346read_git_config(\%opts);
 347if ($cmd && ($cmd eq 'log' || $cmd eq 'blame')) {
 348        Getopt::Long::Configure('pass_through');
 349}
 350my $rv = GetOptions(%opts, 'h|H' => \$_help, 'version|V' => \$_version,
 351                    'minimize-connections' => \$Git::SVN::Migration::_minimize,
 352                    'id|i=s' => \$Git::SVN::default_ref_id,
 353                    'svn-remote|remote|R=s' => sub {
 354                       $Git::SVN::no_reuse_existing = 1;
 355                       $Git::SVN::default_repo_id = $_[1] });
 356exit 1 if (!$rv && $cmd && $cmd ne 'log');
 357
 358usage(0) if $_help;
 359version() if $_version;
 360usage(1) unless defined $cmd;
 361load_authors() if $_authors;
 362if (defined $_authors_prog) {
 363        $_authors_prog = "'" . File::Spec->rel2abs($_authors_prog) . "'";
 364}
 365
 366unless ($cmd =~ /^(?:clone|init|multi-init|commit-diff)$/) {
 367        Git::SVN::Migration::migration_check();
 368}
 369Git::SVN::init_vars();
 370eval {
 371        Git::SVN::verify_remotes_sanity();
 372        $cmd{$cmd}->[0]->(@ARGV);
 373        post_fetch_checkout();
 374};
 375fatal $@ if $@;
 376exit 0;
 377
 378####################### primary functions ######################
 379sub usage {
 380        my $exit = shift || 0;
 381        my $fd = $exit ? \*STDERR : \*STDOUT;
 382        print $fd <<"";
 383git-svn - bidirectional operations between a single Subversion tree and git
 384Usage: git svn <command> [options] [arguments]\n
 385
 386        print $fd "Available commands:\n" unless $cmd;
 387
 388        foreach (sort keys %cmd) {
 389                next if $cmd && $cmd ne $_;
 390                next if /^multi-/; # don't show deprecated commands
 391                print $fd '  ',pack('A17',$_),$cmd{$_}->[1],"\n";
 392                foreach (sort keys %{$cmd{$_}->[2]}) {
 393                        # mixed-case options are for .git/config only
 394                        next if /[A-Z]/ && /^[a-z]+$/i;
 395                        # prints out arguments as they should be passed:
 396                        my $x = s#[:=]s$## ? '<arg>' : s#[:=]i$## ? '<num>' : '';
 397                        print $fd ' ' x 21, join(', ', map { length $_ > 1 ?
 398                                                        "--$_" : "-$_" }
 399                                                split /\|/,$_)," $x\n";
 400                }
 401        }
 402        print $fd <<"";
 403\nGIT_SVN_ID may be set in the environment or via the --id/-i switch to an
 404arbitrary identifier if you're tracking multiple SVN branches/repositories in
 405one git repository and want to keep them separate.  See git-svn(1) for more
 406information.
 407
 408        exit $exit;
 409}
 410
 411sub version {
 412        ::_req_svn();
 413        print "git-svn version $VERSION (svn $SVN::Core::VERSION)\n";
 414        exit 0;
 415}
 416
 417sub ask {
 418        my ($prompt, %arg) = @_;
 419        my $valid_re = $arg{valid_re};
 420        my $default = $arg{default};
 421        my $resp;
 422        my $i = 0;
 423
 424        if ( !( defined($term->IN)
 425            && defined( fileno($term->IN) )
 426            && defined( $term->OUT )
 427            && defined( fileno($term->OUT) ) ) ){
 428                return defined($default) ? $default : undef;
 429        }
 430
 431        while ($i++ < 10) {
 432                $resp = $term->readline($prompt);
 433                if (!defined $resp) { # EOF
 434                        print "\n";
 435                        return defined $default ? $default : undef;
 436                }
 437                if ($resp eq '' and defined $default) {
 438                        return $default;
 439                }
 440                if (!defined $valid_re or $resp =~ /$valid_re/) {
 441                        return $resp;
 442                }
 443        }
 444        return undef;
 445}
 446
 447sub do_git_init_db {
 448        unless (-d $ENV{GIT_DIR}) {
 449                my @init_db = ('init');
 450                push @init_db, "--template=$_template" if defined $_template;
 451                if (defined $_shared) {
 452                        if ($_shared =~ /[a-z]/) {
 453                                push @init_db, "--shared=$_shared";
 454                        } else {
 455                                push @init_db, "--shared";
 456                        }
 457                }
 458                command_noisy(@init_db);
 459                $_repository = Git->repository(Repository => ".git");
 460        }
 461        my $set;
 462        my $pfx = "svn-remote.$Git::SVN::default_repo_id";
 463        foreach my $i (keys %icv) {
 464                die "'$set' and '$i' cannot both be set\n" if $set;
 465                next unless defined $icv{$i};
 466                command_noisy('config', "$pfx.$i", $icv{$i});
 467                $set = $i;
 468        }
 469        my $ignore_paths_regex = \$Git::SVN::Fetcher::_ignore_regex;
 470        command_noisy('config', "$pfx.ignore-paths", $$ignore_paths_regex)
 471                if defined $$ignore_paths_regex;
 472        my $ignore_refs_regex = \$Git::SVN::Ra::_ignore_refs_regex;
 473        command_noisy('config', "$pfx.ignore-refs", $$ignore_refs_regex)
 474                if defined $$ignore_refs_regex;
 475
 476        if (defined $Git::SVN::Fetcher::_preserve_empty_dirs) {
 477                my $fname = \$Git::SVN::Fetcher::_placeholder_filename;
 478                command_noisy('config', "$pfx.preserve-empty-dirs", 'true');
 479                command_noisy('config', "$pfx.placeholder-filename", $$fname);
 480        }
 481}
 482
 483sub init_subdir {
 484        my $repo_path = shift or return;
 485        mkpath([$repo_path]) unless -d $repo_path;
 486        chdir $repo_path or die "Couldn't chdir to $repo_path: $!\n";
 487        $ENV{GIT_DIR} = '.git';
 488        $_repository = Git->repository(Repository => $ENV{GIT_DIR});
 489}
 490
 491sub cmd_clone {
 492        my ($url, $path) = @_;
 493        if (!defined $path &&
 494            (defined $_trunk || @_branches || @_tags ||
 495             defined $_stdlayout) &&
 496            $url !~ m#^[a-z\+]+://#) {
 497                $path = $url;
 498        }
 499        $path = basename($url) if !defined $path || !length $path;
 500        my $authors_absolute = $_authors ? File::Spec->rel2abs($_authors) : "";
 501        cmd_init($url, $path);
 502        command_oneline('config', 'svn.authorsfile', $authors_absolute)
 503            if $_authors;
 504        Git::SVN::fetch_all($Git::SVN::default_repo_id);
 505}
 506
 507sub cmd_init {
 508        if (defined $_stdlayout) {
 509                $_trunk = 'trunk' if (!defined $_trunk);
 510                @_tags = 'tags' if (! @_tags);
 511                @_branches = 'branches' if (! @_branches);
 512        }
 513        if (defined $_trunk || @_branches || @_tags) {
 514                return cmd_multi_init(@_);
 515        }
 516        my $url = shift or die "SVN repository location required ",
 517                               "as a command-line argument\n";
 518        $url = canonicalize_url($url);
 519        init_subdir(@_);
 520        do_git_init_db();
 521
 522        if ($Git::SVN::_minimize_url eq 'unset') {
 523                $Git::SVN::_minimize_url = 0;
 524        }
 525
 526        Git::SVN->init($url);
 527}
 528
 529sub cmd_fetch {
 530        if (grep /^\d+=./, @_) {
 531                die "'<rev>=<commit>' fetch arguments are ",
 532                    "no longer supported.\n";
 533        }
 534        my ($remote) = @_;
 535        if (@_ > 1) {
 536                die "Usage: $0 fetch [--all] [--parent] [svn-remote]\n";
 537        }
 538        $Git::SVN::no_reuse_existing = undef;
 539        if ($_fetch_parent) {
 540                my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
 541                unless ($gs) {
 542                        die "Unable to determine upstream SVN information from ",
 543                            "working tree history\n";
 544                }
 545                # just fetch, don't checkout.
 546                $_no_checkout = 'true';
 547                $_fetch_all ? $gs->fetch_all : $gs->fetch;
 548        } elsif ($_fetch_all) {
 549                cmd_multi_fetch();
 550        } else {
 551                $remote ||= $Git::SVN::default_repo_id;
 552                Git::SVN::fetch_all($remote, Git::SVN::read_all_remotes());
 553        }
 554}
 555
 556sub cmd_set_tree {
 557        my (@commits) = @_;
 558        if ($_stdin || !@commits) {
 559                print "Reading from stdin...\n";
 560                @commits = ();
 561                while (<STDIN>) {
 562                        if (/\b($sha1_short)\b/o) {
 563                                unshift @commits, $1;
 564                        }
 565                }
 566        }
 567        my @revs;
 568        foreach my $c (@commits) {
 569                my @tmp = command('rev-parse',$c);
 570                if (scalar @tmp == 1) {
 571                        push @revs, $tmp[0];
 572                } elsif (scalar @tmp > 1) {
 573                        push @revs, reverse(command('rev-list',@tmp));
 574                } else {
 575                        fatal "Failed to rev-parse $c";
 576                }
 577        }
 578        my $gs = Git::SVN->new;
 579        my ($r_last, $cmt_last) = $gs->last_rev_commit;
 580        $gs->fetch;
 581        if (defined $gs->{last_rev} && $r_last != $gs->{last_rev}) {
 582                fatal "There are new revisions that were fetched ",
 583                      "and need to be merged (or acknowledged) ",
 584                      "before committing.\nlast rev: $r_last\n",
 585                      " current: $gs->{last_rev}";
 586        }
 587        $gs->set_tree($_) foreach @revs;
 588        print "Done committing ",scalar @revs," revisions to SVN\n";
 589        unlink $gs->{index};
 590}
 591
 592sub split_merge_info_range {
 593        my ($range) = @_;
 594        if ($range =~ /(\d+)-(\d+)/) {
 595                return (int($1), int($2));
 596        } else {
 597                return (int($range), int($range));
 598        }
 599}
 600
 601sub combine_ranges {
 602        my ($in) = @_;
 603
 604        my @fnums = ();
 605        my @arr = split(/,/, $in);
 606        for my $element (@arr) {
 607                my ($start, $end) = split_merge_info_range($element);
 608                push @fnums, $start;
 609        }
 610
 611        my @sorted = @arr [ sort {
 612                $fnums[$a] <=> $fnums[$b]
 613        } 0..$#arr ];
 614
 615        my @return = ();
 616        my $last = -1;
 617        my $first = -1;
 618        for my $element (@sorted) {
 619                my ($start, $end) = split_merge_info_range($element);
 620
 621                if ($last == -1) {
 622                        $first = $start;
 623                        $last = $end;
 624                        next;
 625                }
 626                if ($start <= $last+1) {
 627                        if ($end > $last) {
 628                                $last = $end;
 629                        }
 630                        next;
 631                }
 632                if ($first == $last) {
 633                        push @return, "$first";
 634                } else {
 635                        push @return, "$first-$last";
 636                }
 637                $first = $start;
 638                $last = $end;
 639        }
 640
 641        if ($first != -1) {
 642                if ($first == $last) {
 643                        push @return, "$first";
 644                } else {
 645                        push @return, "$first-$last";
 646                }
 647        }
 648
 649        return join(',', @return);
 650}
 651
 652sub merge_revs_into_hash {
 653        my ($hash, $minfo) = @_;
 654        my @lines = split(' ', $minfo);
 655
 656        for my $line (@lines) {
 657                my ($branchpath, $revs) = split(/:/, $line);
 658
 659                if (exists($hash->{$branchpath})) {
 660                        # Merge the two revision sets
 661                        my $combined = "$hash->{$branchpath},$revs";
 662                        $hash->{$branchpath} = combine_ranges($combined);
 663                } else {
 664                        # Just do range combining for consolidation
 665                        $hash->{$branchpath} = combine_ranges($revs);
 666                }
 667        }
 668}
 669
 670sub merge_merge_info {
 671        my ($mergeinfo_one, $mergeinfo_two) = @_;
 672        my %result_hash = ();
 673
 674        merge_revs_into_hash(\%result_hash, $mergeinfo_one);
 675        merge_revs_into_hash(\%result_hash, $mergeinfo_two);
 676
 677        my $result = '';
 678        # Sort below is for consistency's sake
 679        for my $branchname (sort keys(%result_hash)) {
 680                my $revlist = $result_hash{$branchname};
 681                $result .= "$branchname:$revlist\n"
 682        }
 683        return $result;
 684}
 685
 686sub populate_merge_info {
 687        my ($d, $gs, $uuid, $linear_refs, $rewritten_parent) = @_;
 688
 689        my %parentshash;
 690        read_commit_parents(\%parentshash, $d);
 691        my @parents = @{$parentshash{$d}};
 692        if ($#parents > 0) {
 693                # Merge commit
 694                my $all_parents_ok = 1;
 695                my $aggregate_mergeinfo = '';
 696                my $rooturl = $gs->repos_root;
 697
 698                if (defined($rewritten_parent)) {
 699                        # Replace first parent with newly-rewritten version
 700                        shift @parents;
 701                        unshift @parents, $rewritten_parent;
 702                }
 703
 704                foreach my $parent (@parents) {
 705                        my ($branchurl, $svnrev, $paruuid) =
 706                                cmt_metadata($parent);
 707
 708                        unless (defined($svnrev)) {
 709                                # Should have been caught be preflight check
 710                                fatal "merge commit $d has ancestor $parent, but that change "
 711                     ."does not have git-svn metadata!";
 712                        }
 713                        unless ($branchurl =~ /^\Q$rooturl\E(.*)/) {
 714                                fatal "commit $parent git-svn metadata changed mid-run!";
 715                        }
 716                        my $branchpath = $1;
 717
 718                        my $ra = Git::SVN::Ra->new($branchurl);
 719                        my (undef, undef, $props) =
 720                                $ra->get_dir(canonicalize_path("."), $svnrev);
 721                        my $par_mergeinfo = $props->{'svn:mergeinfo'};
 722                        unless (defined $par_mergeinfo) {
 723                                $par_mergeinfo = '';
 724                        }
 725                        # Merge previous mergeinfo values
 726                        $aggregate_mergeinfo =
 727                                merge_merge_info($aggregate_mergeinfo,
 728                                                                 $par_mergeinfo, 0);
 729
 730                        next if $parent eq $parents[0]; # Skip first parent
 731                        # Add new changes being placed in tree by merge
 732                        my @cmd = (qw/rev-list --reverse/,
 733                                           $parent, qw/--not/);
 734                        foreach my $par (@parents) {
 735                                unless ($par eq $parent) {
 736                                        push @cmd, $par;
 737                                }
 738                        }
 739                        my @revsin = ();
 740                        my ($revlist, $ctx) = command_output_pipe(@cmd);
 741                        while (<$revlist>) {
 742                                my $irev = $_;
 743                                chomp $irev;
 744                                my (undef, $csvnrev, undef) =
 745                                        cmt_metadata($irev);
 746                                unless (defined $csvnrev) {
 747                                        # A child is missing SVN annotations...
 748                                        # this might be OK, or might not be.
 749                                        warn "W:child $irev is merged into revision "
 750                                                 ."$d but does not have git-svn metadata. "
 751                                                 ."This means git-svn cannot determine the "
 752                                                 ."svn revision numbers to place into the "
 753                                                 ."svn:mergeinfo property. You must ensure "
 754                                                 ."a branch is entirely committed to "
 755                                                 ."SVN before merging it in order for "
 756                                                 ."svn:mergeinfo population to function "
 757                                                 ."properly";
 758                                }
 759                                push @revsin, $csvnrev;
 760                        }
 761                        command_close_pipe($revlist, $ctx);
 762
 763                        last unless $all_parents_ok;
 764
 765                        # We now have a list of all SVN revnos which are
 766                        # merged by this particular parent. Integrate them.
 767                        next if $#revsin == -1;
 768                        my $newmergeinfo = "$branchpath:" . join(',', @revsin);
 769                        $aggregate_mergeinfo =
 770                                merge_merge_info($aggregate_mergeinfo,
 771                                                                 $newmergeinfo, 1);
 772                }
 773                if ($all_parents_ok and $aggregate_mergeinfo) {
 774                        return $aggregate_mergeinfo;
 775                }
 776        }
 777
 778        return undef;
 779}
 780
 781sub cmd_dcommit {
 782        my $head = shift;
 783        command_noisy(qw/update-index --refresh/);
 784        git_cmd_try { command_oneline(qw/diff-index --quiet HEAD/) }
 785                'Cannot dcommit with a dirty index.  Commit your changes first, '
 786                . "or stash them with `git stash'.\n";
 787        $head ||= 'HEAD';
 788
 789        my $old_head;
 790        if ($head ne 'HEAD') {
 791                $old_head = eval {
 792                        command_oneline([qw/symbolic-ref -q HEAD/])
 793                };
 794                if ($old_head) {
 795                        $old_head =~ s{^refs/heads/}{};
 796                } else {
 797                        $old_head = eval { command_oneline(qw/rev-parse HEAD/) };
 798                }
 799                command(['checkout', $head], STDERR => 0);
 800        }
 801
 802        my @refs;
 803        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD', \@refs);
 804        unless ($gs) {
 805                die "Unable to determine upstream SVN information from ",
 806                    "$head history.\nPerhaps the repository is empty.";
 807        }
 808
 809        if (defined $_commit_url) {
 810                $url = $_commit_url;
 811        } else {
 812                $url = eval { command_oneline('config', '--get',
 813                              "svn-remote.$gs->{repo_id}.commiturl") };
 814                if (!$url) {
 815                        $url = $gs->full_pushurl
 816                }
 817        }
 818
 819        my $last_rev = $_revision if defined $_revision;
 820        if ($url) {
 821                print "Committing to $url ...\n";
 822        }
 823        my ($linear_refs, $parents) = linearize_history($gs, \@refs);
 824        if ($_no_rebase && scalar(@$linear_refs) > 1) {
 825                warn "Attempting to commit more than one change while ",
 826                     "--no-rebase is enabled.\n",
 827                     "If these changes depend on each other, re-running ",
 828                     "without --no-rebase may be required."
 829        }
 830
 831        if (defined $_interactive){
 832                my $ask_default = "y";
 833                foreach my $d (@$linear_refs){
 834                        my ($fh, $ctx) = command_output_pipe(qw(show --summary), "$d");
 835                        while (<$fh>){
 836                                print $_;
 837                        }
 838                        command_close_pipe($fh, $ctx);
 839                        $_ = ask("Commit this patch to SVN? ([y]es (default)|[n]o|[q]uit|[a]ll): ",
 840                                 valid_re => qr/^(?:yes|y|no|n|quit|q|all|a)/i,
 841                                 default => $ask_default);
 842                        die "Commit this patch reply required" unless defined $_;
 843                        if (/^[nq]/i) {
 844                                exit(0);
 845                        } elsif (/^a/i) {
 846                                last;
 847                        }
 848                }
 849        }
 850
 851        my $expect_url = $url;
 852
 853        my $push_merge_info = eval {
 854                command_oneline(qw/config --get svn.pushmergeinfo/)
 855                };
 856        if (not defined($push_merge_info)
 857                        or $push_merge_info eq "false"
 858                        or $push_merge_info eq "no"
 859                        or $push_merge_info eq "never") {
 860                $push_merge_info = 0;
 861        }
 862
 863        unless (defined($_merge_info) || ! $push_merge_info) {
 864                # Preflight check of changes to ensure no issues with mergeinfo
 865                # This includes check for uncommitted-to-SVN parents
 866                # (other than the first parent, which we will handle),
 867                # information from different SVN repos, and paths
 868                # which are not underneath this repository root.
 869                my $rooturl = $gs->repos_root;
 870                foreach my $d (@$linear_refs) {
 871                        my %parentshash;
 872                        read_commit_parents(\%parentshash, $d);
 873                        my @realparents = @{$parentshash{$d}};
 874                        if ($#realparents > 0) {
 875                                # Merge commit
 876                                shift @realparents; # Remove/ignore first parent
 877                                foreach my $parent (@realparents) {
 878                                        my ($branchurl, $svnrev, $paruuid) = cmt_metadata($parent);
 879                                        unless (defined $paruuid) {
 880                                                # A parent is missing SVN annotations...
 881                                                # abort the whole operation.
 882                                                fatal "$parent is merged into revision $d, "
 883                                                         ."but does not have git-svn metadata. "
 884                                                         ."Either dcommit the branch or use a "
 885                                                         ."local cherry-pick, FF merge, or rebase "
 886                                                         ."instead of an explicit merge commit.";
 887                                        }
 888
 889                                        unless ($paruuid eq $uuid) {
 890                                                # Parent has SVN metadata from different repository
 891                                                fatal "merge parent $parent for change $d has "
 892                                                         ."git-svn uuid $paruuid, while current change "
 893                                                         ."has uuid $uuid!";
 894                                        }
 895
 896                                        unless ($branchurl =~ /^\Q$rooturl\E(.*)/) {
 897                                                # This branch is very strange indeed.
 898                                                fatal "merge parent $parent for $d is on branch "
 899                                                         ."$branchurl, which is not under the "
 900                                                         ."git-svn root $rooturl!";
 901                                        }
 902                                }
 903                        }
 904                }
 905        }
 906
 907        my $rewritten_parent;
 908        Git::SVN::remove_username($expect_url);
 909        if (defined($_merge_info)) {
 910                $_merge_info =~ tr{ }{\n};
 911        }
 912        while (1) {
 913                my $d = shift @$linear_refs or last;
 914                unless (defined $last_rev) {
 915                        (undef, $last_rev, undef) = cmt_metadata("$d~1");
 916                        unless (defined $last_rev) {
 917                                fatal "Unable to extract revision information ",
 918                                      "from commit $d~1";
 919                        }
 920                }
 921                if ($_dry_run) {
 922                        print "diff-tree $d~1 $d\n";
 923                } else {
 924                        my $cmt_rev;
 925
 926                        unless (defined($_merge_info) || ! $push_merge_info) {
 927                                $_merge_info = populate_merge_info($d, $gs,
 928                                                             $uuid,
 929                                                             $linear_refs,
 930                                                             $rewritten_parent);
 931                        }
 932
 933                        my %ed_opts = ( r => $last_rev,
 934                                        log => get_commit_entry($d)->{log},
 935                                        ra => Git::SVN::Ra->new($url),
 936                                        config => SVN::Core::config_get_config(
 937                                                $Git::SVN::Ra::config_dir
 938                                        ),
 939                                        tree_a => "$d~1",
 940                                        tree_b => $d,
 941                                        editor_cb => sub {
 942                                               print "Committed r$_[0]\n";
 943                                               $cmt_rev = $_[0];
 944                                        },
 945                                        mergeinfo => $_merge_info,
 946                                        svn_path => '');
 947                        if (!Git::SVN::Editor->new(\%ed_opts)->apply_diff) {
 948                                print "No changes\n$d~1 == $d\n";
 949                        } elsif ($parents->{$d} && @{$parents->{$d}}) {
 950                                $gs->{inject_parents_dcommit}->{$cmt_rev} =
 951                                                               $parents->{$d};
 952                        }
 953                        $_fetch_all ? $gs->fetch_all : $gs->fetch;
 954                        $last_rev = $cmt_rev;
 955                        next if $_no_rebase;
 956
 957                        # we always want to rebase against the current HEAD,
 958                        # not any head that was passed to us
 959                        my @diff = command('diff-tree', $d,
 960                                           $gs->refname, '--');
 961                        my @finish;
 962                        if (@diff) {
 963                                @finish = rebase_cmd();
 964                                print STDERR "W: $d and ", $gs->refname,
 965                                             " differ, using @finish:\n",
 966                                             join("\n", @diff), "\n";
 967                        } else {
 968                                print "No changes between current HEAD and ",
 969                                      $gs->refname,
 970                                      "\nResetting to the latest ",
 971                                      $gs->refname, "\n";
 972                                @finish = qw/reset --mixed/;
 973                        }
 974                        command_noisy(@finish, $gs->refname);
 975
 976                        $rewritten_parent = command_oneline(qw/rev-parse HEAD/);
 977
 978                        if (@diff) {
 979                                @refs = ();
 980                                my ($url_, $rev_, $uuid_, $gs_) =
 981                                              working_head_info('HEAD', \@refs);
 982                                my ($linear_refs_, $parents_) =
 983                                              linearize_history($gs_, \@refs);
 984                                if (scalar(@$linear_refs) !=
 985                                    scalar(@$linear_refs_)) {
 986                                        fatal "# of revisions changed ",
 987                                          "\nbefore:\n",
 988                                          join("\n", @$linear_refs),
 989                                          "\n\nafter:\n",
 990                                          join("\n", @$linear_refs_), "\n",
 991                                          'If you are attempting to commit ',
 992                                          "merges, try running:\n\t",
 993                                          'git rebase --interactive',
 994                                          '--preserve-merges ',
 995                                          $gs->refname,
 996                                          "\nBefore dcommitting";
 997                                }
 998                                if ($url_ ne $expect_url) {
 999                                        if ($url_ eq $gs->metadata_url) {
1000                                                print
1001                                                  "Accepting rewritten URL:",
1002                                                  " $url_\n";
1003                                        } else {
1004                                                fatal
1005                                                  "URL mismatch after rebase:",
1006                                                  " $url_ != $expect_url";
1007                                        }
1008                                }
1009                                if ($uuid_ ne $uuid) {
1010                                        fatal "uuid mismatch after rebase: ",
1011                                              "$uuid_ != $uuid";
1012                                }
1013                                # remap parents
1014                                my (%p, @l, $i);
1015                                for ($i = 0; $i < scalar @$linear_refs; $i++) {
1016                                        my $new = $linear_refs_->[$i] or next;
1017                                        $p{$new} =
1018                                                $parents->{$linear_refs->[$i]};
1019                                        push @l, $new;
1020                                }
1021                                $parents = \%p;
1022                                $linear_refs = \@l;
1023                        }
1024                }
1025        }
1026
1027        if ($old_head) {
1028                my $new_head = command_oneline(qw/rev-parse HEAD/);
1029                my $new_is_symbolic = eval {
1030                        command_oneline(qw/symbolic-ref -q HEAD/);
1031                };
1032                if ($new_is_symbolic) {
1033                        print "dcommitted the branch ", $head, "\n";
1034                } else {
1035                        print "dcommitted on a detached HEAD because you gave ",
1036                              "a revision argument.\n",
1037                              "The rewritten commit is: ", $new_head, "\n";
1038                }
1039                command(['checkout', $old_head], STDERR => 0);
1040        }
1041
1042        unlink $gs->{index};
1043}
1044
1045sub cmd_branch {
1046        my ($branch_name, $head) = @_;
1047
1048        unless (defined $branch_name && length $branch_name) {
1049                die(($_tag ? "tag" : "branch") . " name required\n");
1050        }
1051        $head ||= 'HEAD';
1052
1053        my (undef, $rev, undef, $gs) = working_head_info($head);
1054        my $src = $gs->full_pushurl;
1055
1056        my $remote = Git::SVN::read_all_remotes()->{$gs->{repo_id}};
1057        my $allglobs = $remote->{ $_tag ? 'tags' : 'branches' };
1058        my $glob;
1059        if ($#{$allglobs} == 0) {
1060                $glob = $allglobs->[0];
1061        } else {
1062                unless(defined $_branch_dest) {
1063                        die "Multiple ",
1064                            $_tag ? "tag" : "branch",
1065                            " paths defined for Subversion repository.\n",
1066                            "You must specify where you want to create the ",
1067                            $_tag ? "tag" : "branch",
1068                            " with the --destination argument.\n";
1069                }
1070                foreach my $g (@{$allglobs}) {
1071                        my $re = Git::SVN::Editor::glob2pat($g->{path}->{left});
1072                        if ($_branch_dest =~ /$re/) {
1073                                $glob = $g;
1074                                last;
1075                        }
1076                }
1077                unless (defined $glob) {
1078                        my $dest_re = qr/\b\Q$_branch_dest\E\b/;
1079                        foreach my $g (@{$allglobs}) {
1080                                $g->{path}->{left} =~ /$dest_re/ or next;
1081                                if (defined $glob) {
1082                                        die "Ambiguous destination: ",
1083                                            $_branch_dest, "\nmatches both '",
1084                                            $glob->{path}->{left}, "' and '",
1085                                            $g->{path}->{left}, "'\n";
1086                                }
1087                                $glob = $g;
1088                        }
1089                        unless (defined $glob) {
1090                                die "Unknown ",
1091                                    $_tag ? "tag" : "branch",
1092                                    " destination $_branch_dest\n";
1093                        }
1094                }
1095        }
1096        my ($lft, $rgt) = @{ $glob->{path} }{qw/left right/};
1097        my $url;
1098        if (defined $_commit_url) {
1099                $url = $_commit_url;
1100        } else {
1101                $url = eval { command_oneline('config', '--get',
1102                        "svn-remote.$gs->{repo_id}.commiturl") };
1103                if (!$url) {
1104                        $url = $remote->{pushurl} || $remote->{url};
1105                }
1106        }
1107        my $dst = join '/', $url, $lft, $branch_name, ($rgt || ());
1108
1109        if ($dst =~ /^https:/ && $src =~ /^http:/) {
1110                $src=~s/^http:/https:/;
1111        }
1112
1113        ::_req_svn();
1114
1115        my $ctx = SVN::Client->new(
1116                auth    => Git::SVN::Ra::_auth_providers(),
1117                log_msg => sub {
1118                        ${ $_[0] } = defined $_message
1119                                ? $_message
1120                                : 'Create ' . ($_tag ? 'tag ' : 'branch ' )
1121                                . $branch_name;
1122                },
1123        );
1124
1125        eval {
1126                $ctx->ls($dst, 'HEAD', 0);
1127        } and die "branch ${branch_name} already exists\n";
1128
1129        print "Copying ${src} at r${rev} to ${dst}...\n";
1130        $ctx->copy($src, $rev, $dst)
1131                unless $_dry_run;
1132
1133        $gs->fetch_all;
1134}
1135
1136sub cmd_find_rev {
1137        my $revision_or_hash = shift or die "SVN or git revision required ",
1138                                            "as a command-line argument\n";
1139        my $result;
1140        if ($revision_or_hash =~ /^r\d+$/) {
1141                my $head = shift;
1142                $head ||= 'HEAD';
1143                my @refs;
1144                my (undef, undef, $uuid, $gs) = working_head_info($head, \@refs);
1145                unless ($gs) {
1146                        die "Unable to determine upstream SVN information from ",
1147                            "$head history\n";
1148                }
1149                my $desired_revision = substr($revision_or_hash, 1);
1150                $result = $gs->rev_map_get($desired_revision, $uuid);
1151        } else {
1152                my (undef, $rev, undef) = cmt_metadata($revision_or_hash);
1153                $result = $rev;
1154        }
1155        print "$result\n" if $result;
1156}
1157
1158sub auto_create_empty_directories {
1159        my ($gs) = @_;
1160        my $var = eval { command_oneline('config', '--get', '--bool',
1161                                         "svn-remote.$gs->{repo_id}.automkdirs") };
1162        # By default, create empty directories by consulting the unhandled log,
1163        # but allow setting it to 'false' to skip it.
1164        return !($var && $var eq 'false');
1165}
1166
1167sub cmd_rebase {
1168        command_noisy(qw/update-index --refresh/);
1169        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1170        unless ($gs) {
1171                die "Unable to determine upstream SVN information from ",
1172                    "working tree history\n";
1173        }
1174        if ($_dry_run) {
1175                print "Remote Branch: " . $gs->refname . "\n";
1176                print "SVN URL: " . $url . "\n";
1177                return;
1178        }
1179        if (command(qw/diff-index HEAD --/)) {
1180                print STDERR "Cannot rebase with uncommited changes:\n";
1181                command_noisy('status');
1182                exit 1;
1183        }
1184        unless ($_local) {
1185                # rebase will checkout for us, so no need to do it explicitly
1186                $_no_checkout = 'true';
1187                $_fetch_all ? $gs->fetch_all : $gs->fetch;
1188        }
1189        command_noisy(rebase_cmd(), $gs->refname);
1190        if (auto_create_empty_directories($gs)) {
1191                $gs->mkemptydirs;
1192        }
1193}
1194
1195sub cmd_show_ignore {
1196        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1197        $gs ||= Git::SVN->new;
1198        my $r = (defined $_revision ? $_revision : $gs->ra->get_latest_revnum);
1199        $gs->prop_walk($gs->{path}, $r, sub {
1200                my ($gs, $path, $props) = @_;
1201                print STDOUT "\n# $path\n";
1202                my $s = $props->{'svn:ignore'} or return;
1203                $s =~ s/[\r\n]+/\n/g;
1204                $s =~ s/^\n+//;
1205                chomp $s;
1206                $s =~ s#^#$path#gm;
1207                print STDOUT "$s\n";
1208        });
1209}
1210
1211sub cmd_show_externals {
1212        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1213        $gs ||= Git::SVN->new;
1214        my $r = (defined $_revision ? $_revision : $gs->ra->get_latest_revnum);
1215        $gs->prop_walk($gs->{path}, $r, sub {
1216                my ($gs, $path, $props) = @_;
1217                print STDOUT "\n# $path\n";
1218                my $s = $props->{'svn:externals'} or return;
1219                $s =~ s/[\r\n]+/\n/g;
1220                chomp $s;
1221                $s =~ s#^#$path#gm;
1222                print STDOUT "$s\n";
1223        });
1224}
1225
1226sub cmd_create_ignore {
1227        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1228        $gs ||= Git::SVN->new;
1229        my $r = (defined $_revision ? $_revision : $gs->ra->get_latest_revnum);
1230        $gs->prop_walk($gs->{path}, $r, sub {
1231                my ($gs, $path, $props) = @_;
1232                # $path is of the form /path/to/dir/
1233                $path = '.' . $path;
1234                # SVN can have attributes on empty directories,
1235                # which git won't track
1236                mkpath([$path]) unless -d $path;
1237                my $ignore = $path . '.gitignore';
1238                my $s = $props->{'svn:ignore'} or return;
1239                open(GITIGNORE, '>', $ignore)
1240                  or fatal("Failed to open `$ignore' for writing: $!");
1241                $s =~ s/[\r\n]+/\n/g;
1242                $s =~ s/^\n+//;
1243                chomp $s;
1244                # Prefix all patterns so that the ignore doesn't apply
1245                # to sub-directories.
1246                $s =~ s#^#/#gm;
1247                print GITIGNORE "$s\n";
1248                close(GITIGNORE)
1249                  or fatal("Failed to close `$ignore': $!");
1250                command_noisy('add', '-f', $ignore);
1251        });
1252}
1253
1254sub cmd_mkdirs {
1255        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1256        $gs ||= Git::SVN->new;
1257        $gs->mkemptydirs($_revision);
1258}
1259
1260sub canonicalize_path {
1261        my ($path) = @_;
1262        my $dot_slash_added = 0;
1263        if (substr($path, 0, 1) ne "/") {
1264                $path = "./" . $path;
1265                $dot_slash_added = 1;
1266        }
1267        # File::Spec->canonpath doesn't collapse x/../y into y (for a
1268        # good reason), so let's do this manually.
1269        $path =~ s#/+#/#g;
1270        $path =~ s#/\.(?:/|$)#/#g;
1271        $path =~ s#/[^/]+/\.\.##g;
1272        $path =~ s#/$##g;
1273        $path =~ s#^\./## if $dot_slash_added;
1274        $path =~ s#^/##;
1275        $path =~ s#^\.$##;
1276        return $path;
1277}
1278
1279sub canonicalize_url {
1280        my ($url) = @_;
1281        $url =~ s#^([^:]+://[^/]*/)(.*)$#$1 . canonicalize_path($2)#e;
1282        return $url;
1283}
1284
1285# get_svnprops(PATH)
1286# ------------------
1287# Helper for cmd_propget and cmd_proplist below.
1288sub get_svnprops {
1289        my $path = shift;
1290        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1291        $gs ||= Git::SVN->new;
1292
1293        # prefix THE PATH by the sub-directory from which the user
1294        # invoked us.
1295        $path = $cmd_dir_prefix . $path;
1296        fatal("No such file or directory: $path") unless -e $path;
1297        my $is_dir = -d $path ? 1 : 0;
1298        $path = $gs->{path} . '/' . $path;
1299
1300        # canonicalize the path (otherwise libsvn will abort or fail to
1301        # find the file)
1302        $path = canonicalize_path($path);
1303
1304        my $r = (defined $_revision ? $_revision : $gs->ra->get_latest_revnum);
1305        my $props;
1306        if ($is_dir) {
1307                (undef, undef, $props) = $gs->ra->get_dir($path, $r);
1308        }
1309        else {
1310                (undef, $props) = $gs->ra->get_file($path, $r, undef);
1311        }
1312        return $props;
1313}
1314
1315# cmd_propget (PROP, PATH)
1316# ------------------------
1317# Print the SVN property PROP for PATH.
1318sub cmd_propget {
1319        my ($prop, $path) = @_;
1320        $path = '.' if not defined $path;
1321        usage(1) if not defined $prop;
1322        my $props = get_svnprops($path);
1323        if (not defined $props->{$prop}) {
1324                fatal("`$path' does not have a `$prop' SVN property.");
1325        }
1326        print $props->{$prop} . "\n";
1327}
1328
1329# cmd_proplist (PATH)
1330# -------------------
1331# Print the list of SVN properties for PATH.
1332sub cmd_proplist {
1333        my $path = shift;
1334        $path = '.' if not defined $path;
1335        my $props = get_svnprops($path);
1336        print "Properties on '$path':\n";
1337        foreach (sort keys %{$props}) {
1338                print "  $_\n";
1339        }
1340}
1341
1342sub cmd_multi_init {
1343        my $url = shift;
1344        unless (defined $_trunk || @_branches || @_tags) {
1345                usage(1);
1346        }
1347
1348        $_prefix = '' unless defined $_prefix;
1349        if (defined $url) {
1350                $url = canonicalize_url($url);
1351                init_subdir(@_);
1352        }
1353        do_git_init_db();
1354        if (defined $_trunk) {
1355                $_trunk =~ s#^/+##;
1356                my $trunk_ref = 'refs/remotes/' . $_prefix . 'trunk';
1357                # try both old-style and new-style lookups:
1358                my $gs_trunk = eval { Git::SVN->new($trunk_ref) };
1359                unless ($gs_trunk) {
1360                        my ($trunk_url, $trunk_path) =
1361                                              complete_svn_url($url, $_trunk);
1362                        $gs_trunk = Git::SVN->init($trunk_url, $trunk_path,
1363                                                   undef, $trunk_ref);
1364                }
1365        }
1366        return unless @_branches || @_tags;
1367        my $ra = $url ? Git::SVN::Ra->new($url) : undef;
1368        foreach my $path (@_branches) {
1369                complete_url_ls_init($ra, $path, '--branches/-b', $_prefix);
1370        }
1371        foreach my $path (@_tags) {
1372                complete_url_ls_init($ra, $path, '--tags/-t', $_prefix.'tags/');
1373        }
1374}
1375
1376sub cmd_multi_fetch {
1377        $Git::SVN::no_reuse_existing = undef;
1378        my $remotes = Git::SVN::read_all_remotes();
1379        foreach my $repo_id (sort keys %$remotes) {
1380                if ($remotes->{$repo_id}->{url}) {
1381                        Git::SVN::fetch_all($repo_id, $remotes);
1382                }
1383        }
1384}
1385
1386# this command is special because it requires no metadata
1387sub cmd_commit_diff {
1388        my ($ta, $tb, $url) = @_;
1389        my $usage = "Usage: $0 commit-diff -r<revision> ".
1390                    "<tree-ish> <tree-ish> [<URL>]";
1391        fatal($usage) if (!defined $ta || !defined $tb);
1392        my $svn_path = '';
1393        if (!defined $url) {
1394                my $gs = eval { Git::SVN->new };
1395                if (!$gs) {
1396                        fatal("Needed URL or usable git-svn --id in ",
1397                              "the command-line\n", $usage);
1398                }
1399                $url = $gs->{url};
1400                $svn_path = $gs->{path};
1401        }
1402        unless (defined $_revision) {
1403                fatal("-r|--revision is a required argument\n", $usage);
1404        }
1405        if (defined $_message && defined $_file) {
1406                fatal("Both --message/-m and --file/-F specified ",
1407                      "for the commit message.\n",
1408                      "I have no idea what you mean");
1409        }
1410        if (defined $_file) {
1411                $_message = file_to_s($_file);
1412        } else {
1413                $_message ||= get_commit_entry($tb)->{log};
1414        }
1415        my $ra ||= Git::SVN::Ra->new($url);
1416        my $r = $_revision;
1417        if ($r eq 'HEAD') {
1418                $r = $ra->get_latest_revnum;
1419        } elsif ($r !~ /^\d+$/) {
1420                die "revision argument: $r not understood by git-svn\n";
1421        }
1422        my %ed_opts = ( r => $r,
1423                        log => $_message,
1424                        ra => $ra,
1425                        tree_a => $ta,
1426                        tree_b => $tb,
1427                        editor_cb => sub { print "Committed r$_[0]\n" },
1428                        svn_path => $svn_path );
1429        if (!Git::SVN::Editor->new(\%ed_opts)->apply_diff) {
1430                print "No changes\n$ta == $tb\n";
1431        }
1432}
1433
1434sub escape_uri_only {
1435        my ($uri) = @_;
1436        my @tmp;
1437        foreach (split m{/}, $uri) {
1438                s/([^~\w.%+-]|%(?![a-fA-F0-9]{2}))/sprintf("%%%02X",ord($1))/eg;
1439                push @tmp, $_;
1440        }
1441        join('/', @tmp);
1442}
1443
1444sub escape_url {
1445        my ($url) = @_;
1446        if ($url =~ m#^([^:]+)://([^/]*)(.*)$#) {
1447                my ($scheme, $domain, $uri) = ($1, $2, escape_uri_only($3));
1448                $url = "$scheme://$domain$uri";
1449        }
1450        $url;
1451}
1452
1453sub cmd_info {
1454        my $path = canonicalize_path(defined($_[0]) ? $_[0] : ".");
1455        my $fullpath = canonicalize_path($cmd_dir_prefix . $path);
1456        if (exists $_[1]) {
1457                die "Too many arguments specified\n";
1458        }
1459
1460        my ($file_type, $diff_status) = find_file_type_and_diff_status($path);
1461
1462        if (!$file_type && !$diff_status) {
1463                print STDERR "svn: '$path' is not under version control\n";
1464                exit 1;
1465        }
1466
1467        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1468        unless ($gs) {
1469                die "Unable to determine upstream SVN information from ",
1470                    "working tree history\n";
1471        }
1472
1473        # canonicalize_path() will return "" to make libsvn 1.5.x happy,
1474        $path = "." if $path eq "";
1475
1476        my $full_url = $url . ($fullpath eq "" ? "" : "/$fullpath");
1477
1478        if ($_url) {
1479                print escape_url($full_url), "\n";
1480                return;
1481        }
1482
1483        my $result = "Path: $path\n";
1484        $result .= "Name: " . basename($path) . "\n" if $file_type ne "dir";
1485        $result .= "URL: " . escape_url($full_url) . "\n";
1486
1487        eval {
1488                my $repos_root = $gs->repos_root;
1489                Git::SVN::remove_username($repos_root);
1490                $result .= "Repository Root: " . escape_url($repos_root) . "\n";
1491        };
1492        if ($@) {
1493                $result .= "Repository Root: (offline)\n";
1494        }
1495        ::_req_svn();
1496        $result .= "Repository UUID: $uuid\n" unless $diff_status eq "A" &&
1497                (::compare_svn_version('1.5.4') <= 0 || $file_type ne "dir");
1498        $result .= "Revision: " . ($diff_status eq "A" ? 0 : $rev) . "\n";
1499
1500        $result .= "Node Kind: " .
1501                   ($file_type eq "dir" ? "directory" : "file") . "\n";
1502
1503        my $schedule = $diff_status eq "A"
1504                       ? "add"
1505                       : ($diff_status eq "D" ? "delete" : "normal");
1506        $result .= "Schedule: $schedule\n";
1507
1508        if ($diff_status eq "A") {
1509                print $result, "\n";
1510                return;
1511        }
1512
1513        my ($lc_author, $lc_rev, $lc_date_utc);
1514        my @args = Git::SVN::Log::git_svn_log_cmd($rev, $rev, "--", $fullpath);
1515        my $log = command_output_pipe(@args);
1516        my $esc_color = qr/(?:\033\[(?:(?:\d+;)*\d*)?m)*/;
1517        while (<$log>) {
1518                if (/^${esc_color}author (.+) <[^>]+> (\d+) ([\-\+]?\d+)$/o) {
1519                        $lc_author = $1;
1520                        $lc_date_utc = Git::SVN::Log::parse_git_date($2, $3);
1521                } elsif (/^${esc_color}    (git-svn-id:.+)$/o) {
1522                        (undef, $lc_rev, undef) = ::extract_metadata($1);
1523                }
1524        }
1525        close $log;
1526
1527        Git::SVN::Log::set_local_timezone();
1528
1529        $result .= "Last Changed Author: $lc_author\n";
1530        $result .= "Last Changed Rev: $lc_rev\n";
1531        $result .= "Last Changed Date: " .
1532                   Git::SVN::Log::format_svn_date($lc_date_utc) . "\n";
1533
1534        if ($file_type ne "dir") {
1535                my $text_last_updated_date =
1536                    ($diff_status eq "D" ? $lc_date_utc : (stat $path)[9]);
1537                $result .=
1538                    "Text Last Updated: " .
1539                    Git::SVN::Log::format_svn_date($text_last_updated_date) .
1540                    "\n";
1541                my $checksum;
1542                if ($diff_status eq "D") {
1543                        my ($fh, $ctx) =
1544                            command_output_pipe(qw(cat-file blob), "HEAD:$path");
1545                        if ($file_type eq "link") {
1546                                my $file_name = <$fh>;
1547                                $checksum = md5sum("link $file_name");
1548                        } else {
1549                                $checksum = md5sum($fh);
1550                        }
1551                        command_close_pipe($fh, $ctx);
1552                } elsif ($file_type eq "link") {
1553                        my $file_name =
1554                            command(qw(cat-file blob), "HEAD:$path");
1555                        $checksum =
1556                            md5sum("link " . $file_name);
1557                } else {
1558                        open FILE, "<", $path or die $!;
1559                        $checksum = md5sum(\*FILE);
1560                        close FILE or die $!;
1561                }
1562                $result .= "Checksum: " . $checksum . "\n";
1563        }
1564
1565        print $result, "\n";
1566}
1567
1568sub cmd_reset {
1569        my $target = shift || $_revision or die "SVN revision required\n";
1570        $target = $1 if $target =~ /^r(\d+)$/;
1571        $target =~ /^\d+$/ or die "Numeric SVN revision expected\n";
1572        my ($url, $rev, $uuid, $gs) = working_head_info('HEAD');
1573        unless ($gs) {
1574                die "Unable to determine upstream SVN information from ".
1575                    "history\n";
1576        }
1577        my ($r, $c) = $gs->find_rev_before($target, not $_fetch_parent);
1578        die "Cannot find SVN revision $target\n" unless defined($c);
1579        $gs->rev_map_set($r, $c, 'reset', $uuid);
1580        print "r$r = $c ($gs->{ref_id})\n";
1581}
1582
1583sub cmd_gc {
1584        if (!can_compress()) {
1585                warn "Compress::Zlib could not be found; unhandled.log " .
1586                     "files will not be compressed.\n";
1587        }
1588        find({ wanted => \&gc_directory, no_chdir => 1}, "$ENV{GIT_DIR}/svn");
1589}
1590
1591########################### utility functions #########################
1592
1593sub rebase_cmd {
1594        my @cmd = qw/rebase/;
1595        push @cmd, '-v' if $_verbose;
1596        push @cmd, qw/--merge/ if $_merge;
1597        push @cmd, "--strategy=$_strategy" if $_strategy;
1598        push @cmd, "--preserve-merges" if $_preserve_merges;
1599        @cmd;
1600}
1601
1602sub post_fetch_checkout {
1603        return if $_no_checkout;
1604        return if verify_ref('HEAD^0');
1605        my $gs = $Git::SVN::_head or return;
1606
1607        # look for "trunk" ref if it exists
1608        my $remote = Git::SVN::read_all_remotes()->{$gs->{repo_id}};
1609        my $fetch = $remote->{fetch};
1610        if ($fetch) {
1611                foreach my $p (keys %$fetch) {
1612                        basename($fetch->{$p}) eq 'trunk' or next;
1613                        $gs = Git::SVN->new($fetch->{$p}, $gs->{repo_id}, $p);
1614                        last;
1615                }
1616        }
1617
1618        command_noisy(qw(update-ref HEAD), $gs->refname);
1619        return unless verify_ref('HEAD^0');
1620
1621        return if $ENV{GIT_DIR} !~ m#^(?:.*/)?\.git$#;
1622        my $index = $ENV{GIT_INDEX_FILE} || "$ENV{GIT_DIR}/index";
1623        return if -f $index;
1624
1625        return if command_oneline(qw/rev-parse --is-inside-work-tree/) eq 'false';
1626        return if command_oneline(qw/rev-parse --is-inside-git-dir/) eq 'true';
1627        command_noisy(qw/read-tree -m -u -v HEAD HEAD/);
1628        print STDERR "Checked out HEAD:\n  ",
1629                     $gs->full_url, " r", $gs->last_rev, "\n";
1630        if (auto_create_empty_directories($gs)) {
1631                $gs->mkemptydirs($gs->last_rev);
1632        }
1633}
1634
1635sub complete_svn_url {
1636        my ($url, $path) = @_;
1637        $path =~ s#/+$##;
1638        if ($path !~ m#^[a-z\+]+://#) {
1639                if (!defined $url || $url !~ m#^[a-z\+]+://#) {
1640                        fatal("E: '$path' is not a complete URL ",
1641                              "and a separate URL is not specified");
1642                }
1643                return ($url, $path);
1644        }
1645        return ($path, '');
1646}
1647
1648sub complete_url_ls_init {
1649        my ($ra, $repo_path, $switch, $pfx) = @_;
1650        unless ($repo_path) {
1651                print STDERR "W: $switch not specified\n";
1652                return;
1653        }
1654        $repo_path =~ s#/+$##;
1655        if ($repo_path =~ m#^[a-z\+]+://#) {
1656                $ra = Git::SVN::Ra->new($repo_path);
1657                $repo_path = '';
1658        } else {
1659                $repo_path =~ s#^/+##;
1660                unless ($ra) {
1661                        fatal("E: '$repo_path' is not a complete URL ",
1662                              "and a separate URL is not specified");
1663                }
1664        }
1665        my $url = $ra->{url};
1666        my $gs = Git::SVN->init($url, undef, undef, undef, 1);
1667        my $k = "svn-remote.$gs->{repo_id}.url";
1668        my $orig_url = eval { command_oneline(qw/config --get/, $k) };
1669        if ($orig_url && ($orig_url ne $gs->{url})) {
1670                die "$k already set: $orig_url\n",
1671                    "wanted to set to: $gs->{url}\n";
1672        }
1673        command_oneline('config', $k, $gs->{url}) unless $orig_url;
1674        my $remote_path = "$gs->{path}/$repo_path";
1675        $remote_path =~ s{%([0-9A-F]{2})}{chr hex($1)}ieg;
1676        $remote_path =~ s#/+#/#g;
1677        $remote_path =~ s#^/##g;
1678        $remote_path .= "/*" if $remote_path !~ /\*/;
1679        my ($n) = ($switch =~ /^--(\w+)/);
1680        if (length $pfx && $pfx !~ m#/$#) {
1681                die "--prefix='$pfx' must have a trailing slash '/'\n";
1682        }
1683        command_noisy('config',
1684                      '--add',
1685                      "svn-remote.$gs->{repo_id}.$n",
1686                      "$remote_path:refs/remotes/$pfx*" .
1687                        ('/*' x (($remote_path =~ tr/*/*/) - 1)) );
1688}
1689
1690sub verify_ref {
1691        my ($ref) = @_;
1692        eval { command_oneline([ 'rev-parse', '--verify', $ref ],
1693                               { STDERR => 0 }); };
1694}
1695
1696sub get_tree_from_treeish {
1697        my ($treeish) = @_;
1698        # $treeish can be a symbolic ref, too:
1699        my $type = command_oneline(qw/cat-file -t/, $treeish);
1700        my $expected;
1701        while ($type eq 'tag') {
1702                ($treeish, $type) = command(qw/cat-file tag/, $treeish);
1703        }
1704        if ($type eq 'commit') {
1705                $expected = (grep /^tree /, command(qw/cat-file commit/,
1706                                                    $treeish))[0];
1707                ($expected) = ($expected =~ /^tree ($sha1)$/o);
1708                die "Unable to get tree from $treeish\n" unless $expected;
1709        } elsif ($type eq 'tree') {
1710                $expected = $treeish;
1711        } else {
1712                die "$treeish is a $type, expected tree, tag or commit\n";
1713        }
1714        return $expected;
1715}
1716
1717sub get_commit_entry {
1718        my ($treeish) = shift;
1719        my %log_entry = ( log => '', tree => get_tree_from_treeish($treeish) );
1720        my $commit_editmsg = "$ENV{GIT_DIR}/COMMIT_EDITMSG";
1721        my $commit_msg = "$ENV{GIT_DIR}/COMMIT_MSG";
1722        open my $log_fh, '>', $commit_editmsg or croak $!;
1723
1724        my $type = command_oneline(qw/cat-file -t/, $treeish);
1725        if ($type eq 'commit' || $type eq 'tag') {
1726                my ($msg_fh, $ctx) = command_output_pipe('cat-file',
1727                                                         $type, $treeish);
1728                my $in_msg = 0;
1729                my $author;
1730                my $saw_from = 0;
1731                my $msgbuf = "";
1732                while (<$msg_fh>) {
1733                        if (!$in_msg) {
1734                                $in_msg = 1 if (/^\s*$/);
1735                                $author = $1 if (/^author (.*>)/);
1736                        } elsif (/^git-svn-id: /) {
1737                                # skip this for now, we regenerate the
1738                                # correct one on re-fetch anyways
1739                                # TODO: set *:merge properties or like...
1740                        } else {
1741                                if (/^From:/ || /^Signed-off-by:/) {
1742                                        $saw_from = 1;
1743                                }
1744                                $msgbuf .= $_;
1745                        }
1746                }
1747                $msgbuf =~ s/\s+$//s;
1748                if ($Git::SVN::_add_author_from && defined($author)
1749                    && !$saw_from) {
1750                        $msgbuf .= "\n\nFrom: $author";
1751                }
1752                print $log_fh $msgbuf or croak $!;
1753                command_close_pipe($msg_fh, $ctx);
1754        }
1755        close $log_fh or croak $!;
1756
1757        if ($_edit || ($type eq 'tree')) {
1758                chomp(my $editor = command_oneline(qw(var GIT_EDITOR)));
1759                system('sh', '-c', $editor.' "$@"', $editor, $commit_editmsg);
1760        }
1761        rename $commit_editmsg, $commit_msg or croak $!;
1762        {
1763                require Encode;
1764                # SVN requires messages to be UTF-8 when entering the repo
1765                local $/;
1766                open $log_fh, '<', $commit_msg or croak $!;
1767                binmode $log_fh;
1768                chomp($log_entry{log} = <$log_fh>);
1769
1770                my $enc = Git::config('i18n.commitencoding') || 'UTF-8';
1771                my $msg = $log_entry{log};
1772
1773                eval { $msg = Encode::decode($enc, $msg, 1) };
1774                if ($@) {
1775                        die "Could not decode as $enc:\n", $msg,
1776                            "\nPerhaps you need to set i18n.commitencoding\n";
1777                }
1778
1779                eval { $msg = Encode::encode('UTF-8', $msg, 1) };
1780                die "Could not encode as UTF-8:\n$msg\n" if $@;
1781
1782                $log_entry{log} = $msg;
1783
1784                close $log_fh or croak $!;
1785        }
1786        unlink $commit_msg;
1787        \%log_entry;
1788}
1789
1790sub s_to_file {
1791        my ($str, $file, $mode) = @_;
1792        open my $fd,'>',$file or croak $!;
1793        print $fd $str,"\n" or croak $!;
1794        close $fd or croak $!;
1795        chmod ($mode &~ umask, $file) if (defined $mode);
1796}
1797
1798sub file_to_s {
1799        my $file = shift;
1800        open my $fd,'<',$file or croak "$!: file: $file\n";
1801        local $/;
1802        my $ret = <$fd>;
1803        close $fd or croak $!;
1804        $ret =~ s/\s*$//s;
1805        return $ret;
1806}
1807
1808# '<svn username> = real-name <email address>' mapping based on git-svnimport:
1809sub load_authors {
1810        open my $authors, '<', $_authors or die "Can't open $_authors $!\n";
1811        my $log = $cmd eq 'log';
1812        while (<$authors>) {
1813                chomp;
1814                next unless /^(.+?|\(no author\))\s*=\s*(.+?)\s*<(.+)>\s*$/;
1815                my ($user, $name, $email) = ($1, $2, $3);
1816                if ($log) {
1817                        $Git::SVN::Log::rusers{"$name <$email>"} = $user;
1818                } else {
1819                        $users{$user} = [$name, $email];
1820                }
1821        }
1822        close $authors or croak $!;
1823}
1824
1825# convert GetOpt::Long specs for use by git-config
1826sub read_git_config {
1827        my $opts = shift;
1828        my @config_only;
1829        foreach my $o (keys %$opts) {
1830                # if we have mixedCase and a long option-only, then
1831                # it's a config-only variable that we don't need for
1832                # the command-line.
1833                push @config_only, $o if ($o =~ /[A-Z]/ && $o =~ /^[a-z]+$/i);
1834                my $v = $opts->{$o};
1835                my ($key) = ($o =~ /^([a-zA-Z\-]+)/);
1836                $key =~ s/-//g;
1837                my $arg = 'git config';
1838                $arg .= ' --int' if ($o =~ /[:=]i$/);
1839                $arg .= ' --bool' if ($o !~ /[:=][sfi]$/);
1840                if (ref $v eq 'ARRAY') {
1841                        chomp(my @tmp = `$arg --get-all svn.$key`);
1842                        @$v = @tmp if @tmp;
1843                } else {
1844                        chomp(my $tmp = `$arg --get svn.$key`);
1845                        if ($tmp && !($arg =~ / --bool/ && $tmp eq 'false')) {
1846                                $$v = $tmp;
1847                        }
1848                }
1849        }
1850        delete @$opts{@config_only} if @config_only;
1851}
1852
1853sub extract_metadata {
1854        my $id = shift or return (undef, undef, undef);
1855        my ($url, $rev, $uuid) = ($id =~ /^\s*git-svn-id:\s+(.*)\@(\d+)
1856                                                        \s([a-f\d\-]+)$/ix);
1857        if (!defined $rev || !$uuid || !$url) {
1858                # some of the original repositories I made had
1859                # identifiers like this:
1860                ($rev, $uuid) = ($id =~/^\s*git-svn-id:\s(\d+)\@([a-f\d\-]+)/i);
1861        }
1862        return ($url, $rev, $uuid);
1863}
1864
1865sub cmt_metadata {
1866        return extract_metadata((grep(/^git-svn-id: /,
1867                command(qw/cat-file commit/, shift)))[-1]);
1868}
1869
1870sub cmt_sha2rev_batch {
1871        my %s2r;
1872        my ($pid, $in, $out, $ctx) = command_bidi_pipe(qw/cat-file --batch/);
1873        my $list = shift;
1874
1875        foreach my $sha (@{$list}) {
1876                my $first = 1;
1877                my $size = 0;
1878                print $out $sha, "\n";
1879
1880                while (my $line = <$in>) {
1881                        if ($first && $line =~ /^[[:xdigit:]]{40}\smissing$/) {
1882                                last;
1883                        } elsif ($first &&
1884                               $line =~ /^[[:xdigit:]]{40}\scommit\s(\d+)$/) {
1885                                $first = 0;
1886                                $size = $1;
1887                                next;
1888                        } elsif ($line =~ /^(git-svn-id: )/) {
1889                                my (undef, $rev, undef) =
1890                                                      extract_metadata($line);
1891                                $s2r{$sha} = $rev;
1892                        }
1893
1894                        $size -= length($line);
1895                        last if ($size == 0);
1896                }
1897        }
1898
1899        command_close_bidi_pipe($pid, $in, $out, $ctx);
1900
1901        return \%s2r;
1902}
1903
1904sub working_head_info {
1905        my ($head, $refs) = @_;
1906        my @args = qw/rev-list --first-parent --pretty=medium/;
1907        my ($fh, $ctx) = command_output_pipe(@args, $head);
1908        my $hash;
1909        my %max;
1910        while (<$fh>) {
1911                if ( m{^commit ($::sha1)$} ) {
1912                        unshift @$refs, $hash if $hash and $refs;
1913                        $hash = $1;
1914                        next;
1915                }
1916                next unless s{^\s*(git-svn-id:)}{$1};
1917                my ($url, $rev, $uuid) = extract_metadata($_);
1918                if (defined $url && defined $rev) {
1919                        next if $max{$url} and $max{$url} < $rev;
1920                        if (my $gs = Git::SVN->find_by_url($url)) {
1921                                my $c = $gs->rev_map_get($rev, $uuid);
1922                                if ($c && $c eq $hash) {
1923                                        close $fh; # break the pipe
1924                                        return ($url, $rev, $uuid, $gs);
1925                                } else {
1926                                        $max{$url} ||= $gs->rev_map_max;
1927                                }
1928                        }
1929                }
1930        }
1931        command_close_pipe($fh, $ctx);
1932        (undef, undef, undef, undef);
1933}
1934
1935sub read_commit_parents {
1936        my ($parents, $c) = @_;
1937        chomp(my $p = command_oneline(qw/rev-list --parents -1/, $c));
1938        $p =~ s/^($c)\s*// or die "rev-list --parents -1 $c failed!\n";
1939        @{$parents->{$c}} = split(/ /, $p);
1940}
1941
1942sub linearize_history {
1943        my ($gs, $refs) = @_;
1944        my %parents;
1945        foreach my $c (@$refs) {
1946                read_commit_parents(\%parents, $c);
1947        }
1948
1949        my @linear_refs;
1950        my %skip = ();
1951        my $last_svn_commit = $gs->last_commit;
1952        foreach my $c (reverse @$refs) {
1953                next if $c eq $last_svn_commit;
1954                last if $skip{$c};
1955
1956                unshift @linear_refs, $c;
1957                $skip{$c} = 1;
1958
1959                # we only want the first parent to diff against for linear
1960                # history, we save the rest to inject when we finalize the
1961                # svn commit
1962                my $fp_a = verify_ref("$c~1");
1963                my $fp_b = shift @{$parents{$c}} if $parents{$c};
1964                if (!$fp_a || !$fp_b) {
1965                        die "Commit $c\n",
1966                            "has no parent commit, and therefore ",
1967                            "nothing to diff against.\n",
1968                            "You should be working from a repository ",
1969                            "originally created by git-svn\n";
1970                }
1971                if ($fp_a ne $fp_b) {
1972                        die "$c~1 = $fp_a, however parsing commit $c ",
1973                            "revealed that:\n$c~1 = $fp_b\nBUG!\n";
1974                }
1975
1976                foreach my $p (@{$parents{$c}}) {
1977                        $skip{$p} = 1;
1978                }
1979        }
1980        (\@linear_refs, \%parents);
1981}
1982
1983sub find_file_type_and_diff_status {
1984        my ($path) = @_;
1985        return ('dir', '') if $path eq '';
1986
1987        my $diff_output =
1988            command_oneline(qw(diff --cached --name-status --), $path) || "";
1989        my $diff_status = (split(' ', $diff_output))[0] || "";
1990
1991        my $ls_tree = command_oneline(qw(ls-tree HEAD), $path) || "";
1992
1993        return (undef, undef) if !$diff_status && !$ls_tree;
1994
1995        if ($diff_status eq "A") {
1996                return ("link", $diff_status) if -l $path;
1997                return ("dir", $diff_status) if -d $path;
1998                return ("file", $diff_status);
1999        }
2000
2001        my $mode = (split(' ', $ls_tree))[0] || "";
2002
2003        return ("link", $diff_status) if $mode eq "120000";
2004        return ("dir", $diff_status) if $mode eq "040000";
2005        return ("file", $diff_status);
2006}
2007
2008sub md5sum {
2009        my $arg = shift;
2010        my $ref = ref $arg;
2011        my $md5 = Digest::MD5->new();
2012        if ($ref eq 'GLOB' || $ref eq 'IO::File' || $ref eq 'File::Temp') {
2013                $md5->addfile($arg) or croak $!;
2014        } elsif ($ref eq 'SCALAR') {
2015                $md5->add($$arg) or croak $!;
2016        } elsif (!$ref) {
2017                $md5->add($arg) or croak $!;
2018        } else {
2019                fatal "Can't provide MD5 hash for unknown ref type: '", $ref, "'";
2020        }
2021        return $md5->hexdigest();
2022}
2023
2024sub gc_directory {
2025        if (can_compress() && -f $_ && basename($_) eq "unhandled.log") {
2026                my $out_filename = $_ . ".gz";
2027                open my $in_fh, "<", $_ or die "Unable to open $_: $!\n";
2028                binmode $in_fh;
2029                my $gz = Compress::Zlib::gzopen($out_filename, "ab") or
2030                                die "Unable to open $out_filename: $!\n";
2031
2032                my $res;
2033                while ($res = sysread($in_fh, my $str, 1024)) {
2034                        $gz->gzwrite($str) or
2035                                die "Unable to write: ".$gz->gzerror()."!\n";
2036                }
2037                unlink $_ or die "unlink $File::Find::name: $!\n";
2038        } elsif (-f $_ && basename($_) eq "index") {
2039                unlink $_ or die "unlink $_: $!\n";
2040        }
2041}
2042
2043
2044package Git::SVN::Migration;
2045# these version numbers do NOT correspond to actual version numbers
2046# of git nor git-svn.  They are just relative.
2047#
2048# v0 layout: .git/$id/info/url, refs/heads/$id-HEAD
2049#
2050# v1 layout: .git/$id/info/url, refs/remotes/$id
2051#
2052# v2 layout: .git/svn/$id/info/url, refs/remotes/$id
2053#
2054# v3 layout: .git/svn/$id, refs/remotes/$id
2055#            - info/url may remain for backwards compatibility
2056#            - this is what we migrate up to this layout automatically,
2057#            - this will be used by git svn init on single branches
2058# v3.1 layout (auto migrated):
2059#            - .rev_db => .rev_db.$UUID, .rev_db will remain as a symlink
2060#              for backwards compatibility
2061#
2062# v4 layout: .git/svn/$repo_id/$id, refs/remotes/$repo_id/$id
2063#            - this is only created for newly multi-init-ed
2064#              repositories.  Similar in spirit to the
2065#              --use-separate-remotes option in git-clone (now default)
2066#            - we do not automatically migrate to this (following
2067#              the example set by core git)
2068#
2069# v5 layout: .rev_db.$UUID => .rev_map.$UUID
2070#            - newer, more-efficient format that uses 24-bytes per record
2071#              with no filler space.
2072#            - use xxd -c24 < .rev_map.$UUID to view and debug
2073#            - This is a one-way migration, repositories updated to the
2074#              new format will not be able to use old git-svn without
2075#              rebuilding the .rev_db.  Rebuilding the rev_db is not
2076#              possible if noMetadata or useSvmProps are set; but should
2077#              be no problem for users that use the (sensible) defaults.
2078use strict;
2079use warnings;
2080use Carp qw/croak/;
2081use File::Path qw/mkpath/;
2082use File::Basename qw/dirname basename/;
2083
2084our $_minimize;
2085use Git qw(
2086        command
2087        command_noisy
2088        command_output_pipe
2089        command_close_pipe
2090);
2091
2092sub migrate_from_v0 {
2093        my $git_dir = $ENV{GIT_DIR};
2094        return undef unless -d $git_dir;
2095        my ($fh, $ctx) = command_output_pipe(qw/rev-parse --symbolic --all/);
2096        my $migrated = 0;
2097        while (<$fh>) {
2098                chomp;
2099                my ($id, $orig_ref) = ($_, $_);
2100                next unless $id =~ s#^refs/heads/(.+)-HEAD$#$1#;
2101                next unless -f "$git_dir/$id/info/url";
2102                my $new_ref = "refs/remotes/$id";
2103                if (::verify_ref("$new_ref^0")) {
2104                        print STDERR "W: $orig_ref is probably an old ",
2105                                     "branch used by an ancient version of ",
2106                                     "git-svn.\n",
2107                                     "However, $new_ref also exists.\n",
2108                                     "We will not be able ",
2109                                     "to use this branch until this ",
2110                                     "ambiguity is resolved.\n";
2111                        next;
2112                }
2113                print STDERR "Migrating from v0 layout...\n" if !$migrated;
2114                print STDERR "Renaming ref: $orig_ref => $new_ref\n";
2115                command_noisy('update-ref', $new_ref, $orig_ref);
2116                command_noisy('update-ref', '-d', $orig_ref, $orig_ref);
2117                $migrated++;
2118        }
2119        command_close_pipe($fh, $ctx);
2120        print STDERR "Done migrating from v0 layout...\n" if $migrated;
2121        $migrated;
2122}
2123
2124sub migrate_from_v1 {
2125        my $git_dir = $ENV{GIT_DIR};
2126        my $migrated = 0;
2127        return $migrated unless -d $git_dir;
2128        my $svn_dir = "$git_dir/svn";
2129
2130        # just in case somebody used 'svn' as their $id at some point...
2131        return $migrated if -d $svn_dir && ! -f "$svn_dir/info/url";
2132
2133        print STDERR "Migrating from a git-svn v1 layout...\n";
2134        mkpath([$svn_dir]);
2135        print STDERR "Data from a previous version of git-svn exists, but\n\t",
2136                     "$svn_dir\n\t(required for this version ",
2137                     "($::VERSION) of git-svn) does not exist.\n";
2138        my ($fh, $ctx) = command_output_pipe(qw/rev-parse --symbolic --all/);
2139        while (<$fh>) {
2140                my $x = $_;
2141                next unless $x =~ s#^refs/remotes/##;
2142                chomp $x;
2143                next unless -f "$git_dir/$x/info/url";
2144                my $u = eval { ::file_to_s("$git_dir/$x/info/url") };
2145                next unless $u;
2146                my $dn = dirname("$git_dir/svn/$x");
2147                mkpath([$dn]) unless -d $dn;
2148                if ($x eq 'svn') { # they used 'svn' as GIT_SVN_ID:
2149                        mkpath(["$git_dir/svn/svn"]);
2150                        print STDERR " - $git_dir/$x/info => ",
2151                                        "$git_dir/svn/$x/info\n";
2152                        rename "$git_dir/$x/info", "$git_dir/svn/$x/info" or
2153                               croak "$!: $x";
2154                        # don't worry too much about these, they probably
2155                        # don't exist with repos this old (save for index,
2156                        # and we can easily regenerate that)
2157                        foreach my $f (qw/unhandled.log index .rev_db/) {
2158                                rename "$git_dir/$x/$f", "$git_dir/svn/$x/$f";
2159                        }
2160                } else {
2161                        print STDERR " - $git_dir/$x => $git_dir/svn/$x\n";
2162                        rename "$git_dir/$x", "$git_dir/svn/$x" or
2163                               croak "$!: $x";
2164                }
2165                $migrated++;
2166        }
2167        command_close_pipe($fh, $ctx);
2168        print STDERR "Done migrating from a git-svn v1 layout\n";
2169        $migrated;
2170}
2171
2172sub read_old_urls {
2173        my ($l_map, $pfx, $path) = @_;
2174        my @dir;
2175        foreach (<$path/*>) {
2176                if (-r "$_/info/url") {
2177                        $pfx .= '/' if $pfx && $pfx !~ m!/$!;
2178                        my $ref_id = $pfx . basename $_;
2179                        my $url = ::file_to_s("$_/info/url");
2180                        $l_map->{$ref_id} = $url;
2181                } elsif (-d $_) {
2182                        push @dir, $_;
2183                }
2184        }
2185        foreach (@dir) {
2186                my $x = $_;
2187                $x =~ s!^\Q$ENV{GIT_DIR}\E/svn/!!o;
2188                read_old_urls($l_map, $x, $_);
2189        }
2190}
2191
2192sub migrate_from_v2 {
2193        my @cfg = command(qw/config -l/);
2194        return if grep /^svn-remote\..+\.url=/, @cfg;
2195        my %l_map;
2196        read_old_urls(\%l_map, '', "$ENV{GIT_DIR}/svn");
2197        my $migrated = 0;
2198
2199        require Git::SVN;
2200        foreach my $ref_id (sort keys %l_map) {
2201                eval { Git::SVN->init($l_map{$ref_id}, '', undef, $ref_id) };
2202                if ($@) {
2203                        Git::SVN->init($l_map{$ref_id}, '', $ref_id, $ref_id);
2204                }
2205                $migrated++;
2206        }
2207        $migrated;
2208}
2209
2210sub minimize_connections {
2211        require Git::SVN;
2212        require Git::SVN::Ra;
2213
2214        my $r = Git::SVN::read_all_remotes();
2215        my $new_urls = {};
2216        my $root_repos = {};
2217        foreach my $repo_id (keys %$r) {
2218                my $url = $r->{$repo_id}->{url} or next;
2219                my $fetch = $r->{$repo_id}->{fetch} or next;
2220                my $ra = Git::SVN::Ra->new($url);
2221
2222                # skip existing cases where we already connect to the root
2223                if (($ra->{url} eq $ra->{repos_root}) ||
2224                    ($ra->{repos_root} eq $repo_id)) {
2225                        $root_repos->{$ra->{url}} = $repo_id;
2226                        next;
2227                }
2228
2229                my $root_ra = Git::SVN::Ra->new($ra->{repos_root});
2230                my $root_path = $ra->{url};
2231                $root_path =~ s#^\Q$ra->{repos_root}\E(/|$)##;
2232                foreach my $path (keys %$fetch) {
2233                        my $ref_id = $fetch->{$path};
2234                        my $gs = Git::SVN->new($ref_id, $repo_id, $path);
2235
2236                        # make sure we can read when connecting to
2237                        # a higher level of a repository
2238                        my ($last_rev, undef) = $gs->last_rev_commit;
2239                        if (!defined $last_rev) {
2240                                $last_rev = eval {
2241                                        $root_ra->get_latest_revnum;
2242                                };
2243                                next if $@;
2244                        }
2245                        my $new = $root_path;
2246                        $new .= length $path ? "/$path" : '';
2247                        eval {
2248                                $root_ra->get_log([$new], $last_rev, $last_rev,
2249                                                  0, 0, 1, sub { });
2250                        };
2251                        next if $@;
2252                        $new_urls->{$ra->{repos_root}}->{$new} =
2253                                { ref_id => $ref_id,
2254                                  old_repo_id => $repo_id,
2255                                  old_path => $path };
2256                }
2257        }
2258
2259        my @emptied;
2260        foreach my $url (keys %$new_urls) {
2261                # see if we can re-use an existing [svn-remote "repo_id"]
2262                # instead of creating a(n ugly) new section:
2263                my $repo_id = $root_repos->{$url} || $url;
2264
2265                my $fetch = $new_urls->{$url};
2266                foreach my $path (keys %$fetch) {
2267                        my $x = $fetch->{$path};
2268                        Git::SVN->init($url, $path, $repo_id, $x->{ref_id});
2269                        my $pfx = "svn-remote.$x->{old_repo_id}";
2270
2271                        my $old_fetch = quotemeta("$x->{old_path}:".
2272                                                  "$x->{ref_id}");
2273                        command_noisy(qw/config --unset/,
2274                                      "$pfx.fetch", '^'. $old_fetch . '$');
2275                        delete $r->{$x->{old_repo_id}}->
2276                               {fetch}->{$x->{old_path}};
2277                        if (!keys %{$r->{$x->{old_repo_id}}->{fetch}}) {
2278                                command_noisy(qw/config --unset/,
2279                                              "$pfx.url");
2280                                push @emptied, $x->{old_repo_id}
2281                        }
2282                }
2283        }
2284        if (@emptied) {
2285                my $file = $ENV{GIT_CONFIG} || "$ENV{GIT_DIR}/config";
2286                print STDERR <<EOF;
2287The following [svn-remote] sections in your config file ($file) are empty
2288and can be safely removed:
2289EOF
2290                print STDERR "[svn-remote \"$_\"]\n" foreach @emptied;
2291        }
2292}
2293
2294sub migration_check {
2295        migrate_from_v0();
2296        migrate_from_v1();
2297        migrate_from_v2();
2298        minimize_connections() if $_minimize;
2299}
2300
2301package Git::IndexInfo;
2302use strict;
2303use warnings;
2304use Git qw/command_input_pipe command_close_pipe/;
2305
2306sub new {
2307        my ($class) = @_;
2308        my ($gui, $ctx) = command_input_pipe(qw/update-index -z --index-info/);
2309        bless { gui => $gui, ctx => $ctx, nr => 0}, $class;
2310}
2311
2312sub remove {
2313        my ($self, $path) = @_;
2314        if (print { $self->{gui} } '0 ', 0 x 40, "\t", $path, "\0") {
2315                return ++$self->{nr};
2316        }
2317        undef;
2318}
2319
2320sub update {
2321        my ($self, $mode, $hash, $path) = @_;
2322        if (print { $self->{gui} } $mode, ' ', $hash, "\t", $path, "\0") {
2323                return ++$self->{nr};
2324        }
2325        undef;
2326}
2327
2328sub DESTROY {
2329        my ($self) = @_;
2330        command_close_pipe($self->{gui}, $self->{ctx});
2331}
2332
2333package Git::SVN::GlobSpec;
2334use strict;
2335use warnings;
2336
2337sub new {
2338        my ($class, $glob, $pattern_ok) = @_;
2339        my $re = $glob;
2340        $re =~ s!/+$!!g; # no need for trailing slashes
2341        my (@left, @right, @patterns);
2342        my $state = "left";
2343        my $die_msg = "Only one set of wildcard directories " .
2344                                "(e.g. '*' or '*/*/*') is supported: '$glob'\n";
2345        for my $part (split(m|/|, $glob)) {
2346                if ($part =~ /\*/ && $part ne "*") {
2347                        die "Invalid pattern in '$glob': $part\n";
2348                } elsif ($pattern_ok && $part =~ /[{}]/ &&
2349                         $part !~ /^\{[^{}]+\}/) {
2350                        die "Invalid pattern in '$glob': $part\n";
2351                }
2352                if ($part eq "*") {
2353                        die $die_msg if $state eq "right";
2354                        $state = "pattern";
2355                        push(@patterns, "[^/]*");
2356                } elsif ($pattern_ok && $part =~ /^\{(.*)\}$/) {
2357                        die $die_msg if $state eq "right";
2358                        $state = "pattern";
2359                        my $p = quotemeta($1);
2360                        $p =~ s/\\,/|/g;
2361                        push(@patterns, "(?:$p)");
2362                } else {
2363                        if ($state eq "left") {
2364                                push(@left, $part);
2365                        } else {
2366                                push(@right, $part);
2367                                $state = "right";
2368                        }
2369                }
2370        }
2371        my $depth = @patterns;
2372        if ($depth == 0) {
2373                die "One '*' is needed in glob: '$glob'\n";
2374        }
2375        my $left = join('/', @left);
2376        my $right = join('/', @right);
2377        $re = join('/', @patterns);
2378        $re = join('\/',
2379                   grep(length, quotemeta($left), "($re)", quotemeta($right)));
2380        my $left_re = qr/^\/\Q$left\E(\/|$)/;
2381        bless { left => $left, right => $right, left_regex => $left_re,
2382                regex => qr/$re/, glob => $glob, depth => $depth }, $class;
2383}
2384
2385sub full_path {
2386        my ($self, $path) = @_;
2387        return (length $self->{left} ? "$self->{left}/" : '') .
2388               $path . (length $self->{right} ? "/$self->{right}" : '');
2389}
2390
2391__END__
2392
2393Data structures:
2394
2395
2396$remotes = { # returned by read_all_remotes()
2397        'svn' => {
2398                # svn-remote.svn.url=https://svn.musicpd.org
2399                url => 'https://svn.musicpd.org',
2400                # svn-remote.svn.fetch=mpd/trunk:trunk
2401                fetch => {
2402                        'mpd/trunk' => 'trunk',
2403                },
2404                # svn-remote.svn.tags=mpd/tags/*:tags/*
2405                tags => {
2406                        path => {
2407                                left => 'mpd/tags',
2408                                right => '',
2409                                regex => qr!mpd/tags/([^/]+)$!,
2410                                glob => 'tags/*',
2411                        },
2412                        ref => {
2413                                left => 'tags',
2414                                right => '',
2415                                regex => qr!tags/([^/]+)$!,
2416                                glob => 'tags/*',
2417                        },
2418                }
2419        }
2420};
2421
2422$log_entry hashref as returned by libsvn_log_entry()
2423{
2424        log => 'whitespace-formatted log entry
2425',                                              # trailing newline is preserved
2426        revision => '8',                        # integer
2427        date => '2004-02-24T17:01:44.108345Z',  # commit date
2428        author => 'committer name'
2429};
2430
2431
2432# this is generated by generate_diff();
2433@mods = array of diff-index line hashes, each element represents one line
2434        of diff-index output
2435
2436diff-index line ($m hash)
2437{
2438        mode_a => first column of diff-index output, no leading ':',
2439        mode_b => second column of diff-index output,
2440        sha1_b => sha1sum of the final blob,
2441        chg => change type [MCRADT],
2442        file_a => original file name of a file (iff chg is 'C' or 'R')
2443        file_b => new/current file name of a file (any chg)
2444}
2445;
2446
2447# retval of read_url_paths{,_all}();
2448$l_map = {
2449        # repository root url
2450        'https://svn.musicpd.org' => {
2451                # repository path               # GIT_SVN_ID
2452                'mpd/trunk'             =>      'trunk',
2453                'mpd/tags/0.11.5'       =>      'tags/0.11.5',
2454        },
2455}
2456
2457Notes:
2458        I don't trust the each() function on unless I created %hash myself
2459        because the internal iterator may not have started at base.