NAME

Tree::Path::Class - Tree for Path::Class objects

VERSION

version 0.007

SYNOPSIS

    use Tree::Path::Class;
    use Path::Class;

    my $tree  = Tree::Path::Class->new( dir('/parent/dir') );
    my $child = Tree::Path::Class->new( file('child/file') );
    $tree->add_child($child);

    print $child->path->stringify;
    # /parent/dir/child/file

DESCRIPTION

This module subclasses Tree to only accept Path::Class::Dir or Path::Class::File values, and provides a path attribute for retrieving the full path of a tree branch or leaf.

ATTRIBUTES

path

A read-only accessor that returns the tree's full Path::Class::Dir or Path::Class::File object, with all parents prepended.

METHODS

FOREIGNBUILDARGS

Coerces the parameter passed to new() into a Path::Class::Dir or Path::Class::File before passing it on to the superclass constructor.

add_child

Works just like the superclass' method. Plain Tree nodes will be recursively recreated as Tree::Path::Class nodes when added.

meta

Unlike Tree, this method provides access to the underlying Moose meta-object rather than a hashref of arbitrary metadata.

SUPPORT

Perldoc

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

  perldoc Tree::Path::Class

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/Tree-Path-Class

• AnnoCPAN

  The AnnoCPAN is a website that allows community annotations of Perl module documentation.

  http://annocpan.org/dist/Tree-Path-Class

• CPAN Ratings

  The CPAN Ratings is a website that allows community ratings and reviews of Perl modules.

  http://cpanratings.perl.org/d/Tree-Path-Class

• CPANTS

  The CPANTS is a website that analyzes the Kwalitee ( code metrics ) of a distribution.

  http://cpants.cpanauthors.org/dist/Tree-Path-Class

• CPAN Testers

  The CPAN Testers is a network of smokers who run automated tests on uploaded CPAN distributions.

  http://www.cpantesters.org/distro/T/Tree-Path-Class

• 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=Tree-Path-Class

• 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=Tree::Path::Class

Bugs / Feature Requests

Please report any bugs or feature requests through the web interface at https://github.com/mjgardner/Tree-Path-Class/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/Tree-Path-Class

  git clone git://github.com/mjgardner/Tree-Path-Class.git

AUTHOR

Mark Gardner <mjgardner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by eBay Enterprise.

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 Tree::Path::Class

perl -MCPAN -e shell
install Tree::Path::Class