1CPANPLUS::Shell::DefaulUts(e3r)Contributed Perl DocumentCaPtAiNoPnLUS::Shell::Default(3)
2
6 CPANPLUS::Shell::Default
7
9 ### loading the shell:
10 $ cpanp # run 'cpanp' from the command line
11 $ perl -MCPANPLUS -eshell # load the shell from the command line
12 use CPANPLUS::Shell qw[Default]; # load this shell via the API
14 # always done via CPANPLUS::Shell
15 my $ui = CPANPLUS::Shell->new;
17 $ui->shell; # run the shell
18 $ui->dispatch_on_input( input => 'x'); # update the source using the
19 # dispatch method
20 ### when in the shell:
22 ### Note that all commands can also take options.
23 ### Look at their underlying CPANPLUS::Backend methods to see
24 ### what options those are.
25 cpanp> h # show help messages
26 cpanp> ? # show help messages
27 cpanp> m Acme # find acme modules, allows regexes
29 cpanp> a KANE # find modules by kane, allows regexes
30 cpanp> f Acme::Foo # get a list of all releases of Acme::Foo
31 cpanp> i Acme::Foo # install Acme::Foo
33 cpanp> i Acme-Foo-1.3 # install version 1.3 of Acme::Foo
34 cpanp> i <URI> # install from URI, like ftp://foo.com/X.tgz
35 cpanp> i 1 3..5 # install search results 1, 3, 4 and 5
36 cpanp> i * # install all search results
37 cpanp> a KANE; i *; # find modules by kane, install all results
38 cpanp> t Acme::Foo # test Acme::Foo, without installing it
39 cpanp> u Acme::Foo # uninstall Acme::Foo
40 cpanp> d Acme::Foo # download Acme::Foo
41 cpanp> z Acme::Foo # download & extract Acme::Foo, then open a
42 # shell in the extraction directory
43 cpanp> c Acme::Foo # get a list of test results for Acme::Foo
45 cpanp> l Acme::Foo # view details about the Acme::Foo package
46 cpanp> r Acme::Foo # view Acme::Foo's README file
47 cpanp> o # get a list of all installed modules that
48 # are out of date
49 cpanp> o 1..3 # list uptodateness from a previous search
50 cpanp> s conf # show config settings
52 cpanp> s conf md5 1 # enable md5 checks
53 cpanp> s program # show program settings
54 cpanp> s edit # edit config file
55 cpanp> s reconfigure # go through initial configuration again
56 cpanp> s selfupdate # update your CPANPLUS install
57 cpanp> s save # save config to disk
58 cpanp> s mirrors # show currently selected mirrors
59 cpanp> ! [PERL CODE] # execute the following perl code
61 cpanp> b # create an autobundle for this computers
63 # perl installation
64 cpanp> x # reload index files (purges cache)
65 cpanp> x --update_source # reload index files, get fresh source files
66 cpanp> p [FILE] # print error stack (to a file)
67 cpanp> v # show the banner
68 cpanp> w # show last search results again
69 cpanp> q # quit the shell
71 cpanp> /plugins # list avialable plugins
73 cpanp> /? PLUGIN # list help test of <PLUGIN>
74 ### common options:
76 cpanp> i ... --skiptest # skip tests
77 cpanp> i ... --force # force all operations
78 cpanp> i ... --verbose # run in verbose mode
79
81 This module provides the default user interface to "CPANPLUS". You can
82 start it via the "cpanp" binary, or as detailed in the SYNOPSIS.
83
85 Please report bugs or other issues to <bug-cpanplus@rt.cpan.org<gt>.
86
88 This module by Jos Boumans <kane@cpan.org>.
89
91 The CPAN++ interface (of which this module is a part of) is copyright
92 (c) 2001 - 2007, Jos Boumans <kane@cpan.org>. All rights reserved.
93 This library is free software; you may redistribute and/or modify it
95 under the same terms as Perl itself.
96
98 CPANPLUS::Shell::Classic, CPANPLUS::Shell, cpanp
99perl v5.8.8 2007-03-31 CPANPLUS::Shell::Default(3)