CPANINJECT(1)

📦
version 1.14 · 2 versions
, in fedora 43

👑 CPANINJECT(1) — the cpaninject era 💅

User Contributed Perl Documentation · perl v5.42.0 · 2025-07-25

✨ NAME ✨

cpaninject — bestie, it injects a whole distribution so you can install it via the CPAN shell 🎀

🦋 SYNOPSIS 🦋

# Add the distribution
cpaninject myperlmodule.tar.gz

# And then install it from the cpan shell
cpan> install LOCAL/myperlmodule.tar.gz

💖 DESCRIPTION 💖

So cpaninject is literally just a tiny little front-end app for the CPAN::Inject module. Like, small. Adorable. Does one thing. 👑

What it does: it takes any arbitrary Perl distribution tarball — open source, closed source, whatever, no judgement here — and injects it into the local CPAN file cache, then smooothes over some metadata files so the whole thing looks like it came from CPAN. Glow-up via metadata. It's giving "fake it till you make it" but it's legit. ✨

And it does all of that using the officially blessed "Reserved Local CPAN Author" id LOCAL as the author that the distributions get added under. Reserved. Official. Blessed. Iconic behaviour fr fr.

To use the program, you literally just run cpaninject mytarball.tar.gz to add it, then hop into the CPAN shell to install it — with full automatic recursive dependency installation. 😭 the way that it handles the dependencies for you?? obsessed.

The key here being the recursive dependency installation, which you are now able to do even for installing non-CPAN modules. 🔥

It simplifies the installation process a little bit, and it makes things easier on someone who just wants to install a single commercial or non-CPAN Perl module that might have a dozen or more CPAN dependencies. No cap, a dozen. Or more. 😮‍💨

🫶 SUPPORT 🫶

All bugs should be filed via the bug tracker at

<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPAN-Inject>

For other issues, or commercial enhancement and support, contact the author 💌

🌸 AUTHOR 🌸

Adam Kennedy <adamk@cpan.org> 💜

🎀 SEE ALSO 🎀

  • CPAN::Mini::Inject 🧚

Copyright 2006 - 2011 Adam Kennedy.

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

The full text of the license can be found in the LICENSE file included with this module.

okay that's the whole page bestie, go forth and inject 💅 — this was CPANINJECT(1), part of User Contributed Perl Documentation, shipped with perl v5.42.0, dated 2025-07-25. slay, bye! 💖✨🦋

📦 where this page comes from