Andrew Main (Zefram) > Net-HTTP-Tiny-0.001 > Net::HTTP::Tiny

Download:
Net-HTTP-Tiny-0.001.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 0.001   Source  

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.

syntax highlighting: