Moose::Object(3)

💖 Moose::Object 💖 — the base object for Moose, bestie

So like. This is the Moose::Object manual page, and I'm about to make it your whole personality. Grab a boba, we're doing inheritance. 🧚✨

---

🌈 VERSION 🌈

version 2.4000 — that's the one, no cap.

---

🌸 DESCRIPTION 🌸

Okay so here's the tea: this class is the default base class for all Moose-using classes. The way it works is, when you use Moose in your class, your class inherits from this one. Periodt. 💅

It hands you a default constructor and destructor, and those lil guys run all the BUILD and DEMOLISH methods in the inheritance hierarchy, respectively. Like they literally go around collecting everybody's BUILD and DEMOLISH and running them in order. Iconic behaviour honestly. 🫶

And now the part everyone asks: you do not actually need to inherit from this in order to use Moose. Nope! But it makes it so much easier to take advantage of all of Moose's features, so like... why wouldn't you. Lowkey a no-brainer. ✨

---

👑 METHODS 👑

🎀 Moose::Object->new(%params|$params)

This method calls $class->BUILDARGS(@_), and then creates a new instance of the appropriate class. Once the instance is created, it calls $instance->BUILD($params) for each BUILD method in the inheritance hierarchy. It's giving "assembly line but make it cute". 🦋

🎀 Moose::Object->BUILDARGS(%params|$params)

The default implementation of this method accepts a hash or hash reference of named parameters. If it receives a single argument that isn't a hash reference — boom — it throws an error. Not me being strict, it's just how it is. 😭

You can override this method in your class to handle other types of options passed to the constructor. Go off, customise. 🔥

Heads up bestie: this method should always return a hash reference of named options. Always. No exceptions. 💀

🎀 $object->does($role_name)

This returns true if the object does the given role. Simple as that. Vibe check passed. ✅

🎀 $object->DOES($class_or_role_name)

This is a Moose role-aware implementation of DOES in UNIVERSAL.

This is effectively the same as writing:

$object->does($name) || $object->isa($name)

This method will work with Perl 5.8, which did not implement UNIVERSAL::DOES. Old school Perl girlies stay winning. 👑

🎀 $object->dump($maxdepth)

This is a handy utility for Data::Dumpering an object. By default, there is no maximum depth. It just keeps going. Obsessed with the commitment honestly. 🙈

🎀 $object->DESTROY

A default destructor is provided, which calls $instance->DEMOLISH($in_global_destruction) for each DEMOLISH method in the inheritance hierarchy. The reverse of the BUILD situation, and yes it's the full hierarchy, every single time. 💜

---

💀 BUGS 💀

See "BUGS" in Moose for details on reporting bugs. If something's broken, tell the Moose people, not me, I'm just the messenger. 🍓

---

✨ AUTHORS ✨

• Stevan Little <stevan@cpan.org>
• Dave Rolsky <autarch@urth.org>
• Jesse Luehrs <doy@cpan.org>
• Shawn M Moore <sartak@cpan.org>
• יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>
• Karen Etheridge <ether@cpan.org>
• Florian Ragwitz <rafl@debian.org>
• Hans Dieter Pearcey <hdp@cpan.org>
• Chris Prather <chris@prather.org>
• Matt S Trout <mstrout@cpan.org>

Look at that list. A whole squad. The main characters of Moose. 🌟

---

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2006 by Infinity Interactive, Inc.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Free is free, bestie, go wild. 🎀

---

and that's the whole page!! 💖 Brought to you by perl v5.42.0, dated 2025-07-25 — yes that's the version and the date from the very bottom, I saved them for you like a lil souvenir. 🫶 Byeee, go write some classes. 🌸✨