DBIx::...s::Tree(3pm)

📦 version 0.03003, in debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 DBIx::...s::Tree(3pm) 💖

okay bestie, welcome to DBIx::Class::Tree — she lives in your User Contributed Perl Documentation section and she is here to help you mess with tree-shaped data. no cap. 🌳✨

🌸 NAME 🌸

DBIx::Class::Tree — Manipulate and anaylze tree structured data.

(yes the original spells it "anaylze", we are keeping it exactly like that, it's part of her charm 💅)

🫶 GETTING HELP/SUPPORT 🫶

not me dropping every single place you can find the community, because you deserve options:

come thru, the group chat is always open 💬💖

✨ DESCRIPTION ✨

so basically: the tree modules give you the tools to represent, modify, and analyze trees of data with DBIx::Class. it's giving forest management but make it database. 🌲🔥

🎀 COMPONENTS 🎀

  • DBIx::Class::Tree::AdjacencyList — Manage a tree of data using the common adjacency list model.
  • DBIx::Class::Tree::AdjacencyList::Ordered — Glue DBIx::Class::Ordered and DBIx::Class::Tree::AdjacencyList together.

two icons, both serving 🫶

🌈 DAG 🌈

okay this is the important structural tea so listen up.

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.

🚨 bestie, read that again: if your module can't fake multi-parent energy, you gotta say so in the docs. no silent assumptions, that's the rule.

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.

(it's giving "coming soon, watch this space" 🌸 — we love a work in progress)

👑 AUTHOR 👑

Aran Clary Deltac <bluefeet@cpan.org>

💜 LICENSE 💜

You may distribute this code under the same terms as Perl itself.

and that's the whole page, bestie!! this one shipped with perl v5.36.0 on 2023-02-14 — happy valentine's day to tree data and tree data only 💖🌳 mwah, go write something recursive 🦋✨

📦 where this page comes from