git-svn: save a little memory as fetch progresses
[git] / perl / Git / SVN / Ra.pm
1 package Git::SVN::Ra;
2 use vars qw/@ISA $config_dir $_ignore_refs_regex $_log_window_size/;
3 use strict;
4 use warnings;
5 use SVN::Client;
6 use Git::SVN::Utils qw(
7         canonicalize_url
8         canonicalize_path
9         add_path_to_url
10 );
11
12 use SVN::Ra;
13 BEGIN {
14         @ISA = qw(SVN::Ra);
15 }
16
17 my ($ra_invalid, $can_do_switch, %ignored_err, $RA);
18
19 BEGIN {
20         # enforce temporary pool usage for some simple functions
21         no strict 'refs';
22         for my $f (qw/rev_proplist get_latest_revnum get_uuid get_repos_root
23                       get_file/) {
24                 my $SUPER = "SUPER::$f";
25                 *$f = sub {
26                         my $self = shift;
27                         my $pool = SVN::Pool->new;
28                         my @ret = $self->$SUPER(@_,$pool);
29                         $pool->clear;
30                         wantarray ? @ret : $ret[0];
31                 };
32         }
33 }
34
35 # serf has a bug that leads to a coredump upon termination if the
36 # remote access object is left around (not fixed yet in serf 1.3.1).
37 # Explicitly free it to work around the issue.
38 END {
39         $RA = undef;
40         $ra_invalid = 1;
41 }
42
43 sub _auth_providers () {
44         my @rv = (
45           SVN::Client::get_simple_provider(),
46           SVN::Client::get_ssl_server_trust_file_provider(),
47           SVN::Client::get_simple_prompt_provider(
48             \&Git::SVN::Prompt::simple, 2),
49           SVN::Client::get_ssl_client_cert_file_provider(),
50           SVN::Client::get_ssl_client_cert_prompt_provider(
51             \&Git::SVN::Prompt::ssl_client_cert, 2),
52           SVN::Client::get_ssl_client_cert_pw_file_provider(),
53           SVN::Client::get_ssl_client_cert_pw_prompt_provider(
54             \&Git::SVN::Prompt::ssl_client_cert_pw, 2),
55           SVN::Client::get_username_provider(),
56           SVN::Client::get_ssl_server_trust_prompt_provider(
57             \&Git::SVN::Prompt::ssl_server_trust),
58           SVN::Client::get_username_prompt_provider(
59             \&Git::SVN::Prompt::username, 2)
60         );
61
62         # earlier 1.6.x versions would segfault, and <= 1.5.x didn't have
63         # this function
64         if (::compare_svn_version('1.6.15') >= 0) {
65                 my $config = SVN::Core::config_get_config($config_dir);
66                 my ($p, @a);
67                 # config_get_config returns all config files from
68                 # ~/.subversion, auth_get_platform_specific_client_providers
69                 # just wants the config "file".
70                 @a = ($config->{'config'}, undef);
71                 $p = SVN::Core::auth_get_platform_specific_client_providers(@a);
72                 # Insert the return value from
73                 # auth_get_platform_specific_providers
74                 unshift @rv, @$p;
75         }
76         \@rv;
77 }
78
79
80 sub new {
81         my ($class, $url) = @_;
82         $url = canonicalize_url($url);
83         return $RA if ($RA && $RA->url eq $url);
84
85         ::_req_svn();
86
87         SVN::_Core::svn_config_ensure($config_dir, undef);
88         my ($baton, $callbacks) = SVN::Core::auth_open_helper(_auth_providers);
89         my $config = SVN::Core::config_get_config($config_dir);
90         $RA = undef;
91         my $dont_store_passwords = 1;
92         my $conf_t = ${$config}{'config'};
93         {
94                 no warnings 'once';
95                 # The usage of $SVN::_Core::SVN_CONFIG_* variables
96                 # produces warnings that variables are used only once.
97                 # I had not found the better way to shut them up, so
98                 # the warnings of type 'once' are disabled in this block.
99                 if (SVN::_Core::svn_config_get_bool($conf_t,
100                     $SVN::_Core::SVN_CONFIG_SECTION_AUTH,
101                     $SVN::_Core::SVN_CONFIG_OPTION_STORE_PASSWORDS,
102                     1) == 0) {
103                         SVN::_Core::svn_auth_set_parameter($baton,
104                             $SVN::_Core::SVN_AUTH_PARAM_DONT_STORE_PASSWORDS,
105                             bless (\$dont_store_passwords, "_p_void"));
106                 }
107                 if (SVN::_Core::svn_config_get_bool($conf_t,
108                     $SVN::_Core::SVN_CONFIG_SECTION_AUTH,
109                     $SVN::_Core::SVN_CONFIG_OPTION_STORE_AUTH_CREDS,
110                     1) == 0) {
111                         $Git::SVN::Prompt::_no_auth_cache = 1;
112                 }
113         } # no warnings 'once'
114
115         my $self = SVN::Ra->new(url => $url, auth => $baton,
116                               config => $config,
117                               pool => SVN::Pool->new,
118                               auth_provider_callbacks => $callbacks);
119         $RA = bless $self, $class;
120
121         # Make sure its canonicalized
122         $self->url($url);
123         $self->{svn_path} = $url;
124         $self->{repos_root} = $self->get_repos_root;
125         $self->{svn_path} =~ s#^\Q$self->{repos_root}\E(/|$)##;
126         $self->{cache} = { check_path => { r => 0, data => {} },
127                            get_dir => { r => 0, data => {} } };
128
129         return $RA;
130 }
131
132 sub url {
133         my $self = shift;
134
135         if (@_) {
136                 my $url = shift;
137                 $self->{url} = canonicalize_url($url);
138                 return;
139         }
140
141         return $self->{url};
142 }
143
144 sub check_path {
145         my ($self, $path, $r) = @_;
146         my $cache = $self->{cache}->{check_path};
147         if ($r == $cache->{r} && exists $cache->{data}->{$path}) {
148                 return $cache->{data}->{$path};
149         }
150         my $pool = SVN::Pool->new;
151         my $t = $self->SUPER::check_path($path, $r, $pool);
152         $pool->clear;
153         if ($r != $cache->{r}) {
154                 %{$cache->{data}} = ();
155                 $cache->{r} = $r;
156         }
157         $cache->{data}->{$path} = $t;
158 }
159
160 sub get_dir {
161         my ($self, $dir, $r) = @_;
162         my $cache = $self->{cache}->{get_dir};
163         if ($r == $cache->{r}) {
164                 if (my $x = $cache->{data}->{$dir}) {
165                         return wantarray ? @$x : $x->[0];
166                 }
167         }
168         my $pool = SVN::Pool->new;
169         my ($d, undef, $props) = $self->SUPER::get_dir($dir, $r, $pool);
170         my %dirents = map { $_ => { kind => $d->{$_}->kind } } keys %$d;
171         $pool->clear;
172         if ($r != $cache->{r}) {
173                 %{$cache->{data}} = ();
174                 $cache->{r} = $r;
175         }
176         $cache->{data}->{$dir} = [ \%dirents, $r, $props ];
177         wantarray ? (\%dirents, $r, $props) : \%dirents;
178 }
179
180 # get_log(paths, start, end, limit,
181 #         discover_changed_paths, strict_node_history, receiver)
182 sub get_log {
183         my ($self, @args) = @_;
184         my $pool = SVN::Pool->new;
185
186         # svn_log_changed_path_t objects passed to get_log are likely to be
187         # overwritten even if only the refs are copied to an external variable,
188         # so we should dup the structures in their entirety.  Using an
189         # externally passed pool (instead of our temporary and quickly cleared
190         # pool in Git::SVN::Ra) does not help matters at all...
191         my $receiver = pop @args;
192         my $prefix = "/".$self->{svn_path};
193         $prefix =~ s#/+($)##;
194         my $prefix_regex = qr#^\Q$prefix\E#;
195         push(@args, sub {
196                 my ($paths) = $_[0];
197                 return &$receiver(@_) unless $paths;
198                 $_[0] = ();
199                 foreach my $p (keys %$paths) {
200                         my $i = $paths->{$p};
201                         # Make path relative to our url, not repos_root
202                         $p =~ s/$prefix_regex//;
203                         my %s = map { $_ => $i->$_; }
204                                 qw/copyfrom_path copyfrom_rev action/;
205                         if ($s{'copyfrom_path'}) {
206                                 $s{'copyfrom_path'} =~ s/$prefix_regex//;
207                                 $s{'copyfrom_path'} = canonicalize_path($s{'copyfrom_path'});
208                         }
209                         $_[0]{$p} = \%s;
210                 }
211                 &$receiver(@_);
212         });
213
214
215         # the limit parameter was not supported in SVN 1.1.x, so we
216         # drop it.  Therefore, the receiver callback passed to it
217         # is made aware of this limitation by being wrapped if
218         # the limit passed to is being wrapped.
219         if (::compare_svn_version('1.2.0') <= 0) {
220                 my $limit = splice(@args, 3, 1);
221                 if ($limit > 0) {
222                         my $receiver = pop @args;
223                         push(@args, sub { &$receiver(@_) if (--$limit >= 0) });
224                 }
225         }
226         my $ret = $self->SUPER::get_log(@args, $pool);
227         $pool->clear;
228         $ret;
229 }
230
231 sub trees_match {
232         my ($self, $url1, $rev1, $url2, $rev2) = @_;
233         my $ctx = SVN::Client->new(auth => _auth_providers);
234         my $out = IO::File->new_tmpfile;
235
236         # older SVN (1.1.x) doesn't take $pool as the last parameter for
237         # $ctx->diff(), so we'll create a default one
238         my $pool = SVN::Pool->new_default_sub;
239
240         $ra_invalid = 1; # this will open a new SVN::Ra connection to $url1
241         $ctx->diff([], $url1, $rev1, $url2, $rev2, 1, 1, 0, $out, $out);
242         $out->flush;
243         my $ret = (($out->stat)[7] == 0);
244         close $out or croak $!;
245
246         $ret;
247 }
248
249 sub get_commit_editor {
250         my ($self, $log, $cb, $pool) = @_;
251
252         my @lock = (::compare_svn_version('1.2.0') >= 0) ? (undef, 0) : ();
253         $self->SUPER::get_commit_editor($log, $cb, @lock, $pool);
254 }
255
256 sub gs_do_update {
257         my ($self, $rev_a, $rev_b, $gs, $editor) = @_;
258         my $new = ($rev_a == $rev_b);
259         my $path = $gs->path;
260
261         if ($new && -e $gs->{index}) {
262                 unlink $gs->{index} or die
263                   "Couldn't unlink index: $gs->{index}: $!\n";
264         }
265         my $pool = SVN::Pool->new;
266         $editor->set_path_strip($path);
267         my (@pc) = split m#/#, $path;
268         my $reporter = $self->do_update($rev_b, (@pc ? shift @pc : ''),
269                                         1, $editor, $pool);
270         my @lock = (::compare_svn_version('1.2.0') >= 0) ? (undef) : ();
271
272         # Since we can't rely on svn_ra_reparent being available, we'll
273         # just have to do some magic with set_path to make it so
274         # we only want a partial path.
275         my $sp = '';
276         my $final = join('/', @pc);
277         while (@pc) {
278                 $reporter->set_path($sp, $rev_b, 0, @lock, $pool);
279                 $sp .= '/' if length $sp;
280                 $sp .= shift @pc;
281         }
282         die "BUG: '$sp' != '$final'\n" if ($sp ne $final);
283
284         $reporter->set_path($sp, $rev_a, $new, @lock, $pool);
285
286         $reporter->finish_report($pool);
287         $pool->clear;
288         $editor->{git_commit_ok};
289 }
290
291 # this requires SVN 1.4.3 or later (do_switch didn't work before 1.4.3, and
292 # svn_ra_reparent didn't work before 1.4)
293 sub gs_do_switch {
294         my ($self, $rev_a, $rev_b, $gs, $url_b, $editor) = @_;
295         my $path = $gs->path;
296         my $pool = SVN::Pool->new;
297
298         my $old_url = $self->url;
299         my $full_url = add_path_to_url( $self->url, $path );
300         my ($ra, $reparented);
301
302         if ($old_url =~ m#^svn(\+\w+)?://# ||
303             ($full_url =~ m#^https?://# &&
304              canonicalize_url($full_url) ne $full_url)) {
305                 $_[0] = undef;
306                 $self = undef;
307                 $RA = undef;
308                 $ra = Git::SVN::Ra->new($full_url);
309                 $ra_invalid = 1;
310         } elsif ($old_url ne $full_url) {
311                 SVN::_Ra::svn_ra_reparent(
312                         $self->{session},
313                         canonicalize_url($full_url),
314                         $pool
315                 );
316                 $self->url($full_url);
317                 $reparented = 1;
318         }
319
320         $ra ||= $self;
321         $url_b = canonicalize_url($url_b);
322         my $reporter = $ra->do_switch($rev_b, '', 1, $url_b, $editor, $pool);
323         my @lock = (::compare_svn_version('1.2.0') >= 0) ? (undef) : ();
324         $reporter->set_path('', $rev_a, 0, @lock, $pool);
325         $reporter->finish_report($pool);
326
327         if ($reparented) {
328                 SVN::_Ra::svn_ra_reparent($self->{session}, $old_url, $pool);
329                 $self->url($old_url);
330         }
331
332         $pool->clear;
333         $editor->{git_commit_ok};
334 }
335
336 sub longest_common_path {
337         my ($gsv, $globs) = @_;
338         my %common;
339         my $common_max = scalar @$gsv;
340
341         foreach my $gs (@$gsv) {
342                 my @tmp = split m#/#, $gs->path;
343                 my $p = '';
344                 foreach (@tmp) {
345                         $p .= length($p) ? "/$_" : $_;
346                         $common{$p} ||= 0;
347                         $common{$p}++;
348                 }
349         }
350         $globs ||= [];
351         $common_max += scalar @$globs;
352         foreach my $glob (@$globs) {
353                 my @tmp = split m#/#, $glob->{path}->{left};
354                 my $p = '';
355                 foreach (@tmp) {
356                         $p .= length($p) ? "/$_" : $_;
357                         $common{$p} ||= 0;
358                         $common{$p}++;
359                 }
360         }
361
362         my $longest_path = '';
363         foreach (sort {length $b <=> length $a} keys %common) {
364                 if ($common{$_} == $common_max) {
365                         $longest_path = $_;
366                         last;
367                 }
368         }
369         $longest_path;
370 }
371
372 sub gs_fetch_loop_common {
373         my ($self, $base, $head, $gsv, $globs) = @_;
374         return if ($base > $head);
375         my $gpool = SVN::Pool->new_default;
376         my $ra_url = $self->url;
377         my $reload_ra = sub {
378                 $_[0] = undef;
379                 $self = undef;
380                 $RA = undef;
381                 $gpool->clear;
382                 $self = Git::SVN::Ra->new($ra_url);
383                 $ra_invalid = undef;
384         };
385         my $inc = $_log_window_size;
386         my ($min, $max) = ($base, $head < $base + $inc ? $head : $base + $inc);
387         my $longest_path = longest_common_path($gsv, $globs);
388         my $find_trailing_edge;
389         while (1) {
390                 my %revs;
391                 my $err;
392                 my $err_handler = $SVN::Error::handler;
393                 $SVN::Error::handler = sub {
394                         ($err) = @_;
395                         skip_unknown_revs($err);
396                 };
397                 sub _cb {
398                         my ($paths, $r, $author, $date, $log) = @_;
399                         [ $paths,
400                           { author => $author, date => $date, log => $log } ];
401                 }
402                 $self->get_log([$longest_path], $min, $max, 0, 1, 1,
403                                sub { $revs{$_[1]} = _cb(@_) });
404                 if ($err) {
405                         print "Checked through r$max\r";
406                 } else {
407                         $find_trailing_edge = 1;
408                 }
409                 if ($err and $find_trailing_edge) {
410                         print STDERR "Path '$longest_path' ",
411                                      "was probably deleted:\n",
412                                      $err->expanded_message,
413                                      "\nWill attempt to follow ",
414                                      "revisions r$min .. r$max ",
415                                      "committed before the deletion\n";
416                         my $hi = $max;
417                         while (--$hi >= $min) {
418                                 my $ok;
419                                 $self->get_log([$longest_path], $min, $hi,
420                                                0, 1, 1, sub {
421                                                $ok = $_[1];
422                                                $revs{$_[1]} = _cb(@_) });
423                                 if ($ok) {
424                                         print STDERR "r$min .. r$ok OK\n";
425                                         last;
426                                 }
427                         }
428                         $find_trailing_edge = 0;
429                 }
430                 $SVN::Error::handler = $err_handler;
431
432                 my %exists = map { $_->path => $_ } @$gsv;
433                 foreach my $r (sort {$a <=> $b} keys %revs) {
434                         my ($paths, $logged) = @{delete $revs{$r}};
435
436                         foreach my $gs ($self->match_globs(\%exists, $paths,
437                                                            $globs, $r)) {
438                                 if ($gs->rev_map_max >= $r) {
439                                         next;
440                                 }
441                                 next unless $gs->match_paths($paths, $r);
442                                 $gs->{logged_rev_props} = $logged;
443                                 if (my $last_commit = $gs->last_commit) {
444                                         $gs->assert_index_clean($last_commit);
445                                 }
446                                 my $log_entry = $gs->do_fetch($paths, $r);
447                                 if ($log_entry) {
448                                         $gs->do_git_commit($log_entry);
449                                 }
450                                 $Git::SVN::INDEX_FILES{$gs->{index}} = 1;
451                         }
452                         foreach my $g (@$globs) {
453                                 my $k = "svn-remote.$g->{remote}." .
454                                         "$g->{t}-maxRev";
455                                 Git::SVN::tmp_config($k, $r);
456                         }
457                         $reload_ra->() if $ra_invalid;
458                 }
459                 # pre-fill the .rev_db since it'll eventually get filled in
460                 # with '0' x40 if something new gets committed
461                 foreach my $gs (@$gsv) {
462                         next if $gs->rev_map_max >= $max;
463                         next if defined $gs->rev_map_get($max);
464                         $gs->rev_map_set($max, 0 x40);
465                 }
466                 foreach my $g (@$globs) {
467                         my $k = "svn-remote.$g->{remote}.$g->{t}-maxRev";
468                         Git::SVN::tmp_config($k, $max);
469                 }
470                 last if $max >= $head;
471                 $min = $max + 1;
472                 $max += $inc;
473                 $max = $head if ($max > $head);
474
475                 $reload_ra->();
476         }
477         Git::SVN::gc();
478 }
479
480 sub get_dir_globbed {
481         my ($self, $left, $depth, $r) = @_;
482
483         my @x = eval { $self->get_dir($left, $r) };
484         return unless scalar @x == 3;
485         my $dirents = $x[0];
486         my @finalents;
487         foreach my $de (keys %$dirents) {
488                 next if $dirents->{$de}->{kind} != $SVN::Node::dir;
489                 if ($depth > 1) {
490                         my @args = ("$left/$de", $depth - 1, $r);
491                         foreach my $dir ($self->get_dir_globbed(@args)) {
492                                 push @finalents, "$de/$dir";
493                         }
494                 } else {
495                         push @finalents, $de;
496                 }
497         }
498         @finalents;
499 }
500
501 # return value: 0 -- don't ignore, 1 -- ignore
502 sub is_ref_ignored {
503         my ($g, $p) = @_;
504         my $refname = $g->{ref}->full_path($p);
505         return 1 if defined($g->{ignore_refs_regex}) &&
506                     $refname =~ m!$g->{ignore_refs_regex}!;
507         return 0 unless defined($_ignore_refs_regex);
508         return 1 if $refname =~ m!$_ignore_refs_regex!o;
509         return 0;
510 }
511
512 sub match_globs {
513         my ($self, $exists, $paths, $globs, $r) = @_;
514
515         sub get_dir_check {
516                 my ($self, $exists, $g, $r) = @_;
517
518                 my @dirs = $self->get_dir_globbed($g->{path}->{left},
519                                                   $g->{path}->{depth},
520                                                   $r);
521
522                 foreach my $de (@dirs) {
523                         my $p = $g->{path}->full_path($de);
524                         next if $exists->{$p};
525                         next if (length $g->{path}->{right} &&
526                                  ($self->check_path($p, $r) !=
527                                   $SVN::Node::dir));
528                         next unless $p =~ /$g->{path}->{regex}/;
529                         $exists->{$p} = Git::SVN->init($self->url, $p, undef,
530                                          $g->{ref}->full_path($de), 1);
531                 }
532         }
533         foreach my $g (@$globs) {
534                 if (my $path = $paths->{"/$g->{path}->{left}"}) {
535                         if ($path->{action} =~ /^[AR]$/) {
536                                 get_dir_check($self, $exists, $g, $r);
537                         }
538                 }
539                 foreach (keys %$paths) {
540                         if (/$g->{path}->{left_regex}/ &&
541                             !/$g->{path}->{regex}/) {
542                                 next if $paths->{$_}->{action} !~ /^[AR]$/;
543                                 get_dir_check($self, $exists, $g, $r);
544                         }
545                         next unless /$g->{path}->{regex}/;
546                         my $p = $1;
547                         my $pathname = $g->{path}->full_path($p);
548                         next if is_ref_ignored($g, $p);
549                         next if $exists->{$pathname};
550                         next if ($self->check_path($pathname, $r) !=
551                                  $SVN::Node::dir);
552                         $exists->{$pathname} = Git::SVN->init(
553                                               $self->url, $pathname, undef,
554                                               $g->{ref}->full_path($p), 1);
555                 }
556                 my $c = '';
557                 foreach (split m#/#, $g->{path}->{left}) {
558                         $c .= "/$_";
559                         next unless ($paths->{$c} &&
560                                      ($paths->{$c}->{action} =~ /^[AR]$/));
561                         get_dir_check($self, $exists, $g, $r);
562                 }
563         }
564         values %$exists;
565 }
566
567 sub minimize_url {
568         my ($self) = @_;
569         return $self->url if ($self->url eq $self->{repos_root});
570         my $url = $self->{repos_root};
571         my @components = split(m!/!, $self->{svn_path});
572         my $c = '';
573         do {
574                 $url = add_path_to_url($url, $c);
575                 eval {
576                         my $ra = (ref $self)->new($url);
577                         my $latest = $ra->get_latest_revnum;
578                         $ra->get_log("", $latest, 0, 1, 0, 1, sub {});
579                 };
580         } while ($@ && ($c = shift @components));
581
582         return canonicalize_url($url);
583 }
584
585 sub can_do_switch {
586         my $self = shift;
587         unless (defined $can_do_switch) {
588                 my $pool = SVN::Pool->new;
589                 my $rep = eval {
590                         $self->do_switch(1, '', 0, $self->url,
591                                          SVN::Delta::Editor->new, $pool);
592                 };
593                 if ($@) {
594                         $can_do_switch = 0;
595                 } else {
596                         $rep->abort_report($pool);
597                         $can_do_switch = 1;
598                 }
599                 $pool->clear;
600         }
601         $can_do_switch;
602 }
603
604 sub skip_unknown_revs {
605         my ($err) = @_;
606         my $errno = $err->apr_err();
607         # Maybe the branch we're tracking didn't
608         # exist when the repo started, so it's
609         # not an error if it doesn't, just continue
610         #
611         # Wonderfully consistent library, eh?
612         # 160013 - svn:// and file://
613         # 175002 - http(s)://
614         # 175007 - http(s):// (this repo required authorization, too...)
615         #   More codes may be discovered later...
616         if ($errno == 175007 || $errno == 175002 || $errno == 160013) {
617                 my $err_key = $err->expanded_message;
618                 # revision numbers change every time, filter them out
619                 $err_key =~ s/\d+/\0/g;
620                 $err_key = "$errno\0$err_key";
621                 unless ($ignored_err{$err_key}) {
622                         warn "W: Ignoring error from SVN, path probably ",
623                              "does not exist: ($errno): ",
624                              $err->expanded_message,"\n";
625                         warn "W: Do not be alarmed at the above message ",
626                              "git-svn is just searching aggressively for ",
627                              "old history.\n",
628                              "This may take a while on large repositories\n";
629                         $ignored_err{$err_key} = 1;
630                 }
631                 return;
632         }
633         die "Error from SVN, ($errno): ", $err->expanded_message,"\n";
634 }
635
636 1;
637 __END__
638
639 =head1 NAME
640
641 Git::SVN::Ra - Subversion remote access functions for git-svn
642
643 =head1 SYNOPSIS
644
645     use Git::SVN::Ra;
646
647     my $ra = Git::SVN::Ra->new($branchurl);
648     my ($dirents, $fetched_revnum, $props) =
649         $ra->get_dir('.', $SVN::Core::INVALID_REVNUM);
650
651 =head1 DESCRIPTION
652
653 This is a wrapper around the L<SVN::Ra> module for use by B<git-svn>.
654 It fills in some default parameters (such as the authentication
655 scheme), smooths over incompatibilities between libsvn versions, adds
656 caching, and implements some functions specific to B<git-svn>.
657
658 Do not use it unless you are developing git-svn.  The interface will
659 change as git-svn evolves.
660
661 =head1 DEPENDENCIES
662
663 Subversion perl bindings,
664 L<Git::SVN>.
665
666 C<Git::SVN::Ra> has not been tested using callers other than
667 B<git-svn> itself.
668
669 =head1 SEE ALSO
670
671 L<SVN::Ra>.
672
673 =head1 INCOMPATIBILITIES
674
675 None reported.
676
677 =head1 BUGS
678
679 None.