- NAME
- SYNOPSIS
- DESCRIPTION
- BUG REPORTS
- AUTHOR
- COPYRIGHT
- SEE ALSO

# NAME

CPANPLUS::Shell::Default - the default CPANPLUS shell

# SYNOPSIS

        ### loading the shell:
        $ cpanp                     # run 'cpanp' from the command line
        $ perl -MCPANPLUS -eshell   # load the shell from the command line

        use CPANPLUS::Shell qw[Default];        # load this shell via the API
                                                # always done via CPANPLUS::Shell

        my $ui = CPANPLUS::Shell->new;
        $ui->shell;                             # run the shell
        $ui->dispatch_on_input( input => 'x');  # update the source using the
                                                # dispatch method

        ### when in the shell:
        ### Note that all commands can also take options.
        ### Look at their underlying CPANPLUS::Backend methods to see
        ### what options those are.
        cpanp> h                 # show help messages
        cpanp> ?                 # show help messages

        cpanp> m Acme            # find acme modules, allows regexes
        cpanp> a KANE            # find modules by kane, allows regexes
        cpanp> f Acme::Foo       # get a list of all releases of Acme::Foo

        cpanp> i Acme::Foo       # install Acme::Foo
        cpanp> i Acme-Foo-1.3    # install version 1.3 of Acme::Foo
        cpanp> i <URI>           # install from URI, like ftp://foo.com/X.tgz
        cpanp> i <DIR>           # install from an absolute or relative directory
        cpanp> i 1 3..5          # install search results 1, 3, 4 and 5
        cpanp> i *               # install all search results
        cpanp> a KANE; i *;      # find modules by kane, install all results
        cpanp> t Acme::Foo       # test Acme::Foo, without installing it
        cpanp> u Acme::Foo       # uninstall Acme::Foo
        cpanp> d Acme::Foo       # download Acme::Foo
        cpanp> z Acme::Foo       # download & extract Acme::Foo, then open a
                                 # shell in the extraction directory

        cpanp> c Acme::Foo       # get a list of test results for Acme::Foo
        cpanp> l Acme::Foo       # view details about the Acme::Foo package
        cpanp> r Acme::Foo       # view Acme::Foo's README file
        cpanp> o                 # get a list of all installed modules that
                                 # are out of date
        cpanp> o 1..3            # list uptodateness from a previous search

        cpanp> s conf            # show config settings
        cpanp> s conf md5 1      # enable md5 checks
        cpanp> s program         # show program settings
        cpanp> s edit            # edit config file
        cpanp> s reconfigure     # go through initial configuration again
        cpanp> s selfupdate      # update your CPANPLUS install
        cpanp> s save            # save config to disk
        cpanp> s mirrors         # show currently selected mirrors

        cpanp> ! [PERL CODE]     # execute the following perl code

        cpanp> b                 # create an autobundle for this computers
                                 # perl installation
        cpanp> x                 # reload index files (purges cache)
        cpanp> x --update_source # reload index files, get fresh source files
        cpanp> p [FILE]          # print error stack (to a file)
        cpanp> v                 # show the banner
        cpanp> w                 # show last search results again

        cpanp> q                 # quit the shell
        cpanp> e                 # exit the shell and reload

        cpanp> /plugins          # list available plugins
        cpanp> /? PLUGIN         # list help test of <PLUGIN>

        ### common options:
        cpanp> i ... --skiptest # skip tests
        cpanp> i ... --force    # force all operations
        cpanp> i ... --verbose  # run in verbose mode

# DESCRIPTION

This module provides the default user interface to `CPANPLUS`. You can start it via the `cpanp` binary, or as detailed in the SYNOPSIS.

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

# SEE ALSO

CPANPLUS::Shell::Classic, CPANPLUS::Shell, cpanp