1CPAN::Uploader(3) User Contributed Perl Documentation CPAN::Uploader(3)
2
3
4
6 CPAN::Uploader - upload things to the CPAN
7
9 version 0.103015
10
12 upload_file
13 CPAN::Uploader->upload_file($file, \%arg);
14
15 $uploader->upload_file($file);
16
17 Valid arguments are:
18
19 user - (required) your CPAN / PAUSE id
20 password - (required) your CPAN / PAUSE password
21 subdir - the directory (under your home directory) to upload to
22 http_proxy - uri of the http proxy to use
23 upload_uri - uri of the upload handler; usually the default (PAUSE) is right
24 debug - if set to true, spew lots more debugging output
25 retries - number of retries to perform on upload failure (5xx response)
26 retry_delay - number of seconds to wait between retries
27
28 This method attempts to actually upload the named file to the CPAN. It
29 will raise an exception on error.
30
31 new
32 my $uploader = CPAN::Uploader->new(\%arg);
33
34 This method returns a new uploader. You probably don't need to worry
35 about this method.
36
37 Valid arguments are the same as those to "upload_file".
38
39 read_config_file
40 my $config = CPAN::Uploader->read_config_file( $filename );
41
42 This reads the config file and returns a hashref of its contents that
43 can be used as configuration for CPAN::Uploader.
44
45 If no filename is given, it looks for .pause in the user's home
46 directory (from the env var "HOME", or the current directory if "HOME"
47 isn't set).
48
49 See "CONFIGURATION" in cpan-upload for the config format.
50
51 log
52 $uploader->log($message);
53
54 This method logs the given string. The default behavior is to print it
55 to the screen. The message should not end in a newline, as one will be
56 added as needed.
57
58 log_debug
59 This method behaves like "log", but only logs the message if the
60 CPAN::Uploader is in debug mode.
61
63 This code is mostly derived from "cpan-upload-http" by Brad
64 Fitzpatrick, which in turn was based on "cpan-upload" by Neil Bowers.
65 I (rjbs) didn't want to have to use a "system" call to run either of
66 those, so I refactored the code into this module.
67
69 Ricardo SIGNES <rjbs@cpan.org>
70
72 • Barbie <barbie@missbarbell.co.uk>
73
74 • Christian Walde <walde.christian@googlemail.com>
75
76 • David Caldwell <david@porkrind.org>
77
78 • David Golden <dagolden@cpan.org>
79
80 • fREW Schmidt <frioux@gmail.com>
81
82 • Gabor Szabo <szabgab@gmail.com>
83
84 • Graham Knop <haarg@haarg.org>
85
86 • Kent Fredric <kentfredric@gmail.com>
87
88 • Mark Fowler <mark@twoshortplanks.com>
89
90 • Mike Doherty <doherty@cs.dal.ca>
91
92 • perlancar (@netbook-zenbook-ux305) <perlancar@gmail.com>
93
94 • Ricardo Signes <rjbs@semiotic.systems>
95
96 • Steven Haryanto (on Asus Zenbook) <stevenharyanto@gmail.com>
97
98 • sungo <sungo@sungo.us>
99
100 • Torsten Raudssus <github@raudssus.de>
101
102 • Vincent Pit <perl@profvince.com>
103
105 This software is copyright (c) 2020 by Ricardo SIGNES.
106
107 This is free software; you can redistribute it and/or modify it under
108 the same terms as the Perl 5 programming language system itself.
109
110
111
112perl v5.32.1 2021-01-26 CPAN::Uploader(3)