Module:...::Admin(3)

🌸 NAME 🌸

okay so this is the Module:...::Admin(3) page — user-contributed Perl documentation, bestie — and the module is Module::Install::Admin - Author-side manager for Module::Install. 💅

---

✨ SYNOPSIS ✨

So you're inside a Module::Install extension module, and it looks like this:

sub extension_method {
    my $self = shift;
    $self->admin->some_method(@args);
}

And as a one-liner, you can do this:

% perl "-MModule::Install::Admin" -e'&some_method(@args);'

Both snippets above are really shorthands for

$some_obj->some_method(@args)

where $some_obj is the singleton object of a class under the Module::Install::Admin::* namespace that provides the method some_method. See METHODS for a list of built-in methods. 🫶

---

💖 DESCRIPTION 💖

This module implements the internal mechanism for initializing, including and managing extensions, and it should only be of interest to extension developers. It is never included under a distribution's inc/ directory, nor are any of the Module::Install::Admin::* extensions. 🚨

For normal usage of Module::Install, please see Module::Install and "COOKBOOK / EXAMPLES" in Module::Install instead. ✨

🧚 Bootstrapping 🧚

When someone runs a Makefile.PL that has use inc::Module::Install, and there is no inc/ in the current directory, Module::Install will load this module bootstrap itself, through the steps below: 🦋

• First, Module/Install.pm is POD-stripped and copied from @INC to inc/. This should only happen on the author's side, never on the end-user side. 👑
• Reload inc/Module/Install.pm if the current file is somewhere else. This ensures that the included version of inc/Module/Install.pm is always preferred over the installed version. 🔥
• Look at inc/Module/Install/*.pm and load all of them. 🌈
• Set up a main::AUTOLOAD function to delegate missing function calls to Module::Install::Admin::load — again, this should only happen at the author's side. 💀
• Provide a Module::Install::purge_self function for removing included files under inc/. 🎀

---

💅 METHODS 💅

The original page has this heading and then… nothing under it before SEE ALSO. Not me skipping it, bestie — it's just empty in the source. It's giving placeholder energy. 💀

---

🦋 SEE ALSO 🦋

• Module::Install — that's the one, bestie. 💖

---

👑 AUTHORS 👑

Audrey Tang <autrijus@autrijus.org> 🌸

---

🎀 COPYRIGHT 🎀

Copyright 2003, 2004 by Audrey Tang <autrijus@autrijus.org>. 💖

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🫶

See <http://www.perl.com/perl/misc/Artistic.html> ⭐

---

okay that's the whole page, bestie! 💖 This was perl v5.42.0, dated 2023-04-29, and the manual name is Module:...::Admin(3) — go forth and manage your author-side extensions! 🫶✨🎀