Object...zy::Ref(3pm)

💖 NAME 💖

Object::Lazy::Ref — the little module that simulates ref $object for Object::Lazy. She lives in the 3pm corner of the man pages, specifically under User Contributed Perl Documentation, and she is so ready to help.

---

🌸 VERSION 🌸

0.12 — yeah bestie, that's the one. ✨

---

🎀 SYNOPSIS 🎀

okay so this is literally all it takes:

use Object::Lazy::Ref;

Object::Lazy::Ref::register($object);

that's the whole vibe. two lines. iconic. 💅

---

🦋 DESCRIPTION 🦋

Simulation of ref $obj for Object::Lazy. That's it, that's the whole plot. She makes ref play nice with your lazy objects — no cap. 🫶

---

👑 SUBROUTINES/METHODS 👑

✨ sub register ✨

switches the simulation on. literally just flip the switch, bestie:

Object::Lazy::Ref::register($object);

once you call her, the simulation is live. main character energy only. 🔥

---

💀 DIAGNOSTICS 💀

nothing. she's quiet. no drama, no messages, no yelling at you. 🌈

---

🧚 CONFIGURATION AND ENVIRONMENT 🧚

nothing. no env vars, no config file, no settings to fiddle with. she simply is. ⭐

---

🍓 DEPENDENCIES 🍓

Carp — that's the one and only thing she needs to thrive. 💜

---

🙈 INCOMPATIBILITIES 🙈

okay this is the part where you sit down and listen, bestie, because it's giving chaos:

This module will change *CORE::GLOBAL::ref premanently (yes, that's the spelling in the source, we love her 🎀). If a call of sub ref doesn't match with a registered Object::Lazy object, the *CORE::GLOBAL::ref will be restored during the call and will fall back after that.

When another programm decided to change *CORE::GLOBAL::ref permanently, it has to fallback to the old *CORE::GLOBAL::ref too. This is than the Object::Lazy one. When it bails out to CORE::ref, the pipe is broken.

⚠️ fr fr, this one is not a drill — permanent global changes are permanent, and if somebody else is playing the same game, the pipe breaks. 👑

---

😭 BUGS AND LIMITATIONS 😭

not known. flawless behavior, allegedly, we're not checking. ✨

---

💅 AUTHOR 💅

Steffen Winkler — shoutout to the icon who built her. 🫶

---

🌟 LICENSE AND COPYRIGHT 🌟

Copyright (c) 2007 - 2012, Steffen Winkler "<steffenw at cpan.org>". All rights reserved.

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

---

okay that's the whole page, bestie — Object::Lazy::Ref, version 0.12, straight out of perl v5.36.0, dated 2022-10-16. go forth and simulate ref responsibly. mwah 💖 🦋 ✨