forest::tree::builder(3pm) [debian man page]
Forest::Tree::Builder(3pm) User Contributed Perl Documentation Forest::Tree::Builder(3pm) 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-2010 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. perl v5.10.1 2010-09-27 Forest::Tree::Builder(3pm)
Check Out this Related Man Page
Forest(3pm) User Contributed Perl Documentation Forest(3pm) NAME
Forest - A collection of n-ary tree related modules DESCRIPTION
Forest is intended to be a replacement for the Tree::Simple family of modules, and fixes many of the issues that have always bothered me about them. It is by no means a complete replacement yet, but should eventually grow to become that. For more information please refer to the individual module documentation, starting with Forest::Tree. TODO
More documentation This is 0.09 so it is (still) lacking quite a bit of docs (I am being really lazy sorry). Although I invite people to read the source, it is quite simple really. More tests The coverage is in the low 90s, but there is still a lot of behavioral stuff that could use some testing too. SEE ALSO
Tree::Simple I wrote this module a few years ago and I had served me well, but recently I find myself getting frustrated with some of the uglier bits of this module. So Forest is a re-write of this module. Tree This is an ambitious project to replace all the Tree related modules with a single core implementation. There is some good code in here, but the project seems to be very much on the back-burner at this time. OCaml port of Forest Ask me about the OCaml port of this module, it is also sitting on my hard drive waiting for release. It actually helped quite a bit in terms of helping me settle on the APIs for this module. Static typing can be very helpful sometimes. 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
Stevan Little <stevan.little@iinteractive.com> With contributions from: Yuval (nothingmuch) Kogman Guillermo (groditi) Roditi Florian (rafl) Ragwitz COPYRIGHT AND LICENSE
Copyright 2008-2010 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. perl v5.10.1 2010-10-24 Forest(3pm)