The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.

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.