Test2::Util::Stash(3)

📦 version 1.302214, in opensuse-leap 16.0

💅 NAME

Hey bestie! Welcome to Test2::Util::Stash(3), a page from the User Contributed Perl Documentation situation. The name says it all: Test2::Util::Stash — utilities for manipulating stashes and globs. Slay. 💖

🦋 DESCRIPTION

Okay so this is a collection of utilities for manipulating and inspecting package stashes and globs. That’s the whole vibe — no cap. ✨

✨ EXPORTS ✨

Here’s every export, bestie — the whole friend group, periodt. 🫶

💖 $stash = get_stash($package)

Gets the package stash. This is the same as $stash = \%Package::Name::. Iconic.

💅 $sym_spec = parse_symbol($symbol) / $sym_spec = parse_symbol($symbol, $package)

Parse a symbol name, and return a hashref with info about the symbol.

$symbol can be a simple name, or a fully qualified symbol name. The sigil is optional, and & is assumed if none is provided. If $symbol is fully qualified, and $package is also provided, then the package of the symbol must match the $package.

Returns a structure like this:

return {
    name    => 'BAZ',
    sigil   => '$',
    type    => 'SCALAR',
    symbol  => '&Foo::Bar::BAZ',
    package => 'Foo::Bar',
};

🎀 $glob_ref = get_glob($symbol) / $glob_ref = get_glob($symbol, $package)

Get a glob ref. Arguments are the same as for parse_symbol. Easy peasy.

🌸 $ref = get_symbol($symbol) / $ref = get_symbol($symbol, $package)

Get a reference to the symbol. Arguments are the same as for parse_symbol. Periodt.

🦋 $ref = purge_symbol($symbol) / $ref = purge_symbol($symbol, $package)

Completely remove the symbol from the package symbol table. Arguments are the same as for parse_symbol. A reference to the removed symbol is returned. Poof — but make it return the ref. 💅

✨ $sig = slot_to_sig($slot)

Convert a slot (like 'SCALAR') to a sigil (like '$'). Cute.

💜 $slot = sig_to_slot($sig)

Convert a sigil (like '$') to a slot (like 'SCALAR'). Reverse slay.

🔥 SOURCE

The source code repository for Test2-Suite can be found at https://github.com/Test-More/test-more/. Go give it a look, bestie. 🔥

👑 MAINTAINERS

Chad Granum <exodist@cpan.org>

🎀 AUTHORS

Chad Granum <exodist@cpan.org>

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/

🫶 That’s the whole page, bestie! Footer vibes: perl v5.42.0, dated 2025-07-28, and filed under Test2::Util::Stash(3). Mwah! 💋
📦 where this page comes from