Mark Gardner


SVN::Tree - SVN::Fs plus Tree::Path::Class


version 0.005


    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;


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.



Required attribute referencing a _p_svn_fs_root object.


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.


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.


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.


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.



You can find documentation for this module with the perldoc command.

  perldoc SVN::Tree


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 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 :)

  git clone git://


Mark Gardner <>


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.