Results for: "uri"

URI is a module providing classes to handle Uniform Resource Identifiers (RFC2396).

Features

• Uniform way of handling URIs.

• Flexibility to introduce custom URI schemes.

• Flexibility to have an alternate URI::Parser (or just different patterns and regexp’s).

Basic example

require 'uri'

uri = URI("http://foo.com/posts?id=30&limit=5#time=1305298413")
#=> #<URI::HTTP http://foo.com/posts?id=30&limit=5#time=1305298413>

uri.scheme    #=> "http"
uri.host      #=> "foo.com"
uri.path      #=> "/posts"
uri.query     #=> "id=30&limit=5"
uri.fragment  #=> "time=1305298413"

uri.to_s      #=> "http://foo.com/posts?id=30&limit=5#time=1305298413"

Adding custom URIs

module URI
  class RSYNC < Generic
    DEFAULT_PORT = 873
  end
  register_scheme 'RSYNC', RSYNC
end
#=> URI::RSYNC

URI.scheme_list
#=> {"FILE"=>URI::File, "FTP"=>URI::FTP, "HTTP"=>URI::HTTP,
#    "HTTPS"=>URI::HTTPS, "LDAP"=>URI::LDAP, "LDAPS"=>URI::LDAPS,
#    "MAILTO"=>URI::MailTo, "RSYNC"=>URI::RSYNC}

uri = URI("rsync://rsync.foo.com")
#=> #<URI::RSYNC rsync://rsync.foo.com>

RFC References

A good place to view an RFC spec is www.ietf.org/rfc.html.

Here is a list of all related RFC’s:

• RFC822

• RFC1738

• RFC2255

• RFC2368

• RFC2373

• RFC2396

• RFC2732

• RFC3986

Class tree

• URI::Generic (in uri/generic.rb)

  • URI::File - (in uri/file.rb)

  • URI::FTP - (in uri/ftp.rb)

  • URI::HTTP - (in uri/http.rb)

    • URI::HTTPS - (in uri/https.rb)

  • URI::LDAP - (in uri/ldap.rb)

    • URI::LDAPS - (in uri/ldaps.rb)

  • URI::MailTo - (in uri/mailto.rb)

• URI::Parser - (in uri/common.rb)

• URI::REGEXP - (in uri/common.rb)

  • URI::REGEXP::PATTERN - (in uri/common.rb)

• URI::Util - (in uri/common.rb)

• URI::Error - (in uri/common.rb)

  • URI::InvalidURIError - (in uri/common.rb)

  • URI::InvalidComponentError - (in uri/common.rb)

  • URI::BadURIError - (in uri/common.rb)

Copyright Info

Author

Akira Yamada <akira@ruby-lang.org>

Documentation

Akira Yamada <akira@ruby-lang.org> Dmitry V. Sabanin <sdmitry@lrn.ru> Vincent Batts <vbatts@hashbangbash.com>

License

Copyright © 2001 akira yamada <akira@ruby-lang.org> You can redistribute it and/or modify it under the same term as Ruby.

The Uri handles rubygems source URIs.

Not a URI.

URI is valid, bad usage is not.

Base class for all URI classes. Implements generic URI syntax as per RFC 2396.

The syntax of HTTP URIs is defined in RFC1738 section 3.3.

Note that the Ruby URI library allows HTTP URLs containing usernames and passwords. This is not legal as per the RFC, but used to be supported in Internet Explorer 5 and 6, before the MS04-004 security update. See <URL:support.microsoft.com/kb/834489>.

FTP URI syntax is defined by RFC1738 section 3.2.

This class will be redesigned because of difference of implementations; the structure of its path. draft-hoffman-ftp-uri-04 is a draft but it is a good summary about the de facto spec. tools.ietf.org/html/draft-hoffman-ftp-uri-04

Base class for all URI exceptions.

Not a URI component.

The “file” URI is defined by RFC8089.

The default port for HTTPS URIs is 443, and the scheme is ‘https:’ rather than ‘http:’. Other than that, HTTPS URIs are identical to HTTP URIs; see URI::HTTP.

LDAP URI SCHEMA (described in RFC2255).

The default port for LDAPS URIs is 636, and the scheme is ‘ldaps:’ rather than ‘ldap:’. Other than that, LDAPS URIs are identical to LDAP URIs; see URI::LDAP.

RFC6068, the mailto URL scheme.

Class that parses String’s into URI’s.

It contains a Hash set of patterns and Regexp’s that match and validate.

The syntax of WS URIs is defined in RFC6455 section 3.

Note that the Ruby URI library allows WS URLs containing usernames and passwords. This is not legal as per the RFC, but used to be supported in Internet Explorer 5 and 6, before the MS04-004 security update. See <URL:support.microsoft.com/kb/834489>.

The default port for WSS URIs is 443, and the scheme is ‘wss:’ rather than ‘ws:’. Other than that, WSS URIs are identical to WS URIs; see URI::WS.

Includes URI::REGEXP::PATTERN

Class that parses String’s into URI’s.

It contains a Hash set of patterns and Regexp’s that match and validate.

Includes URI::REGEXP::PATTERN

Patterns used to parse URI’s

Description

Returns the full path for an HTTP request, as required by Net::HTTP::Get.

If the URI contains a query, the full path is URI#path + ‘?’ + URI#query. Otherwise, the path is simply URI#path.

Example:

uri = URI::HTTP.build(path: '/foo/bar', query: 'test=true')
uri.request_uri #  => "/foo/bar?test=true"

Description

Returns the full path for a WS URI, as required by Net::HTTP::Get.

If the URI contains a query, the full path is URI#path + ‘?’ + URI#query. Otherwise, the path is simply URI#path.

Example:

uri = URI::WS.build(path: '/foo/bar', query: 'test=true')
uri.request_uri #  => "/foo/bar?test=true"

Returns uri converted to an URI object.