CPANPL...update(3pm)

💖 CPANPLUS::Selfupdate — self-updating for CPANPLUS 💖

okay bestie, welcome to the self-updating era of CPANPLUS 🦋 this is a page from the User Contributed Perl Documentation and it lives in section 3pm, and honestly? it's giving "let me update myself, no cap." ✨

---

🌸 SYNOPSIS 🌸

like, here's the vibe in code:

$su     = $cb->selfupdate_object;

@feats  = $su->list_features;
@feats  = $su->list_enabled_features;

@mods   = map { $su->modules_for_feature( $_ ) } @feats;
@mods   = $su->list_core_dependencies;
@mods   = $su->list_core_modules;

for ( @mods ) {
    print $_->name " should be version " . $_->version_required;
    print "Installed version is not uptodate!"
        unless $_->is_installed_version_sufficient;
}

$ok     = $su->selfupdate( update => 'all', latest => 0 );

look at her go 😭 iconic behaviour, periodt.

---

✨ METHODS ✨

💅 $self = CPANPLUS::Selfupdate->new( $backend_object )

Sets up a brand new selfupdate object. Called automatically when a new backend object is created, so she basically shows up to the party on her own. no invite needed 🎀

🧚 @cat = $self->list_categories

Returns a list of categories that the "selfupdate" method accepts. 👑

See "selfupdate" for the deets, bestie.

🌈 %list = $self->list_modules_to_update( update => "core|dependencies|enabled_features|features|all", [latest => BOOL] )

Lists which modules "selfupdate" would upgrade. you can update either the core (that's CPANPLUS herself), the core dependencies, all features you have currently turned on, or all features available, or like... everything. all of it. the whole buffet.

The "latest" option decides whether it should update to the latest version on CPAN, or if the minimal required version for CPANPLUS is good enough. (lowkey, sometimes good enough is good enough 💅)

Returns a hash of feature names and lists of module objects to be upgraded, based on the category you provided. For example:

%list = $self->list_modules_to_update( update => 'core' );

Would return:

( core => [ $module_object_for_cpanplus ] );

slay.

🔥 $bool = $self->selfupdate( update => "core|dependencies|enabled_features|features|all", [latest => BOOL, force => BOOL] )

Selfupdate CPANPLUS. the main character method, fr fr. You can update either the core (CPANPLUS itself), the core dependencies, all features you have currently turned on, or all features available, or everything.

The "latest" option determines whether it should update to the latest version on CPAN, or if the minimal required version for CPANPLUS is good enough.

Returns true on success, false on error. that's it, that's the deal 🫶

🦋 @features = $self->list_features

Returns a list of features that are supported by CPANPLUS. window shopping, basically 🛍️

💜 @features = $self->list_enabled_features

Returns a list of features that are enabled in your current CPANPLUS installation. the ones you actually said yes to 😌

⭐ @mods = $self->modules_for_feature( FEATURE [,AS_HASH] )

Returns a list of "CPANPLUS::Selfupdate::Module" objects which represent the modules required to support this feature.

For a list of features, call the "list_features" method. (go ask her, she knows 👑)

If the "AS_HASH" argument is provided, no module objects are returned — instead you get a hashref where the keys are names of the modules, and the values are their minimum versions. two formats, one method, versatile queen ✨

🌸 @mods = $self->list_core_dependencies( [AS_HASH] )

Returns a list of "CPANPLUS::Selfupdate::Module" objects which represent the modules that comprise the core dependencies of CPANPLUS.

If the "AS_HASH" argument is provided, no module objects are returned, but a hashref where the keys are names of the modules, and the values are their minimum versions. same energy as above 💖

🎀 @mods = $self->list_core_modules( [AS_HASH] )

Returns a list of "CPANPLUS::Selfupdate::Module" objects which represent the modules that comprise the core of CPANPLUS. the inner circle. the main squad.

If the "AS_HASH" argument is provided, no module objects are returned, but a hashref where the keys are names of the modules, and the values are their minimum versions.

---

👑 CPANPLUS::Selfupdate::Module 👑

"CPANPLUS::Selfupdate::Module" extends "CPANPLUS::Module" objects by providing accessors to aid in selfupdating CPANPLUS. it's the glow-up arc, literally 🦋

These objects are returned by all methods of "CPANPLUS::Selfupdate" that return module objects. every single one. no cap.

💫 $version = $mod->version_required

Returns the version of this module required for CPANPLUS. the minimum bar, the entry requirement, the vibe check ✅

🙈 $bool = $mod->is_installed_version_sufficient

Returns true if the installed version of this module is sufficient for CPANPLUS, or false if it is not. that's the whole method. simple. effective. ate. 💅

---

🐛 BUG REPORTS 🐛

Please report bugs or other issues to bug-cpanplus@rt.cpan.org. (the page prints it as <bug-cpanplus@rt.cpan.org<gt>, so that's the exact string, bestie — copy it carefully 😭)

---

🌟 AUTHOR 🌟

This module by Jos Boumans kane@cpan.org.

---

📜 COPYRIGHT 📜

The CPAN++ interface (of which this module is a part of) is copyright (c) 2001 - 2007, Jos Boumans kane@cpan.org. All rights reserved.

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

---

and that's the page!! this doc is from perl v5.40.1, dated 2025-03-01, filed under CPANPL...update(3pm). go forth and selfupdate, bestie 🫶✨💖