CPAN-OUTDATED(1p)

💖 cpan-outdated — a little page from the perl manual, section 1p 🎀

okay bestie, sit down, we're talking about cpan-outdated, and honestly? she's that girl. 🌸

---

✨ NAME ✨

cpan-outdated — detect outdated CPAN modules in your environment 💅

---

✨ SYNOPSIS ✨

    # print a list of distributions that contain outdated modules
    % cpan-outdated

    # print a list of outdated modules in packages
    % cpan-outdated -p

    # verbose
    % cpan-outdated --verbose
    .
    # ignore core modules (do not update dual life modules)
    % cpan-outdated --exclude-core

    # alternate mirrors
    % cpan-outdated --mirror file:///home/user/minicpan/

    # additional module path(same as cpanminus)
    % cpan-outdated -l extlib/
    % cpan-outdated -L extlib/

    # install with cpan
    % cpan-outdated | xargs cpan -i

    # install with cpanm
    % cpan-outdated    | cpanm
    % cpan-outdated -p | cpanm

yes, that lonely little . up there in the verbose block is literally in the original and we are keeping her, she's part of the family now 🫶

---

✨ DESCRIPTION ✨

so basically this script prints a list of outdated CPAN modules on your machine. that's it. that's the whole gig. ✨

it does the same thing as 'CPAN::Shell->r', except cpan-outdated is way faster and uses less memory. not me being dramatic, that's just the facts, no cap. 🔥

and you can totally integrate this script with the cpanm command, which is the moment where it becomes iconic. 👑

---

✨ PRINTING PACKAGES VS DISTRIBUTIONS ✨

by default this script prints the outdated distribution in the CPAN distro format, i.e:

A/AU/AUTHOR/Distribution-Name-0.10.tar.gz

so you can pipe it straight into CPAN installers. 🎀 but if you pass the -p option you can tweak it to print the module's package names instead. pick your fighter.

if you wanna manage a set of modules separately from your system perl installation — and you do not want to install newer versions of those "dual life modules" that ship with perl — then the --exclude-core option makes cpan-outdated ignore changes to core modules. pair it with tools like cpanm and its -L --local-lib-contained and --self-contained options, and boom: maintaining updates on standalone sets of modules is, like, facilitated. 🦋

for some tools, such as cpanm, installing from packages could be a bit more useful, since you can track to see the old version number which you upgrade from. iykyk 👀

---

✨ AUTHOR ✨

Tokuhiro Matsuno 🌟

---

✨ LICENSE ✨

Copyright (C) 2009 Tokuhiro Matsuno.

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

yes bestie, same terms as Perl itself. respect the license, she's protecting everybody. 💜

---

✨ SEE ALSO ✨

• CPAN
• App::cpanminus

if you wanna see what's changed for modules that require upgrades, use cpan-listchanges. go, be curious, it's giving main character energy. 🌈

---

and that's a wrap on the perl v5.34.0 era, dated 2022-06-05 — this page came from the User Contributed Perl Documentation, and honestly? she ate. periodt. 💅✨