DOKK / manpages / debian 11 / libbio-perl-perl / Bio::Root::HTTPget.3pm.en
Bio::Root::HTTPget(3pm) User Contributed Perl Documentation Bio::Root::HTTPget(3pm)

Bio::Root::HTTPget - module for fallback HTTP get operations when LWP:: is unavailable

 use Bio::Root::HTTPget;
 my $web = Bio::Root::HTTPget->new();
 my $response = $web->get('http://localhost');
 $response    = $web->get('http://localhost/images');
 $response    = eval { $web->get('http://fred:secret@localhost/ladies_only/')
                     } or warn $@;
 $response    = eval { $web->get('http://jeff:secret@localhost/ladies_only/')
                     } or warn $@;
 $response    = $web->get('http://localhost/images/navauthors.gif');
 $response    = $web->get(-url=>'http://www.google.com',
                                    -proxy=>'http://www.modperl.com');

This is basically an last-chance module for doing network HTTP get requests in situations where more advanced external CPAN modules such as LWP:: are not installed.

The particular reason this module was developed was so that the Open Bio Database Access code can fallback to fetching the default registry files from http://open-bio.org/registry/ without having to depend on external dependencies like Bundle::LWP for network HTTP access.

The core of this module was written by Lincoln Stein. It can handle proxies and HTTP-based proxy authentication.

User feedback is an integral part of the evolution of this and other Bioperl modules. Send your comments and suggestions preferably to one of the Bioperl mailing lists. Your participation is much appreciated.

  bioperl-l@bioperl.org                  - General discussion
  http://bioperl.org/wiki/Mailing_lists  - About the mailing lists

Report bugs to the Bioperl bug tracking system to help us keep track the bugs and their resolution. Bug reports can be submitted via the web:

  https://github.com/bioperl/bioperl-live/issues

# Please direct questions and support issues to bioperl-l@bioperl.org

 Cared for by Chris Dagdigian <dag@sonsorol.org>

The rest of the documentation details each of the object methods. Internal methods are usually preceded with a _

 Title   : get
 Usage   : my $resp = get(-url => $url);
 Function: 
 Returns : string
 Args    : -url     => URL to HTTPGet
           -proxy   => proxy to use
           -user    => username for proxy or authentication
           -pass    => password for proxy or authentication
           -timeout => timeout

 Title   : getFH
 Usage   : 
 Function:
 Example :
 Returns : string
 Args    :

 Title   :
 Usage   : 
 Function:
 Example :
 Returns :
 Args    :

 Title   :
 Usage   : 
 Function:
 Example :
 Returns :
 Args    :

 Title   :
 Usage   : 
 Function:
 Example :
 Returns :
 Args    :

 Title   : proxy
 Usage   : $httpproxy = $db->proxy('http')  or 
           $db->proxy(['http','ftp'], 'http://myproxy' )
 Function: Get/Set a proxy for use of proxy. Defaults to environment variable
           http_proxy if present.
 Returns : a string indicating the proxy
 Args    : $protocol : string for the protocol to set/get
           $proxyurl : url of the proxy to use for the specified protocol
           $username : username (if proxy requires authentication)
           $password : password (if proxy requires authentication)

 Title   : clear_proxy
 Usage   : my $old_prozy = $db->clear_proxy('http')
 Function: Unsets (clears) the proxy for the protocol indicated 
 Returns : a string indicating the old proxy value
 Args    : $protocol : string for the protocol to clear

 Title   : authentication
 Usage   : $db->authentication($user,$pass)
 Function: Get/Set authentication credentials
 Returns : Array of user/pass 
 Args    : Array or user/pass
2020-10-28 perl v5.30.3