[Dbix-class] RFC: DBIx-Class-Tree

[Aran Deltac]

On 4/4/2006, "Matt S Trout" <dbix-class at trout.me.uk> wrote:
>Dave Howorth wrote:
>> Aran Deltac wrote:
>>> Its in the Ordered component.  Any method that exist in
>>> Tree::AdjacencyList or Ordered components is not shown in
>>> Tree::AdjacencyList::Ordered component.  I've added a section listing
>>> the methods that are made available via these other two components.  You
>>> would still need to read the related component's POD for detailed docs
>>> on the methods.
>>
>> I appreciate this dilemma. As the reader in this instance, I can just
>> point out that this policy makes it more difficult to use the module. If
>> I were the maintainer, I might well have a different opinion :)
>
>Which brings us back to a regular problem with DBIC's lots-of-components
>nature. I think what we really need is a magic script to assemble to bits of
>POD from other modules into one that uses them in a way that doesn't get in
>the way of the maintainer.

I've just commited a script that uses Class::C3 to pick out the
inheritance order and digs out the methods in the various modules and
creates a nicely formatted POD of inherited methods.  Its in:

http://dev.catalyst.perl.org/repos/bast/branches/DBIx-Class-current/maint/inheritance_pod.pl

I've used it to generate the INHERITED METHODS section in all the
modules in the DBIx-Class-Tree repo (just commited).

>>> A DAG is a bit of a different beast than a Tree, but I'll keep it in
>>> mind.  Sounds like a deffinate possibility.
>>
>> Well, a tree is a special case of a DAG, so an interface that can handle
>> DAGs can handle trees, but not necessarily vice versa.
>
> From a user's point of view a tree is just a DAG constrained to a single
>parent, right?

Sounds right to me.

Aran

>--
>      Matt S Trout       Offering custom development, consultancy and support
>   Technical Director    contracts for Catalyst, DBIx::Class and BAST. Contact
>Shadowcat Systems Ltd.  mst (at) shadowcatsystems.co.uk for more information
>
>+ Help us build a better perl ORM: http://dbix-class.shadowcatsystems.co.uk/ +
>
>_______________________________________________
>List: http://lists.rawmode.org/cgi-bin/mailman/listinfo/dbix-class
>Wiki: http://dbix-class.shadowcatsystems.co.uk/
>IRC: irc.perl.org#dbix-class
>SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/