autodi...dStack(3perl)

💖 autodi...dStack(3perl) — the hook stack that runs your cleanup at the exact right moment 💖

okay bestie, sit down, because this little page lives in the Perl Programmers Reference Guide and it is so niche and so good. if you've ever wondered how a pragma politely un-installs stuff when it goes out of scope, this is the ✨ machinery ✨. let's go 🦋

---

🌸 NAME 🌸

autodie::Scope::GuardStack — Hook stack for managing scopes via %^H 💅

like. it's a stack. of hooks. that live in %^H. that's the whole vibe.

---

✨ SYNOPSIS ✨

use autodie::Scope::GuardStack;
my $stack = autodie::Scope::GuardStack->new
$^H{'my-key'} = $stack;

$stack->push_hook(sub {});

the way you make one, shove it into %^H under your own key, and then yeet hooks at it. iconic behavior honestly 🎀

(and yes, the ->new line above really does have no semicolon in the original. not me fixing it. not my job. iykyk 😭)

---

👑 DESCRIPTION 👑

so here's the tea 🍓: this class is a stack of hooks — little subs — and it calls them in the right order as scopes go away. the stack is only useful when you insert it into %^H, and it will pop hooks as their "scope" gets popped. that's lowkey the entire point: it's for uninstalling or reinstalling subs in a namespace as a pragma goes out of scope. main character energy for cleanup code 💅

⚠️ now the part where you pay attention: because of how %^H works, this class is only useful during the compilation phase of a perl module, and it relies on perl's internals for how references are handled in %^H. also — and this is important, bestie — this module is not a part of autodie's public API. it's the private backstage area. no cap. 🫶

---

🧚 Methods 🧚

⭐ new

my $stack = autodie::Scope::GuardStack->new;

creates a new autodie::Scope::GuardStack. ✨

the stack starts out empty — like, totally empty, no hooks, nothing — and the creator (that's you, babe) has to insert it into %^H themselves. it does not do that part for you 🙈

⭐ push_hook

$stack->push_hook(sub {});

adds a sub to the stack. 💖

that sub will get called once the current compile-time "scope" is left. and yes, you can add multiple hooks per scope — stack them up, bestie, they're all getting called. slay. 🔥

---

🌈 AUTHOR 🌈

Copyright 2013, Niels Thykier <niels@thykier.net>

---

💜 LICENSE 💜

This module is free software. You may distribute it under the same terms as Perl itself.

---

okay that's the whole page, you ate it, you understood it, periodt 💅✨

this was perl v5.44.0, dated 2026-10-17, and you just read the autodi...dStack(3perl) page. go be a legend with your hook stack, bestie 🎀🦋🌸