|o||HTTP file upload and register the module by POSTing to the PAUSE web server.|
Before using cpan-upload-http you must register with PAUSE, to get a username and password. If you are a regular uploader to PAUSE, youll probably want to create a .pause configuration file, as described in CONFIGURATION FILE below. If not, you can just use the command-line options, as described in OPTIONS below. If you dont provide your password (via configuration file or command-line), then you will be prompted for it. Echoing will be turned off while you type your password. This behaviour can be suppressed with the <B>-non_interactiveB> option, described below.
-user <string> Your PAUSE username (which you previously registered with PAUSE). -password <string> The password for your PAUSE username. -directory <string> | -dir <string> A subdirectory in your CPAN area where the file should be uploaded to. -mailto <email> Your email address to include the HTTP request header. -http_proxy <URL> Specifies the URL for a proxy to use when making HTTP requests. -non_interactive | -ni cpan-upload-http should not prompt for any missing information (eg password), it should just warn or die, as appropriate. -help Displays a short help message with the OPTIONS section from the cpan-upload-http documentation. -doc Display the full documentation for <B>cpan-upload-httpB>. -verbose Turns on verbose information as the script runs. -debug Turns on debugging information. Useful mainly for the developer, it displays the HTTP request and response. -version Display the version number of the <B>cpan-upload-httpB> script.
You can provide the configuration information needed via a .pause file in your home directory. If you upload files at all regularly you will want to set up one of these.
The following is a sample .pause file:
<B>userB> username This is used to specify your PAUSE username. This just saves you from typing it every time you run the script. <B>passwordB> password This is used to specify your PAUSE password. <B>directoryB> path Specify a subdirectory in your CPAN area. <B>http_proxyB> URL The URL for the proxy to use when making HTTP requests to the PAUSE web server. For example:
http_proxy = http://proxy/
<B>mailtoB> EMAIL Specifies the email address which is passed in the header of the HTTP request. You must provide this. <B>non_interactiveB> Specifies that cpan-upload-http should never prompt the user (eg for password), but should take a default action.
# example .pause for user neilb # the user is your registered PAUSE username user NEILB password thisisnotmyrealpassword mailto = firstname.lastname@example.org http_proxy = http://proxy.cre.canon.co.uk/ non_interactive
Also, let me know if you ever have occasion to wish that the features below had been implemented. I probably wont do them unless someone would like to see them in.
Id be happy to hear any more suggestions.
o As with the password, prompt for PAUSE username and email address if not provided (by .pause file or on the command-line). o Add configuration options for specifying the URI we POST to. This would let you deal with any changes without requiring a new release. These arent likely to change on any regular basis, so seem gratuitous.
www.cpan.org The home page for the Comprehensive Perl Archive Network. PAUSE The Perl Authors Upload SErver. The PAUSE FAQ can be seen on CPAN: libwww-perl5 The LWP distribution which provides the modules used by this script to talk to the PAUSE web server. You can get the latest version from: AppConfig::Std The module used to handle command-line options and the configuration file.
This is actually a subclass of AppConfig, which youll also need.
Term::ReadKey The module used to turn off echoing if we prompt the user for a PAUSE password.
$Revision: 2.2 $
Neil Bowers <email@example.com>
Brad Fitzpatrick <firstname.lastname@example.org> HTTP upload support, FTP removal.
Copyright (c) 2001-2002 Neil Bowers.
Copyright (c) 1998-2001 Canon Research Centre Europe. All rights reserved.
This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
|perl v5.20.3||CPAN-UPLOAD-HTTP (1)||2007-04-17|