---
name: "CPANPLUS::Selfupdate"
section: "3pm"
platform: "linux"
package: "perl-cpanplus"
version: "0.9916-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/CPANPLUS::Selfupdate/3pm"
---

# CPANPLUS::Selfupdate(3pm)

self-updating for CPANPLUS

## NAME

CPANPLUS::Selfupdate - self-updating for CPANPLUS

## SYNOPSIS

```
    $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 );
```

## METHODS

### $self = CPANPLUS::Selfupdate-\>new( $backend\_object );

Sets up a new selfupdate object. Called automatically when a new backend object is created.

### @cat = $self-\>list\_categories

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

See `"selfupdate"` for details.

### %list = $self-\>list\_modules\_to\_update( update =\> "core\|dependencies\|enabled\_features\|features\|all", \[latest =\> BOOL\] )

List which modules `"selfupdate"` would upgrade. 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 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 ] );
```

### $bool = $self-\>selfupdate( update =\> "core\|dependencies\|enabled\_features\|features\|all", \[latest =\> BOOL, force =\> BOOL\] )

Selfupdate CPANPLUS. 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.

### @features = $self-\>list\_features

Returns a list of features that are supported by CPANPLUS.

### @features = $self-\>list\_enabled\_features

Returns a list of features that are enabled in your current CPANPLUS installation.

### @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.

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

### @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 values are their minimum versions.

### @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.

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

## CPANPLUS::Selfupdate::Module

`"CPANPLUS::Selfupdate::Module"` extends `"CPANPLUS::Module"` objects by providing accessors to aid in selfupdating CPANPLUS.

These objects are returned by all methods of `"CPANPLUS::Selfupdate"` that return module objects.

### $version = $mod-\>version\_required

Returns the version of this module required for CPANPLUS.

### $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.

## BUG REPORTS

Please report bugs or other issues to \<bug-cpanplus@rt.cpan.org\<gt\>.

## 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.