DBICx::...c::Magic(3)

✨ DBICx::...c::Magic ✨

okay bestie, so this is the User Contributed Perl Documentation page for DBICx::...c::Magic(3), and ngl it's a tiny little module with main character energy 🎀

---

💖 NAME 💖

DBICx::AutoDoc::Magic — the way it captures some otherwise unobtainable information about a DBIx::Class subclass 🦋 no cap, some stuff just can't be reverse-engineered later, so this lil thing grabs it while it can.

---

🌸 SYNOPSIS 🌸

lowkey the whole synopsis is just "go look at the other docs", so:

See dbicx-autodoc and DBICx::AutoDoc.

that's it. that's the synopsis. iconic honestly 💅

---

🎀 DESCRIPTION 🎀

so DBICx::AutoDoc::Magic is a DBIx::Class component, and it's used by DBICx::AutoDoc to capture some information that literally cannot be reverse-engineered out of a compiled DBIx::Class subclass 😭

like, once it's compiled it's compiled, bestie. the vibes are gone. so this module snatches them up early. periodt.

---

🫶 METHODS 🫶

this class has literally only two methods of its own... and yes, the original page really does say "it's" instead of "its", we're not fixing it, we're honoring it 🙈

🌈 _autodoc

this one is simply an accessor — and not just any accessor, a Class::Accessor::Grouped accessor, of type 'inherited' to be precise — that hands each of the subclasses a suitable spot to store the info this module collects for them 🍓

🌈 _autodoc_record_relationship

this method gets called by each of the overloaded methods, and it just records their arguments in the hashref stored in _autodoc, and then forwards the call on to the real method ✨

---

👑 OVERLOADED METHODS 👑

this module overloads the following DBIx::Class methods. they're overloaded merely to call _autodoc_record_relationship, and then they go ahead and call the original method. so it's giving "not me intercepting your call just to write it down real quick" 💀

• belongs_to
• has_many
• might_have
• has_one
• many_to_many

---

🔥 SEE ALSO 🔥

go read these too, iykyk:

• DBICx::AutoDoc
• dbicx-autodoc
• DBIx::Class
• DBIx::Class::Relationship

---

💜 AUTHOR 💜

Jason Kohles, <email@jasonkohles.com> — shoutout to the author, absolute legend 🌟

---

⭐ COPYRIGHT AND LICENSE ⭐

Copyright (C) 2007 by Jason Kohles

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

so basically: same terms as Perl itself, go wild but be normal about it 💖

---

and that's the whole page bestie!! this was perl v5.42.0, dated 2025-07-25 — mwah, slay, go capture some unobtainable information 🧚‍♀️💅