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.

cpanm SVN::Tree

perl -MCPAN -e shell
install SVN::Tree