CPAN::Uploader.3pm

Langue: en

Autres versions - même langue

Version: 2010-08-03 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

CPAN::Uploader - upload things to the CPAN

VERSION

version 0.102150

METHODS

upload_file

   CPAN::Uploader->upload_file($file, \%arg);
 
   $uploader->upload_file($file);
 
 

Valid arguments are:

   user       - (required) your CPAN / PAUSE id
   password   - (required) your CPAN / PAUSE password
   subdir     - the directory (under your home directory) to upload to
   http_proxy - url of the http proxy to use 
   debug      - if set to true, spew lots more debugging output
 
 

This method attempts to actually upload the named file to the CPAN. It will raise an exception on error.

new

   my $uploader = CPAN::Uploader->new(\%arg);
 
 

This method returns a new uploader. You probably don't need to worry about this method.

Valid arguments are the same as those to "upload_file".

read_config_file

   my $config = CPAN::Uploader->read_config_file( $filename );
 
 

This reads the config file and returns a hashref of its contents that can be used as configuration for CPAN::Uploader.

If no filename is given, it looks for .pause in the user's home directory (from the env var "HOME", or the current directory if "HOME" isn't set).

log

   $uploader->log($message);
 
 

This method logs the given string. The default behavior is to print it to the screen. The message should not end in a newline, as one will be added as needed.

log_debug

This method behaves like "log", but only logs the message if the CPAN::Uploader is in debug mode.

WARNING

   This is really, really not well tested or used yet.  Give it a few weeks, at
   least.  -- rjbs, 2008-06-06
 
 

ORIGIN

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

AUTHOR

Ricardo SIGNES <rjbs@cpan.org> This software is copyright (c) 2010 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.