git::svn::fetcher(3) [centos man page]

Git::SVN::Fetcher(3)					User Contributed Perl Documentation				      Git::SVN::Fetcher(3)

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}
";
	       }
	   }
	   foreach my $path (keys %{$editor->{empty}) {
	       my $action = $editor->{empty}{$path} ? 'added' : 'removed';
	       print "empty directory $path $action
";
	   }
	   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?
"
		   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:

       o   Additions, removals, and modifications of files are propagated to git-svn's index file $GIT_DIR/svn/$refname/index using git update-
	   index.

       o   Changes in Subversion path properties are recorded in the "dir_prop" and "file_prop" fields (which are hashes).

       o   Addition and removal of empty directories are indicated by entries with value 1 and 0 respectively in the "empty" hash.

       o   Paths that are present but cannot be conveyed (presumably due to permissions) are recorded in the "absent_file" and "absent_dirs"
	   hashes.  For each key, the corresponding value is a list of paths under that directory that were present but could not be conveyed.

       The interface is unstable.  Do not use this module unless you are developing git-svn.

DEPENDENCIES

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

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

SEE ALSO

       SVN::Delta, Git::SVN::Editor.

INCOMPATIBILITIES

       None reported.

BUGS

       None.

perl v5.16.3							    2013-06-10						      Git::SVN::Fetcher(3)

Check Out this Related Man Page

SVN::Simple::Edit(3)					User Contributed Perl Documentation				      SVN::Simple::Edit(3)

NAME

       SVN::Simple::Edit - A simple interface for driving svn delta editors

SYNOPSIS

	my $edit = SVN::Simple::Edit->new
	   (_editor => [SVN::Repos::get_commit_editor($repos, "file://$repospath",
					     '/', 'root', 'FOO', &committed)],
	   );

	$edit->open_root($fs->youngest_rev);
	$edit->add_directory ('trunk');
	$edit->add_file ('trunk/filea');
	$edit->modify_file ("trunk/fileb", "content", $checksum);
	$edit->delete_entry ("trunk/filec");
	$edit->close_edit ();
	...
	$edit->copy_directory ('branches/a, trunk, 0);

DESCRIPTION

       SVN::Simple::Edit wraps the subversion delta editor with a perl friendly interface and then you could easily drive it for describing
       changes to a tree. A common usage is to wrap the commit editor, so you could make commits to a subversion repository easily.

       This also means you can not supply the $edit object as an delta_editor to other API, and that's why this module is named ::Edit instead of
       ::Editor.

       See SVN::Simple::Editor for simple interface implementing a delta editor.

PARAMETERS

   for constructor
       _editor
	   The editor that will receive delta editor calls.

       missing_handler
	   Called when parent directory are not opened yet, could be:

	   &SVN::Simple::Edit::build_missing
	       Always build parents if you don't open them explicitly.

	   &SVN::Simple::Edit::open_missing
	       Always open the parents if you don't create them explicitly.

	   SVN::Simple::Edit::check_missing ([$root])
	       Check if the path exists on $root. Open it if so, otherwise create it.

       root
	   The default root to use by SVN::Simple::Edit::check_missing.

       base_path
	   The base path the edit object is created to send delta editor calls.

       noclose
	   Do not close files or directories. This might make non-sorted operations on directories/files work.

METHODS

       Note: Don't expect all editors will work with operations not sorted in DFS order.

       open_root ($base_rev)
       add_directory ($path)
       open_directory ($path)
       copy_directory ($path, $from, $fromrev)
       add_file ($path)
       open_file ($path)
       copy_file ($path, $from, $fromrev)
       delete_entry ($path)
       change_dir_prop ($path, $propname, $propvalue)
       change_file_prop ($path, $propname, $propvalue)
       close_edit ()

AUTHORS

       Chia-liang Kao <clkao@clkao.org>

COPYRIGHT

       Copyright 2003-2004 by Chia-liang Kao <clkao@clkao.org>.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.12.1							    2005-02-23						      SVN::Simple::Edit(3)

Linux and UNIX Man Pages

git::svn::fetcher(3) [centos man page]

Check Out this Related Man Page