Module...utorial(3pm)

💖 Module::Package::Tutorial 💖

okay so bestie, this is the hands on guide to Module::Package::Tutorial — a real one, no cap 🫶

---

🌸 INTRODUCTION 🌸

Welcome to Module::Package, babes. This tutorial is for people who wanna package modules for CPAN, who wanna make sure they're doing it the absolute best they can, but who also — and this is the important part — wanna spend more time working on their code than on becoming a full-on expert packager. It's also for people who want to take all the time and effort they've poured into packaging, and share new ideas and tricks with others. giving community, giving generosity ✨

I'll start by taking a typical Makefile.PL written with Module::Install and show you how to turn this into various Module::Package configurations, eventually ending up with a single line Makefile.PL. Like, one line. Obsessed. 😭

Then I'll show you the ins and outs of making your own Module::Install plugin module to handle your common needs. main character plugin energy 💅

---

🎀 Makefile.PL 2.0 🎀

I won't start with 1.0. Those days are long past, okay? We don't do that anymore. Here's what a typical Makefile.PL looks like these days:

use strict;
use inc::Module::Install;

name            'Foo-Bar';
all_from        'lib/Foo/Bar.pm';
build_requires  'Test::More';

auto_include_deps;
sign;

WriteAll;

... This doc is a work in progress. Stay tuned ... 👀

Here's the the final version:

use Module::Package 'All:good';

like. that's it. that's the whole thing. one line. she ate and left no crumbs 🔥

---

👑 AUTHOR 👑

Ingy döt Net <ingy@cpan.org>

---

💜 COPYRIGHT AND LICENSE 💜

Copyright (c) 2011. Ingy döt Net.

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

---

and that's the whole page bestie 🌈 this one's from perl v5.34.0, dated 2022-06-16, and it lives in the User Contributed Perl Documentation corner of the manual — go forth and package slay 💖✨🦋