• NAME
• SYNOPSIS
• DESCRIPTION
• DEPENDENCIES
• SEE ALSO
• INCOMPATIBILITIES
• BUGS

NAME

Git::SVN::Fetcher - tree delta consumer for ``git svn fetch''

SYNOPSIS

    use SVN::Core;
    use SVN::Ra;
    use Git::SVN;
    use Git::SVN::Fetcher;
    use Git;

    my $gs = Git::SVN->find_by_url($url);
    my $ra = SVN::Ra->new(url => $url);
    my $editor = Git::SVN::Fetcher->new($gs);
    my $reporter = $ra->do_update($SVN::Core::INVALID_REVNUM, '',
                                  1, $editor);
    $reporter->set_path('', $old_rev, 0);
    $reporter->finish_report;
    my $tree = $gs->tmp_index_do(sub { command_oneline('write-tree') });

    foreach my $path (keys %{$editor->{dir_prop}) {
        my $props = $editor->{dir_prop}{$path};
        foreach my $prop (keys %$props) {
            print "property $prop at $path changed to $props->{$prop}\n";
        }
    }
    foreach my $path (keys %{$editor->{empty}) {
        my $action = $editor->{empty}{$path} ? 'added' : 'removed';
        print "empty directory $path $action\n";
    }
    foreach my $path (keys %{$editor->{file_prop}) { ... }
    foreach my $parent (keys %{$editor->{absent_dir}}) {
        my @children = @{$editor->{abstent_dir}{$parent}};
        print "cannot fetch directory $parent/$_: not authorized?\n"
            foreach @children;
    }
    foreach my $parent (keys %{$editor->{absent_file}) { ... }

DESCRIPTION

This is a subclass of SVN::Delta::Editor, which means it implements callbacks to act as a consumer of Subversion tree deltas. This particular implementation of those callbacks is meant to store information about the resulting content which git svn fetch could use to populate new commits and new entries for unhandled.log. More specifically:

• Additions, removals, and modifications of files are propagated to git-svn's index file F<$GIT_DIR/svn/$refname/index> using B.
  
• Changes in Subversion path properties are recorded in the C and C fields (which are hashes).
  
• Addition and removal of empty directories are indicated by entries with value 1 and 0 respectively in the C hash.
  
• Paths that are present but cannot be conveyed (presumably due to permissions) are recorded in the C and C hashes. For each key, the corresponding value is a list of paths under that directory that were present but could not be conveyed.
  

DEPENDENCIES

the SVN::Delta manpage from the Subversion perl bindings, the core Carp and the File::Basename manpage modules, and git's Git helper module.

Git::SVN::Fetcher has not been tested using callers other than git-svn itself.

SEE ALSO

the SVN::Delta manpage, the Git::SVN::Editor manpage.

INCOMPATIBILITIES

None reported.

BUGS

None.