1CPAN::Uploader(3)     User Contributed Perl Documentation    CPAN::Uploader(3)
2
3
4

NAME

6       CPAN::Uploader - upload things to the CPAN
7

VERSION

9       version 0.103016
10

PERL VERSION

12       This library should run on perls released even a long time ago.  It
13       should work on any version of perl released in the last five years.
14
15       Although it may work on older versions of perl, no guarantee is made
16       that the minimum required version will not be increased.  The version
17       may be increased for any reason, and there is no promise that patches
18       will be accepted to lower the minimum required perl.
19

METHODS

21   upload_file
22         CPAN::Uploader->upload_file($file, \%arg);
23
24         $uploader->upload_file($file);
25
26       Valid arguments are:
27
28         user        - (required) your CPAN / PAUSE id
29         password    - (required) your CPAN / PAUSE password
30         subdir      - the directory (under your home directory) to upload to
31         http_proxy  - uri of the http proxy to use
32         upload_uri  - uri of the upload handler; usually the default (PAUSE) is right
33         debug       - if set to true, spew lots more debugging output
34         retries     - number of retries to perform on upload failure (5xx response)
35         retry_delay - number of seconds to wait between retries
36
37       This method attempts to actually upload the named file to the CPAN.  It
38       will raise an exception on error. c<upload_uri> can also be set through
39       the ENV variable c<CPAN_UPLOADER_UPLOAD_URI>.
40
41   new
42         my $uploader = CPAN::Uploader->new(\%arg);
43
44       This method returns a new uploader.  You probably don't need to worry
45       about this method.
46
47       Valid arguments are the same as those to "upload_file".
48
49   read_config_file
50         my $config = CPAN::Uploader->read_config_file( $filename );
51
52       This reads the config file and returns a hashref of its contents that
53       can be used as configuration for CPAN::Uploader.
54
55       If no filename is given, it looks for .pause in the user's home
56       directory (from the env var "HOME", or the current directory if "HOME"
57       isn't set).
58
59       See "CONFIGURATION" in cpan-upload for the config format.
60
61   log
62         $uploader->log($message);
63
64       This method logs the given string.  The default behavior is to print it
65       to the screen.  The message should not end in a newline, as one will be
66       added as needed.
67
68   log_debug
69       This method behaves like "log", but only logs the message if the
70       CPAN::Uploader is in debug mode.
71

ORIGIN

73       This code is mostly derived from "cpan-upload-http" by Brad
74       Fitzpatrick, which in turn was based on "cpan-upload" by Neil Bowers.
75       I (rjbs) didn't want to have to use a "system" call to run either of
76       those, so I refactored the code into this module.
77

AUTHOR

79       Ricardo SIGNES <rjbs@semiotic.systems>
80

CONTRIBUTORS

82       •   Barbie <barbie@missbarbell.co.uk>
83
84       •   Christian Walde <walde.christian@googlemail.com>
85
86       •   David Caldwell <david@porkrind.org>
87
88       •   David Golden <dagolden@cpan.org>
89
90       •   fREW Schmidt <frioux@gmail.com>
91
92       •   Gabor Szabo <szabgab@gmail.com>
93
94       •   Graham Knop <haarg@haarg.org>
95
96       •   Karen Etheridge <ether@cpan.org>
97
98       •   Kent Fredric <kentfredric@gmail.com>
99
100       •   Marcus Ramberg <marcus.ramberg@gmail.com>
101
102       •   Mark Fowler <mark@twoshortplanks.com>
103
104       •   Mike Doherty <doherty@cs.dal.ca>
105
106       •   perlancar <perlancar@gmail.com>
107
108       •   Steven Haryanto (on Asus Zenbook) <stevenharyanto@gmail.com>
109
110       •   sungo <sungo@sungo.us>
111
112       •   Thibault DUPONCHELLE <thibault.duponchelle@amadeus.com>
113
114       •   Torsten Raudssus <github@raudssus.de>
115
116       •   Vincent Pit <perl@profvince.com>
117
119       This software is copyright (c) 2021 by Ricardo SIGNES.
120
121       This is free software; you can redistribute it and/or modify it under
122       the same terms as the Perl 5 programming language system itself.
123
124
125
126perl v5.36.0                      2022-07-22                 CPAN::Uploader(3)
Impressum