NAME
SVN::Tree - SVN::Fs plus Tree::Path::Class
VERSION
version 0.005
SYNOPSIS
use SVN::Tree;
use SVN::Core;
use SVN::Repos;
use SVN::Fs;
my $repos = SVN::Repos::open('/path/to/repository');
my $fs = $repos->fs;
my $tree = SVN::Tree->new(root => $fs->revision_root($fs->youngest_rev));
print map {$_->path->stringify} $tree->tree->traverse;
DESCRIPTION
This module marries Tree::Path::Class to the Perl Subversion bindings,
enabling you to traverse the files and directories of Subversion
revisions and transactions, termed roots in Subversion API parlance.
ATTRIBUTES
root
Required attribute referencing a _p_svn_fs_root object.
tree
Read-only accessor for the Tree::Path::Class object describing the
filesystem hierarchy contained in the "root". Will be updated every time
the "root" attribute is changed.
projects
Read-only accessor returning an array reference containing one or more
Tree::Path::Class hierarchies for the top-level project directories in
the repository. In the case of a repository with trunk, branches and
tags at the top level, this will be one element referring to the same
hierarchy available through the "tree" attribute.
Like "tree" this will also be updated with "root" changes.
branches
Read-only accessor returning a hash reference of arrays containing
Tree::Path::Class objects for each branch in each project in the
repository. The hash keys are the names of the projects, and trunk
counts as a branch.
Like "tree" this will also be updated with "root" changes.
SEE ALSO
The distribution for this module also includes MooseX::Types::SVN, a
Moose type library for the Subversion Perl bindings. This may be split
off into its own distribution at a later point if it proves useful in
other projects.
SUPPORT
Perldoc
You can find documentation for this module with the perldoc command.
perldoc SVN::Tree
Websites
The following websites have more information about this module, and may
be of help to you. As always, in addition to those websites please use
your favorite search engine to discover more resources.
* Search CPAN
The default CPAN search engine, useful to view POD in HTML format.
<http://search.cpan.org/dist/SVN-Tree>
* AnnoCPAN
The AnnoCPAN is a website that allows community annotations of Perl
module documentation.
<http://annocpan.org/dist/SVN-Tree>
* CPAN Ratings
The CPAN Ratings is a website that allows community ratings and
reviews of Perl modules.
<http://cpanratings.perl.org/d/SVN-Tree>
* CPANTS
The CPANTS is a website that analyzes the Kwalitee ( code metrics )
of a distribution.
<http://cpants.perl.org/dist/overview/SVN-Tree>
* CPAN Testers
The CPAN Testers is a network of smokers who run automated tests on
uploaded CPAN distributions.
<http://www.cpantesters.org/distro/S/SVN-Tree>
* CPAN Testers Matrix
The CPAN Testers Matrix is a website that provides a visual overview
of the test results for a distribution on various Perls/platforms.
<http://matrix.cpantesters.org/?dist=SVN-Tree>
* CPAN Testers Dependencies
The CPAN Testers Dependencies is a website that shows a chart of the
test results of all dependencies for a distribution.
<http://deps.cpantesters.org/?module=SVN::Tree>
Bugs / Feature Requests
Please report any bugs or feature requests through the web interface at
<https://github.com/mjgardner/SVN-Tree/issues>. You will be
automatically notified of any progress on the request by the system.
Source Code
The code is open to the world, and available for you to hack on. Please
feel free to browse it and play with it, or whatever. If you want to
contribute patches, please send me a diff or prod me to pull from your
repository :)
<https://github.com/mjgardner/SVN-Tree>
git clone git://github.com/mjgardner/SVN-Tree.git
AUTHOR
Mark Gardner <mjgardner@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by GSI Commerce.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.