Andrew Main (Zefram)

NAME

Net::HTTP::Tiny - minimal HTTP client

SYNOPSIS

        use Net::HTTP::Tiny qw(http_get);

        $dat = http_get("http://maia.usno.navy.mil/ser7/tai-utc.dat");

DESCRIPTION

This module provides an easy interface to retrieve files using the HTTP protocol. The location of a file to retrieve is specified using a URL. The module conforms to HTTP/1.1, and follows redirections (up to a limit of five chained redirections). Content-MD5 is checked, if the optional module Digest::MD5 is installed. IPv6 is supported, if the optional module IO::Socket::IP is installed. Only retrieval is supported, not posting or anything more exotic.

FUNCTIONS

http_get(URL)

URL must be a URL using the http scheme. The file that it refers to is retrieved from the HTTP server, and its content is returned in the form of a string of octets. If any error occurs then the function dies. Possible errors include the URL being malformed, inability to contact the HTTP server, and the HTTP server reporting that the file doesn't exist.

BUGS

IPv6 support is largely untested. Reports of experiences with it would be appreciated.

SEE ALSO

HTTP::Tiny, IO::Socket::IP, Net::FTP::Tiny

AUTHOR

Andrew Main (Zefram) <zefram@fysh.org>

COPYRIGHT

Copyright (C) 2012 Andrew Main (Zefram) <zefram@fysh.org>

LICENSE

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