Module: OpenURI
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Exceptions:
| |
Defined in: | lib/open-uri.rb |
Overview
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:
open("http://www.ruby-lang.org/") {|f|
f.each_line {|line| p line}
}
The opened file has several getter methods for its meta-information, as follows, since it is extended by Meta.
open("http://www.ruby-lang.org/en") {|f|
f.each_line {|line| p line}
p f.base_uri # <URI::HTTP:0x40e6ef2 URL:http://www.ruby-lang.org/en/>
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.
open("http://www.ruby-lang.org/en/",
"User-Agent" => "Ruby/#{RUBY_VERSION}",
"From" => "foo@bar.invalid",
"Referer" => "http://www.ruby-lang.org/") {|f|
# ...
}
The environment variables such as http_proxy, https_proxy and ftp_proxy are in effect by default. Here we disable proxy:
open("http://www.ruby-lang.org/en/", :proxy => nil) {|f|
# ...
}
See OpenURI::OpenRead.open
and Kernel.open for more on available options.
::URI objects can be opened in a similar way.
uri = URI.parse("http://www.ruby-lang.org/en/")
uri.open {|f|
# ...
}
::URI objects can be read directly. The returned string is also extended by Meta.
str = uri.read
p str.base_uri
- Author
-
Tanaka Akira <akr@m17n.org>
Constant Summary
-
Options =
# File 'lib/open-uri.rb', line 99{ :proxy => true, :proxy_http_basic_authentication => true, :progress_proc => true, :content_length_proc => true, :http_basic_authentication => true, :read_timeout => true, :open_timeout => true, :ssl_ca_cert => nil, :ssl_verify_mode => nil, :ftp_active_mode => false, :redirect => true, }