Results for: "uri"

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

Features

• Uniform handling 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:0x00000000b14880
      URL: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
  @@schemes['RSYNC'] = RSYNC
end
#=> URI::RSYNC

URI.scheme_list
#=> {"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:0x00000000f648c8 URL: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::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::Escape - (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.

Revision

$Id: uri.rb 53141 2015-12-16 05:07:31Z naruse $

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 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) ldap://<host>/<dn>[?<attrs>[?<scope>[?<filter>]]]

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.

module for escaping unsafe characters with codes.

Includes URI::REGEXP::PATTERN

The URI of the person or entity.

Reference: validator.w3.org/feed/docs/rfc4287.html#element.uri

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:

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

Returns uri converted to a URI object.

Returns uri converted to a URI object.

Get the URI defining the local dRuby space.

This is the URI of the current server. See current_server.

Get the URI defining the local dRuby space.

This is the URI of the current server. See current_server.