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.103015
10

METHODS

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

ORIGIN

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

AUTHOR

69       Ricardo SIGNES <rjbs@cpan.org>
70

CONTRIBUTORS

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.34.0                      2021-07-22                 CPAN::Uploader(3)
Impressum