Модуль OpenURI

OpenURI — это простая в использовании обёртка для Net::HTTP, Net::HTTPS и Net::FTP.

Пример

HTTP-, HTTPS- или FTP-URL можно открыть так, как если бы это был файл:

URI.open("http://www.ruby-lang.org/") {|f|
  f.each_line {|line| p line}
}

Открытый файл имеет несколько методов доступа к метаинформации, поскольку он расширен модулем OpenURI::Meta.

URI.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
}

Дополнительные поля заголовка можно указать с помощью необязательного аргумента в виде хеша.

URI.open("http://www.ruby-lang.org/en/",
  "User-Agent" => "Ruby/#{RUBY_VERSION}",
  "From" => "foo@bar.invalid",
  "Referer" => "http://www.ruby-lang.org/") {|f|
  # ...
}

Переменные среды, такие как http_proxy, https_proxy и ftp_proxy, по умолчанию учитываются. Здесь мы отключаем прокси:

URI.open("http://www.ruby-lang.org/en/", :proxy => nil) {|f|
  # ...
}

Подробнее о доступных параметрах см. в описаниях OpenURI::OpenRead.open и URI.open.

Объекты URI можно открыть аналогичным образом.

uri = URI.parse("http://www.ruby-lang.org/en/")
uri.open {|f|
  # ...
}

Объекты URI можно читать напрямую. Возвращённая строка также расширена модулем OpenURI::Meta.

str = uri.read
p str.base_uri

Автор

Tanaka Akira <akr@m17n.org>