Type:
Module
Constants:
Options
:
{
:proxy => true,
:proxy_http_basic_authentication => true,
:progress_proc => true,
:content_length_proc => true,
:http_basic_authentication => true,
:read_timeout => true,
:ssl_ca_cert => nil,
:ssl_verify_mode => nil,
:ftp_active_mode => false,
:redirect => true,
}
OpenURI is an easy-to-use wrapper for Net::HTTP, Net::HTTPS and Net::FTP.
Example
It is possible to open an http, https or ftp URL as though it were a file:
1 2 3 |
The opened file has several getter methods for its meta-information, as follows, since it is extended by OpenURI::Meta.
1 2 3 4 5 6 7 8 | f.each_line {|line| p line} p f.content_type # "text/html" p f.charset # "iso-8859-1" p f.content_encoding # [] p f.last_modified # Thu Dec 05 02:45:02 UTC 2002} |
Additional header fields can be specified by an optional hash argument.
1 2 3 4 5 6 | "User-Agent" => "Ruby/#{RUBY_VERSION}", "From" => "foo@bar.invalid", # ...} |
The environment variables such as http_proxy, https_proxy and ftp_proxy are in effect by default. Here we disable proxy:
1 2 3 |
See OpenURI::OpenRead#open and Kernel#open for more on available options.
URI objects can be opened in a similar way.
1 2 3 4 |
URI objects can be read directly. The returned string is also extended by OpenURI::Meta.
1 2 | str = uri.readp str.base_uri |
- Author
-
Tanaka Akira <akr@m17n.org>