Base class for all Bundler::URI
classes. Implements generic Bundler::URI
syntax as per RFC 2396.
An Array of the available components for Bundler::URI::Generic
.
A Default port of nil for Bundler::URI::Generic
.
Returns the fragment component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz?search=FooBar#ponies").fragment #=> "ponies"
Returns the host component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz").host #=> "foo"
It returns nil if no host component exists.
Bundler::URI("mailto:foo@example.org").host #=> nil
The component does not contain the port number.
Bundler::URI("http://foo:8080/bar/baz").host #=> "foo"
Since IPv6 addresses are wrapped with brackets in URIs, this method returns IPv6 addresses wrapped with brackets. This form is not appropriate to pass to socket methods such as TCPSocket.open. If unwrapped host names are required, use the hostname
method.
Bundler::URI("http://[::1]/bar/baz").host #=> "[::1]" Bundler::URI("http://[::1]/bar/baz").hostname #=> "::1"
Returns the opaque part of the Bundler::URI
.
Bundler::URI("mailto:foo@example.org").opaque #=> "foo@example.org" Bundler::URI("http://foo/bar/baz").opaque #=> nil
The portion of the path that does not make use of the slash '/'. The path typically refers to an absolute path or an opaque part. (See RFC2396 Section 3 and 5.2.)
Returns the path component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz").path #=> "/bar/baz"
Returns the port component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz").port #=> 80 Bundler::URI("http://foo:8080/bar/baz").port #=> 8080
Returns the query component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz?search=FooBar").query #=> "search=FooBar"
Returns the scheme component of the Bundler::URI
.
Bundler::URI("http://foo/bar/baz").scheme #=> "http"
See ::new
.
Creates a new Bundler::URI::Generic
instance from components of Bundler::URI::Generic
with check. Components are: scheme, userinfo, host, port, registry, path, opaque, query, and fragment. You can provide arguments either by an Array or a Hash. See ::new
for hash keys to use or for order of array items.
# File bundler/vendor/uri/lib/uri/generic.rb, line 117 def self.build(args) if args.kind_of?(Array) && args.size == ::Bundler::URI::Generic::COMPONENT.size tmp = args.dup elsif args.kind_of?(Hash) tmp = ::Bundler::URI::Generic::COMPONENT.collect do |c| if args.include?(c) args[c] else nil end end else component = self.class.component rescue ::Bundler::URI::Generic::COMPONENT raise ArgumentError, "expected Array of or Hash of components of #{self.class} (#{component.join(', ')})" end tmp << nil tmp << true return self.new(*tmp) end
See ::new
.
At first, tries to create a new Bundler::URI::Generic
instance using Bundler::URI::Generic::build
. But, if exception Bundler::URI::InvalidComponentError
is raised, then it does Bundler::URI::Escape.escape
all Bundler::URI
components and tries again.
# File bundler/vendor/uri/lib/uri/generic.rb, line 79 def self.build2(args) begin return self.build(args) rescue InvalidComponentError if args.kind_of?(Array) return self.build(args.collect{|x| if x.is_a?(String) DEFAULT_PARSER.escape(x) else x end }) elsif args.kind_of?(Hash) tmp = {} args.each do |key, value| tmp[key] = if value DEFAULT_PARSER.escape(value) else value end end return self.build(tmp) end end end
Components of the Bundler::URI
in the order.
# File bundler/vendor/uri/lib/uri/generic.rb, line 58 def self.component self::COMPONENT end
Returns default port.
# File bundler/vendor/uri/lib/uri/generic.rb, line 33 def self.default_port self::DEFAULT_PORT end
scheme
Protocol scheme, i.e. 'http','ftp','mailto' and so on.
userinfo
User name and password, i.e. 'sdmitry:bla'.
host
Server host name.
port
Server port.
registry
Registry of naming authorities.
path
Path on server.
opaque
Opaque part.
query
Query data.
fragment
Part of the Bundler::URI
after '#' character.
parser
Parser
for internal use [Bundler::URI::DEFAULT_PARSER by default].
arg_check
Check arguments [false by default].
Creates a new Bundler::URI::Generic
instance from “generic'' components without check.
# File bundler/vendor/uri/lib/uri/generic.rb, line 170 def initialize(scheme, userinfo, host, port, registry, path, opaque, query, fragment, parser = DEFAULT_PARSER, arg_check = false) @scheme = nil @user = nil @password = nil @host = nil @port = nil @path = nil @query = nil @opaque = nil @fragment = nil @parser = parser == DEFAULT_PARSER ? nil : parser if arg_check self.scheme = scheme self.userinfo = userinfo self.hostname = host self.port = port self.path = path self.query = query self.opaque = opaque self.fragment = fragment else self.set_scheme(scheme) self.set_userinfo(userinfo) self.set_host(host) self.set_port(port) self.set_path(path) self.query = query self.set_opaque(opaque) self.fragment=(fragment) end if registry raise InvalidURIError, "the scheme #{@scheme} does not accept registry part: #{registry} (or bad hostname?)" end @scheme&.freeze self.set_path('') if !@path && !@opaque # (see RFC2396 Section 5.2) self.set_port(self.default_port) if self.default_port && !@port end
Compares two URIs.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1374 def ==(oth) if self.class == oth.class self.normalize.component_ary == oth.normalize.component_ary else false end end
Returns true if Bundler::URI
has a scheme (e.g. http:// or https://) specified.
# File bundler/vendor/uri/lib/uri/generic.rb, line 963 def absolute? if @scheme true else false end end
v
Bundler::URI
or String
Attempts to parse other Bundler::URI
oth
, returns [parsed_oth, self].
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.coerce("http://foo.com") #=> [#<Bundler::URI::HTTP http://foo.com>, #<Bundler::URI::HTTP http://my.example.com>]
# File bundler/vendor/uri/lib/uri/generic.rb, line 1464 def coerce(oth) case oth when String oth = parser.parse(oth) else super end return oth, self end
Components of the Bundler::URI
in the order.
# File bundler/vendor/uri/lib/uri/generic.rb, line 314 def component self.class.component end
Returns default port.
# File bundler/vendor/uri/lib/uri/generic.rb, line 40 def default_port self.class.default_port end
# File bundler/vendor/uri/lib/uri/generic.rb, line 1386 def eql?(oth) self.class == oth.class && parser == oth.parser && self.component_ary.eql?(oth.component_ary) end
Returns a proxy Bundler::URI
. The proxy Bundler::URI
is obtained from environment variables such as http_proxy, ftp_proxy, no_proxy, etc. If there is no proper proxy, nil is returned.
If the optional parameter env
is specified, it is used instead of ENV.
Note that capitalized variables (HTTP_PROXY, FTP_PROXY, NO_PROXY, etc.) are examined, too.
But http_proxy and HTTP_PROXY is treated specially under CGI environment. It's because HTTP_PROXY may be set by Proxy: header. So HTTP_PROXY is not used. http_proxy is not used too if the variable is case insensitive. CGI_HTTP_PROXY can be used instead.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1490 def find_proxy(env=ENV) raise BadURIError, "relative Bundler::URI: #{self}" if self.relative? name = self.scheme.downcase + '_proxy' proxy_uri = nil if name == 'http_proxy' && env.include?('REQUEST_METHOD') # CGI? # HTTP_PROXY conflicts with *_proxy for proxy settings and # HTTP_* for header information in CGI. # So it should be careful to use it. pairs = env.reject {|k, v| /\Ahttp_proxy\z/i !~ k } case pairs.length when 0 # no proxy setting anyway. proxy_uri = nil when 1 k, _ = pairs.shift if k == 'http_proxy' && env[k.upcase] == nil # http_proxy is safe to use because ENV is case sensitive. proxy_uri = env[name] else proxy_uri = nil end else # http_proxy is safe to use because ENV is case sensitive. proxy_uri = env.to_hash[name] end if !proxy_uri # Use CGI_HTTP_PROXY. cf. libwww-perl. proxy_uri = env["CGI_#{name.upcase}"] end elsif name == 'http_proxy' unless proxy_uri = env[name] if proxy_uri = env[name.upcase] warn 'The environment variable HTTP_PROXY is discouraged. Use http_proxy.', uplevel: 1 end end else proxy_uri = env[name] || env[name.upcase] end if proxy_uri.nil? || proxy_uri.empty? return nil end if self.hostname begin addr = IPSocket.getaddress(self.hostname) return nil if /\A127\.|\A::1\z/ =~ addr rescue SocketError end end name = 'no_proxy' if no_proxy = env[name] || env[name.upcase] return nil unless Bundler::URI::Generic.use_proxy?(self.hostname, addr, self.port, no_proxy) end Bundler::URI.parse(proxy_uri) end
Checks the fragment v
component against the Bundler::URI::Parser
Regexp for :FRAGMENT.
v
String
Public setter for the fragment component v
(with validation).
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com/?id=25#time=1305212049") uri.fragment = "time=1305212086" uri.to_s #=> "http://my.example.com/?id=25#time=1305212086"
# File bundler/vendor/uri/lib/uri/generic.rb, line 920 def fragment=(v) return @fragment = nil unless v x = v.to_str v = x.dup if x.equal? v v.encode!(Encoding::UTF_8) rescue nil v.delete!("\t\r\n") v.force_encoding(Encoding::ASCII_8BIT) v.gsub!(/(?!%\h\h|[!-~])./n){'%%%02X' % $&.ord} v.force_encoding(Encoding::US_ASCII) @fragment = v end
# File bundler/vendor/uri/lib/uri/generic.rb, line 1382 def hash self.component_ary.hash end
Returns true if Bundler::URI
is hierarchical.
Bundler::URI
has components listed in order of decreasing significance from left to right, see RFC3986 tools.ietf.org/html/rfc3986 1.2.3.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com/") uri.hierarchical? #=> true uri = Bundler::URI.parse("mailto:joe@example.com") uri.hierarchical? #=> false
# File bundler/vendor/uri/lib/uri/generic.rb, line 952 def hierarchical? if @path true else false end end
v
String
Public setter for the host component v
(with validation).
See also Bundler::URI::Generic.check_host.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.host = "foo.com" uri.to_s #=> "http://foo.com"
# File bundler/vendor/uri/lib/uri/generic.rb, line 630 def host=(v) check_host(v) set_host(v) v end
Extract the host part of the Bundler::URI
and unwrap brackets for IPv6 addresses.
This method is the same as Bundler::URI::Generic#host
except brackets for IPv6 (and future IP) addresses are removed.
uri = Bundler::URI("http://[::1]/bar") uri.hostname #=> "::1" uri.host #=> "[::1]"
# File bundler/vendor/uri/lib/uri/generic.rb, line 645 def hostname v = self.host /\A\[(.*)\]\z/ =~ v ? $1 : v end
Sets the host part of the Bundler::URI
as the argument with brackets for IPv6 addresses.
This method is the same as Bundler::URI::Generic#host=
except the argument can be a bare IPv6 address.
uri = Bundler::URI("http://foo/bar") uri.hostname = "::1" uri.to_s #=> "http://[::1]/bar"
If the argument seems to be an IPv6 address, it is wrapped with brackets.
# File bundler/vendor/uri/lib/uri/generic.rb, line 662 def hostname=(v) v = "[#{v}]" if /\A\[.*\]\z/ !~ v && /:/ =~ v self.host = v end
# File bundler/vendor/uri/lib/uri/generic.rb, line 1441 def inspect "#<#{self.class} #{self}>" end
oth
Bundler::URI
or String
Merges two URIs.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.merge("/main.rbx?page=1") # => "http://my.example.com/main.rbx?page=1"
# File bundler/vendor/uri/lib/uri/generic.rb, line 1100 def merge(oth) rel = parser.send(:convert_to_uri, oth) if rel.absolute? #raise BadURIError, "both Bundler::URI are absolute" if absolute? # hmm... should return oth for usability? return rel end unless self.absolute? raise BadURIError, "both Bundler::URI are relative" end base = self.dup authority = rel.userinfo || rel.host || rel.port # RFC2396, Section 5.2, 2) if (rel.path.nil? || rel.path.empty?) && !authority && !rel.query base.fragment=(rel.fragment) if rel.fragment return base end base.query = nil base.fragment=(nil) # RFC2396, Section 5.2, 4) if !authority base.set_path(merge_path(base.path, rel.path)) if base.path && rel.path else # RFC2396, Section 5.2, 4) base.set_path(rel.path) if rel.path end # RFC2396, Section 5.2, 7) base.set_userinfo(rel.userinfo) if rel.userinfo base.set_host(rel.host) if rel.host base.set_port(rel.port) if rel.port base.query = rel.query if rel.query base.fragment=(rel.fragment) if rel.fragment return base end
oth
Bundler::URI
or String
Destructive form of merge
.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.merge!("/main.rbx?page=1") uri.to_s # => "http://my.example.com/main.rbx?page=1"
# File bundler/vendor/uri/lib/uri/generic.rb, line 1072 def merge!(oth) t = merge(oth) if self == t nil else replace!(t) self end end
Returns normalized Bundler::URI
.
require 'bundler/vendor/uri/lib/uri' Bundler::URI("HTTP://my.EXAMPLE.com").normalize #=> #<Bundler::URI::HTTP http://my.example.com/>
Normalization here means:
scheme and host are converted to lowercase,
an empty path component is set to “/”.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1310 def normalize uri = dup uri.normalize! uri end
Destructive version of normalize
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1319 def normalize! if path&.empty? set_path('/') end if scheme && scheme != scheme.downcase set_scheme(self.scheme.downcase) end if host && host != host.downcase set_host(self.host.downcase) end end
Returns the parser to be used.
Unless a Bundler::URI::Parser
is defined, DEFAULT_PARSER is used.
# File bundler/vendor/uri/lib/uri/generic.rb, line 290 def parser if !defined?(@parser) || !@parser DEFAULT_PARSER else @parser || DEFAULT_PARSER end end
Returns the password component.
# File bundler/vendor/uri/lib/uri/generic.rb, line 574 def password @password end
v
String
Public setter for the password
component (with validation).
See also Bundler::URI::Generic.check_password.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://john:S3nsit1ve@my.example.com") uri.password = "V3ry_S3nsit1ve" uri.to_s #=> "http://john:V3ry_S3nsit1ve@my.example.com"
# File bundler/vendor/uri/lib/uri/generic.rb, line 499 def password=(password) check_password(password) set_password(password) # returns password end
v
String
Public setter for the path component v
(with validation).
See also Bundler::URI::Generic.check_path.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com/pub/files") uri.path = "/faq/" uri.to_s #=> "http://my.example.com/faq/"
# File bundler/vendor/uri/lib/uri/generic.rb, line 806 def path=(v) check_path(v) set_path(v) v end
v
String
Public setter for the port component v
(with validation).
See also Bundler::URI::Generic.check_port.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.port = 8080 uri.to_s #=> "http://my.example.com:8080"
# File bundler/vendor/uri/lib/uri/generic.rb, line 720 def port=(v) check_port(v) set_port(v) port end
v
String
Public setter for the query component v
.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com/?id=25") uri.query = "id=1" uri.to_s #=> "http://my.example.com/?id=1"
# File bundler/vendor/uri/lib/uri/generic.rb, line 830 def query=(v) return @query = nil unless v raise InvalidURIError, "query conflicts with opaque" if @opaque x = v.to_str v = x.dup if x.equal? v v.encode!(Encoding::UTF_8) rescue nil v.delete!("\t\r\n") v.force_encoding(Encoding::ASCII_8BIT) raise InvalidURIError, "invalid percent escape: #{$1}" if /(%\H\H)/n.match(v) v.gsub!(/(?!%\h\h|[!$-&(-;=?-_a-~])./n.freeze){'%%%02X' % $&.ord} v.force_encoding(Encoding::US_ASCII) @query = v end
# File bundler/vendor/uri/lib/uri/generic.rb, line 736 def registry=(v) raise InvalidURIError, "can not set registry" end
Returns true if Bundler::URI
does not have a scheme (e.g. http:// or https://) specified.
# File bundler/vendor/uri/lib/uri/generic.rb, line 975 def relative? !absolute? end
oth
Bundler::URI
or String
Calculates relative path from oth to self.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse('http://my.example.com/main.rbx?page=1') uri.route_from('http://my.example.com') #=> #<Bundler::URI::Generic /main.rbx?page=1>
# File bundler/vendor/uri/lib/uri/generic.rb, line 1253 def route_from(oth) # you can modify `rel', but can not `oth'. begin oth, rel = route_from0(oth) rescue raise $!.class, $!.message end if oth == rel return rel end rel.set_path(route_from_path(oth.path, self.path)) if rel.path == './' && self.query # "./?foo" -> "?foo" rel.set_path('') end return rel end
oth
Bundler::URI
or String
Calculates relative path to oth from self.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse('http://my.example.com') uri.route_to('http://my.example.com/main.rbx?page=1') #=> #<Bundler::URI::Generic /main.rbx?page=1>
# File bundler/vendor/uri/lib/uri/generic.rb, line 1293 def route_to(oth) parser.send(:convert_to_uri, oth).route_from(self) end
v
String
Public setter for the scheme component v
(with validation).
See also Bundler::URI::Generic.check_scheme.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://my.example.com") uri.scheme = "https" uri.to_s #=> "https://my.example.com"
# File bundler/vendor/uri/lib/uri/generic.rb, line 361 def scheme=(v) check_scheme(v) set_scheme(v) v end
components
Multiple Symbol arguments defined in Bundler::URI::HTTP
.
Selects specified components from Bundler::URI
.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse('http://myuser:mypass@my.example.com/test.rbx') uri.select(:userinfo, :host, :path) # => ["myuser:mypass", "my.example.com", "/test.rbx"]
# File bundler/vendor/uri/lib/uri/generic.rb, line 1430 def select(*components) components.collect do |c| if component.include?(c) self.send(c) else raise ArgumentError, "expected of components of #{self.class} (#{self.class.component.join(', ')})" end end end
Constructs String from Bundler::URI
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1334 def to_s str = ''.dup if @scheme str << @scheme str << ':' end if @opaque str << @opaque else if @host || %w[file postgres].include?(@scheme) str << '//' end if self.userinfo str << self.userinfo str << '@' end if @host str << @host end if @port && @port != self.default_port str << ':' str << @port.to_s end str << @path if @query str << '?' str << @query end end if @fragment str << '#' str << @fragment end str end
Returns the user component.
# File bundler/vendor/uri/lib/uri/generic.rb, line 569 def user @user end
v
String
Public setter for the user
component (with validation).
See also Bundler::URI::Generic.check_user.
require 'bundler/vendor/uri/lib/uri' uri = Bundler::URI.parse("http://john:S3nsit1ve@my.example.com") uri.user = "sam" uri.to_s #=> "http://sam:V3ry_S3nsit1ve@my.example.com"
# File bundler/vendor/uri/lib/uri/generic.rb, line 472 def user=(user) check_user(user) set_user(user) # returns user end
Returns an Array of the components defined from the COMPONENT
Array.
# File bundler/vendor/uri/lib/uri/generic.rb, line 1406 def component_ary component.collect do |x| self.send(x) end end
Protected setter for the host component v
.
See also Bundler::URI::Generic.host=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 604 def set_host(v) @host = v end
Protected setter for the opaque component v
.
See also Bundler::URI::Generic.opaque=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 874 def set_opaque(v) @opaque = v end
Protected setter for the password component v
.
See also Bundler::URI::Generic.password=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 535 def set_password(v) @password = v # returns v end
Protected setter for the path component v
.
See also Bundler::URI::Generic.path=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 780 def set_path(v) @path = v end
Protected setter for the port component v
.
See also Bundler::URI::Generic.port=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 693 def set_port(v) v = v.empty? ? nil : v.to_i unless !v || v.kind_of?(Integer) @port = v end
Protected setter for the scheme component v
.
See also Bundler::URI::Generic.scheme=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 335 def set_scheme(v) @scheme = v&.downcase end
Protected setter for the user component v
.
See also Bundler::URI::Generic.user=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 525 def set_user(v) set_userinfo(v, @password) v end
Protected setter for the user
component, and password
if available (with validation).
See also Bundler::URI::Generic.userinfo=
.
# File bundler/vendor/uri/lib/uri/generic.rb, line 510 def set_userinfo(user, password = nil) unless password user, password = split_userinfo(user) end @user = user @password = password if password [@user, @password] end