1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
package DBIx::Class::Tree;
# vim: ts=8:sw=4:sts=4:et
use strict;
use warnings;
use base qw( DBIx::Class );
our $VERSION = '0.03003';
1;
__END__
=head1 NAME
DBIx::Class::Tree - Manipulate and anaylze tree structured data.
=head1 GETTING HELP/SUPPORT
The community can be found via:
=over
=item * IRC: irc.perl.org#dbix-class
=for html
<a href="http://chat.mibbit.com/#dbix-class@irc.perl.org">(click for instant chatroom login)</a>
=item * Mailing list: L<http://lists.scsys.co.uk/mailman/listinfo/dbix-class>
=item * RT Bug Tracker: L<https://rt.cpan.org/Dist/Display.html?Queue=DBIx-Class-Tree>
=item * gitweb: L<http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=dbsrgits/DBIx-Class-Tree.git>
=item * git: L<git://git.shadowcat.co.uk/dbsrgits/DBIx-Class-Tree.git>
=back
=head1 DESCRIPTION
The tree modules provide the tools to represent, modify, and analyze
trees of data with DBIx::Class.
=head1 COMPONENTS
L<DBIx::Class::Tree::AdjacencyList> - Manage a tree of data using the
common adjacency list model.
L<DBIx::Class::Tree::AdjacencyList::Ordered> - Glue DBIx::Class::Ordered
and DBIx::Class::Tree::AdjacencyList together.
=head1 DAG
All tree related modules must conform to have and use the basic traversal
methods of a DAG. For the most part this just means that Tree modules
must provide the appearance of having multiple parents per node (via a
parents() method) but may very well never return more than one parent.
All utility modules, such as a Visitor module, should do its best to
never assume that a node only has one parent. There are situations
where this is not possible - in those cases the module's documentation
should clearly state that it is not compatible with DAGs.
So far there is no Tree::DAG module, but there will be. These requirements
are vague, and the requirements of Tree modules to be DAG compatible will
become more defined in due course.
=head1 AUTHOR
Aran Clary Deltac <bluefeet@cpan.org>
=head1 LICENSE
You may distribute this code under the same terms as Perl itself.
|
