NAME

       Forest::Tree::Builder - An abstract role for bottom up tree reader

SYNOPSIS

           package MyBuilder;
           use Moose;

           with qw(Forest::Tree::Builder);

           # implement required builder:

           sub _build_subtrees {
               return [
                   $self->create_new_subtree( ... ), # probably a recursive process
               ];
           }

           my $builder = MyBuilder->new(
               tree_class => ...,
               ...
           );

           my $tree = $builder->tree;

DESCRIPTION

       Forest::Tree::Builder replaces Forest::Tree::Loader and Forest::Tree::Reader with a bottom
       up construction approach, which is also suitable for constructing Forest::Tree::Pure
       derived trees without excessive cloning.

       It provides a declarative API instead of an imperative one, where "tree" is lazily
       constructed on the first use, instead of being constructed immediately and "filled in" by
       the "load" method.

METHODS

       create_new_subtree
           Implemented by Forest::Tree::Constructor

       _build_tree
           Constructs a root node by using the top level "subtrees" list as the children.

       _build_subtrees
           Build the subtrees.

           Abstract method that should return an array ref of Forest::Tree::Pure derived objects.

SEE ALSO

       Forest::Tree::Builder::SimpleTextFile

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find
       a bug please either email me, or add the bug to cpan-RT.

AUTHOR

       Yuval Kogman

COPYRIGHT AND LICENSE

       Copyright 2008-2014 Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.