Test2::...:Object(3pm)

💅 NAME 💅

ok so this is Test2::Compare::Object — the whole vibe is: it's the representation of an object during deep comparison. periodt.

(also just fyi, the manual name up top shows as Test2::...:Object(3pm) in your terminal because it got cut off — it's giving ✨mysterious✨ but it's really Test2::Compare::Object, part of the Perl Programmers Reference Guide 🎀)

---

🦋 DESCRIPTION 🦋

Bestie. Listen. This class is how you say "I expect THIS object" in a deep comparison. That's the whole assignment and she ate 💅

With it you can:

• check the fields/elements of the underlying reference 👀
• call methods on it to verify the results 🎯
• do meta checks for the object type and the ref type ✨

no cap, it's lowkey the main character of object comparison 💖

---

🌸 METHODS 🌸

⭐ $class = $obj->meta_class

So this is the meta-class that gets used when checking the object type. It's mostly here in the docs because it's genuinely useful to override when you're dealing with specialized object subclasses — like, that's the whole point, iykyk 🫶

Normally? It just returns Test2::Compare::Meta.

⭐ $class = $obj->object_base

Same situation, different flavor: this is the base-class you expect when checking the object type. Also mainly documented because overriding it for specialized object subclasses is the move 💅

Normally it just returns 'UNIVERSAL'.

⭐ $obj->add_prop(...)

Adds a meta-property to check — go look at Test2::Compare::Meta for the deets. This method just delegates. literally just passing the message along, no notes 😌

⭐ $obj->add_field(...)

Adds a hash-field to check, see Test2::Compare::Hash. Also just delegates. she's a middlewoman and she's thriving 💜

⭐ $obj->add_item(...)

Adds an array item to check, see Test2::Compare::Array. Yep — delegates. again. iconic behavior honestly 🌈

⭐ $obj->add_call($method, $check)

⭐ $obj->add_call($method, $check, $name)

⭐ $obj->add_call($method, $check, $name, $context)

ok THIS one's the big one bestie 🔥 this adds a method call check. What happens: it calls the method you specify on your object, then verifies the result. slay.

$method can be any of these three things:

• a method name 🎀
• an array ref 🧚
• a coderef 🦋

Now let's break these down, because the details matter:

• If $method is an arrayref → the first element must be the method name, and everything after it is the arguments that get passed to it. no skipping the first slot, that's the rules 💅
• If $method is a coderef → it's helpful to give an alternate name. When you don't provide a name, the name ends up being either $method or the string '\&CODE'. that's the fallback, that's the vibe ⭐

And then the $context situation:

• If $context is 'list' → the method gets invoked in list context, and the result will be an arrayref.
• If $context is 'hash' → the method gets invoked in list context, and the result will be a hashref. ⚠️ heads up: this one warns if the method returns an odd number of values — so don't be out here returning an odd list and acting surprised 😭 that's on you.

---

👑 SOURCE 👑

The source code repository for Test2-Suite lives right here, bestie:

https://github.com/Test-More/test-more/

go star it, it's giving open source royalty 💖

---

🫶 MAINTAINERS 🫶

Chad Granum <exodist@cpan.org>

---

✨ AUTHORS ✨

Chad Granum <exodist@cpan.org>

(yes same person, he's carrying the whole thing, main character energy fr fr 👑)

---

📜 COPYRIGHT 📜

Copyright Chad Granum <exodist@cpan.org>.

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

See http://dev.perl.org/licenses/

---

🎀 cute lil sign-off: this page came from perl v5.42.3, dated 2026-11-03. drink some water, go call your Test2::Compare::Object a good girl, and remember — deep comparison is self care 💅✨💖