CPANP(1p)

📦
version 0.9916 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💅 CPANP 💅

okay bestie, so this is the manual for cpanp, aka The CPANPLUS launcher. yes it's a real manpage (section 1p, user contributed perl docs, we love a niche queen) and yes we're gonna read the whole thing together. grab a snack 🍓

✨ SYNOPSIS ✨

cpanp

cpanp [-]a [ --[no-]option... ]  author...

cpanp [-]mfitulrcz [ --[no-]option... ]  module...

cpanp [-]d [ --[no-]option... ] [ --fetchdir=... ]  module...

cpanp [-]xb [ --[no-]option... ]

cpanp [-]o [ --[no-]option... ] [ module... ]

like. look at her. she contains multitudes. 🦋

🌸 DESCRIPTION 🌸

so this script is the thing that launches the CPANPLUS utility so you can do a whole bunch of operations straight from the command line. and if you run it with no arguments at all? it drops you into an interactive shell by default. main character energy fr 💅

optionally, it can take a single-letter switch plus one or more arguments, and it'll do the associated action on each argument. here's the lil cheat sheet of available commands, but heads up: cpanp -h gives you the detailed list, so if you want the full tea, go there. 🫖

h                   # help information
v                   # version information

a AUTHOR ...        # search by author(s)
m MODULE ...        # search by module(s)
f MODULE ...        # list all releases of a module

i MODULE ...        # install module(s)
t MODULE ...        # test module(s)
u MODULE ...        # uninstall module(s)
d MODULE ...        # download module(s)
l MODULE ...        # display detailed information about module(s)
r MODULE ...        # display README files of module(s)
c MODULE ...        # check for module report(s) from cpan-testers
z MODULE ...        # extract module(s) and open command prompt in it

x                   # reload CPAN indices

o [ MODULE ... ]    # list installed module(s) that aren't up to date
b                   # write a bundle file for your configuration

every command can be followed by one or more options, bestie. and here's the lil twist: if an option is preceded by no, that option gets set to 0. otherwise? it's set to 1. that's it, that's the whole system, so iconic. 😌

Example: say you wanna skip a module's tests —

cpanp -i --skiptest MODULE ...
ngl skipping tests is a whole vibe but it's your vibe, do with that what you will 🙈

valid options for most commands are cpantest, debug, flush, force, prereqs, storable, verbose, md5, signature, and skiptest. and the d command also accepts fetchdir. if you want the actual meanings of those, go consult CPANPLUS::Configure — they explain it there, I'm just the messenger 🧚

Example: to download a module's tarball straight into the current directory —

cpanp -d --fetchdir=. MODULE ...
SEE ALSO-adjacent heads up: no, actually, there's no SEE ALSO section in this one, the only cross-reference is the CPANPLUS::Configure mention above. just keeping it real so you're not out here looking for something that isn't there 💀

and that's the whole page, bestie!! perl v5.40.1, dated 2025-03-01, filed under CPANP(1p). mwah. go forth and install some modules 💖✨🎀

📦 where this page comes from