SYNOPSIS

    use IO::All;

    $content < io('http://example.org');             # GET webpage into scalar
    io('http://example.org') > io('index.html');     # GET to file
    "hello\n" > io('http://example.org/index.html'); # PUT webpage

    # two ways of getting a page with a password:
    $content < io('http://me:[email protected]');
    $content < io('http://example.org')->user('me')->password('secret');

DESCRIPTION

This module extends IO::All for dealing with \s-1HTTP\s0 URLs. Note that you don't need to use it explicitly, as it is autoloaded by IO::All whenever it sees something that looks like an \s-1HTTP\s0 \s-1URL\s0.

The \s-1SYNOPSIS\s0 shows some simple typical examples, but there are many other interesting combinations with other IO::All features! For example, you can get an \s-1HTTP\s0 \s-1URL\s0 and write the content to a socket, or to an \s-1FTP\s0 \s-1URL\s0, of to a \s-1DBM\s0 file.

METHODS

This is a subclass of IO::All::LWP. The only new method is \*(C`http\*(C', which can be used to create a blank IO::All::HTTP object; or it can also take an \s-1HTTP\s0 \s-1URL\s0 as a parameter. Note that in most cases it is simpler just to call io('http://example.com'), which calls the \*(C`http\*(C' method automatically.

OPERATOR OVERLOADING

The same operators from IO::All may be used. < GETs an \s-1HTTP\s0 \s-1URL\s0; > PUTs to an \s-1HTTP\s0 \s-1URL\s0.

RELATED TO IO::All::HTTP…

IO::All, IO::All::LWP, \s-1LWP\s0.

AUTHORS

Ivan Tubert-Brohman <[email protected]> and Brian Ingerson <[email protected]>

COPYRIGHT

Copyright (c) 2007. Ivan Tubert-Brohman and Brian Ingerson. All rights reserved.

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

See <http://www.perl.com/perl/misc/Artistic.html>