Maintenance of Ruby 2.0.0 ended on February 24, 2016. Read more

In Files

  • open-uri.rb


OpenURI is an easy-to-use wrapper for Net::HTTP, Net::HTTPS and Net::FTP.


It is possible to open an http, https or ftp URL as though it were a file:

open("") {|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 OpenURI::Meta.

open("") {|f|
  f.each_line {|line| p line}
  p f.base_uri         # <URI::HTTP:0x40e6ef2 URL:>
  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.

  "User-Agent" => "Ruby/#{RUBY_VERSION}",
  "From" => "foo@bar.invalid",
  "Referer" => "") {|f|
  # ...

The environment variables such as http_proxy, https_proxy and ftp_proxy are in effect by default. Here we disable proxy:

open("", :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("") {|f|
  # ...

URI objects can be read directly. The returned string is also extended by OpenURI::Meta.

str =
p str.base_uri

Tanaka Akira <>