MYMETA-CPANFILE(1)

🦋 MYMETA-CPANFILE(1) 🦋

okay so bestie, welcome to mymeta-cpanfile — it's a little Perl script that lives in your terminal and it's literally so useful. it's part of the User Contributed Perl Documentation crew, and honestly? iconic.

---

✨ NAME ✨

mymeta-cpanfile — dumps a cpanfile out of your (MY)META files 💅

---

🌸 SYNOPSIS 🌸

perl Makefile.PL # or Build.PL
mymeta-cpanfile

# Skip configures phase and suggests type
mymeta-cpanfile --no-configure --no-suggests

# Include empty blcok for phases without prereqs
mymeta-cpanfile --include-empty

like, that's the whole vibe. run it, get a cpanfile. slay. 🎀

---

💖 DESCRIPTION 💖

so here's the deal: this script reads the prereqs metadata out of the MYMETA files sitting in your current directory, and then prints out a cpanfile that represents all those prereqs. so clean, so organized.

why would you even want that? because it's lowkey perfect when you're trying to migrate to using cpanfile from your existing Makefile.PL or Build.PL that already has dependency specification in it. no cap — it just lifts the info out and hands it to you in the nicer format. 🫶

also fun fact: this script is distributed with Module::CPANfile since version 0.9021. so it's been around, it's got main character energy, it knows what it's doing. ⭐

---

👑 OPTIONS 👑

• --configure, --build, --test, --runtime, --develop — these pick which phase to include or exclude. the default is to include all phases, but you can drop some by sticking the --no- prefix on the front, like --no-configure. easy. 💅
• --requires, --recommends, --suggests, --conflicts — these pick which type to include or exclude. again, default is to include all types, and again you can exclude the ones you don't want with a --no- prefix, like --no-conflicts. same energy, different axis. ✨
• --include-empty — by default, phases that have no prereqs at all just don't get dumped (nothing to say, so it says nothing). but if you give this option, the cpanfile will get an empty block, like this:

on test => sub {

};

defaults to false. 🙈

ngl, --include-empty is the one people forget exists, and then they're confused why their test phase vanished. it didn't vanish, bestie — it was empty and got quietly skipped. 🧚

---

💜 AUTHOR 💜

Tatsuhiko Miyagawa

---

🌈 SEE ALSO 🌈

Module::CPANfile · cpanfile · App::mymeta_requires

---

and that's the whole page, fr fr — brought to you by perl v5.42.0, dated 2018-04-27, from the MYMETA-CPANFILE(1) manual. go forth and migrate your prereqs, queen. 💖🔥