No::Wor...::Export(3)

No::Wor...::Export(3) — User Contributed Perl Documentation, bestie. This is the manual page for No::Worries::Export, and yes the vibes are immaculate. 💅

🌸 NAME 🌸

No::Worries::Export — symbol exporting without worries

✨ SYNOPSIS ✨

Okay so here’s the starter pack:

use No::Worries::Export qw(export_control);

sub foo () { ... }

our $bar = 42;

sub import : method {
    my($pkg, %exported);
    $pkg = shift(@_);
    grep($exported{$_}++, qw(foo $bar));
    export_control(scalar(caller()), $pkg, \%exported, @_);
}

🦋 DESCRIPTION 🦋

This module eases symbol exporting by providing a simple yet powerful alternative to the Exporter module. Literally the whole point: export symbols without the worry. 🫶

The symbols that can be imported are defined in a hash — that’s the third argument of export_control() — and the key is the symbol name while the value is:

• a scalar: indicating a normal symbol
• a code reference: to be called at import time

The normal symbols can be functions (such as foo), scalars (<$foo>), arrays (<@foo>) or hashes (<%foo>).

All the normal symbols can be imported at once by using an asterisk in the import code:

use Foo qw(*);

Alternatively, a regular expression can be given to filter what to import:

# import "foo" and all the normal symbols starting with "bar"
use Foo qw(foo /^bar/);

The special symbols can be used to execute any code. For instance:

# exporting module
our $backend = "stdout";
sub import : method {
    my($pkg, %exported);
    $pkg = shift(@_);
    $exported{syslog} = sub { $backend = "syslog" };
    export_control(scalar(caller()), $pkg, \%exported, @_);
}

# importing code
use Foo qw(syslog);

Finally, anything looking like a number will trigger a version check:

use Foo qw(1.2);
# will trigger
Foo->VERSION(1.2);

See UNIVERSAL for more information on the VERSION() mthod. (Keeping the typo, because we respect the lore. 💀)

🎀 FUNCTIONS 🎀

This module provides the following function (not exported by default):

• export_control(CALLERPKG, PKG, EXPORT, NAMES...) — control the symbols exported by the module; this should be called from an import method

👑 SEE ALSO 👑

Exporter, No::Worries.

💖 AUTHOR 💖

Lionel Cons <http://cern.ch/lionel.cons>

Copyright (C) CERN 2012-2019

---

That’s the whole page, bestie. Brought to you by perl v5.32.1, dated 2021-10-18 — iconic behavior. ✨