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