MooseX...tection(3pm)

okay bestie 💖 quick heads-up before we dive in: this page lives in the User Contributed Perl Documentation (that's the manual name, very "written by the community, for the community" energy 🫶), and the header at the top just squishes the whole long name down to MooseX...tection(3pm) because apparently life is too short to spell it out. anyway, let's GO ✨

---

💖 NAME 💖

MooseX::Storage::Engine::Trait::DisableCycleDetection — a custom trait to bypass cycle detection 🌀💀

---

🌸 VERSION 🌸

version 0.53 — that's the vibe, that's the number, periodt.

---

✨ SYNOPSIS ✨

okay so here's the whole moment, in code, exactly as it happens:

package Double;
use Moose;
use MooseX::Storage;
with Storage( traits => ['DisableCycleDetection'] );

has 'x' => ( is => 'rw', isa => 'HashRef' );
has 'y' => ( is => 'rw', isa => 'HashRef' );

my $ref = {};

my $double = Double->new( 'x' => $ref, 'y' => $ref );

$double->pack;

look at that. $ref in both slots, the same ref, bestie. iconic behavior honestly 👑

---

🦋 DESCRIPTION 🦋

so MooseX::Storage ships with a little baby check for circular references. it's primitive. it's doing its best. 😭 but here's the thing — that check also triggers on the simple cases like the one in the Synopsis. like, you didn't even do anything wrong and it's already side-eyeing you.

and that's where DisableCycleDetection comes in 💅

providing the DisableCycleDetection trait disables checks for any cyclical references. so if you know what you're doing, you can bypass this check. no cap. if you do not know what you're doing, that's a you problem and it's giving future debugging arc 🙈

just so we're clear: this trait gets applied to an instance of MooseX::Storage::Engine. for the user-visible version — the one actually shown up in the SYNOPSIS — head over to MooseX::Storage::Traits::DisableCycleDetection. two different things, don't mix them up, iykyk 🧚

---

🫶 SUPPORT 🫶

found a bug? yeah, same, there's a whole process:

• bug reports can be submitted through the RT bug tracker at <https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Storage> — or, if email is more your vibe, bug-MooseX-Storage@rt.cpan.org <mailto:bug-MooseX-Storage@rt.cpan.org> 💌
• there's also a mailing list available for users of this distribution, at <http://lists.perl.org/list/moose.html> 🍓
• and there's an irc channel available for users of this distribution, at #moose on irc.perl.org <irc://irc.perl.org/#moose> 🌈

---

👑 AUTHORS 👑

the legends, in order:

• Chris Prather <chris.prather@iinteractive.com> 💜
• Stevan Little <stevan.little@iinteractive.com> 💜
• יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org> 💜

---

🎀 COPYRIGHT AND LICENSE 🎀

this software is copyright (c) 2007 by Infinity Interactive, Inc.

and it's free software 💖 you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay.

---

and that's the whole page, bestie! 🦋 this ran on perl v5.36.0 and the date on the tin is 2022-10-16, so if you're reading this in the future, hi, you're doing great, drink some water 💧✨ mwah, bye! 🎀💅