Devel::...t::State(3)

💖 Devel::LeakGuard::Object::State — the perl(3) page but make it cute 💖

okay bestie, welcome to the User Contributed Perl Documentation section 3 ✨ this one is literally about catching object leaks, and it's called Devel::LeakGuard::Object::State. it's giving scoped. it's giving leak-checking. it's giving main character energy 🫶

---

🎀 NAME 🎀

Devel::LeakGuard::Object::State — scoped object leak checking 🦋

no cap, that's the whole name. object leak checking, but scoped, like with a lil start and a lil end. obsessed 💅

---

⭐ VERSION ⭐

this doc describes Devel::LeakGuard::Object::State version 0.08 — so you know exactly which era of slay we're in ✨

---

🌸 SYNOPSIS 🌸

here's the vibe, copy it, live it:

use Devel::LeakGuard::Object::State;

# Later
my $leakstate = Devel::LeakGuard::Object::State->new(
    on_leak => 'die'
);

My::Thing->leaky();

$leakstate->done;

like, you make the state object, you run whatever messy code you're suspicious about, then you hit done and it tells you if stuff leaked 😭 iconic workflow fr fr

---

💜 DESCRIPTION 💜

so a Devel::LeakGuard::Object::State captures the current leakstate of object allocations inside your program. think of it as a lil polaroid of what's allocated rn 📸

then, when you call done, it compares that saved allocation leakstate against the current leakstate and reports any discrepancies</> 👑 if nothing changed, great, slay. if things drifted? it tells you. periodt.

---

✨ INTERFACE ✨

🧚 new

create a brand new Devel::LeakGuard::Object::State 💖 you can pass it a bunch of options, bestie. and like, the full list of options? it lives over in leakguard in Devel::LeakGuard::Object — go peek there for the whole menu 🍓

🦋 done

call done at the end of the chunk of code you're leak-checking, okay? that's the moment of truth 💅

if it detects allocation imbalances, the action taken depends entirely on the options you passed to new. and by default? a warning is displayed 🌈 that's it, that's the default, no drama, just a warning.

---

👑 AUTHOR 👑

andy armstrong, <andy@hexten.net> — ty for your service king 🫶✨

---

🌈 LICENCE AND COPYRIGHT 🌈

copyright (c) 2009-2015, andy armstrong <andy@hexten.net>.

this module is free software; you can redistribute it and/or modify it under the same terms as perl itself. see perlartistic 📜

---

💀 heads up bestie: same terms as perl itself, so go read perlartistic if you wanna know the exact legal tea. don't just vibe-guess it 🙈

---

and that's the whole page, fr fr 💖 brought to you by perl v5.42.0, dated 2025-07-25 — love that for us, mwah 🎀✨