Class: URI::WinFile

Inherits:
Generic
  • Object
show all
Includes:
FileCommon
Defined in:
lib/file-uri/win.rb

Constant Summary collapse

SPECIAL = 
"\u{F03A}".freeze

Constants included from FileCommon

FileCommon::BACKSLASH, FileCommon::COLON, FileCommon::COMPONENT, FileCommon::DBL_BACKSLASH, FileCommon::DBL_SLASH, FileCommon::LOCALHOST, FileCommon::SLASH

Instance Method Summary collapse

Methods included from FileCommon

build, #local?, #open, #to_unc

Constructor Details

#initialize(scheme, userinfo, host, port, registry, path, opaque, query, fragment, parser = DEFAULT_PARSER, arg_check = false) ⇒ WinFile

Returns a new instance of WinFile.



20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/file-uri/win.rb', line 20

def initialize(scheme,
               userinfo, host, port, registry,
               path, opaque,
               query,
               fragment,
               parser = DEFAULT_PARSER,
               arg_check = false)
  # detect Windows drive letter absolute paths ("file:c:/dir/file.ext")
  if !path && opaque && opaque =~ %r[\A[A-Z]:?(?=\z|/)]i
    path = fixup(SLASH + opaque)
    path += SLASH if path.length == 3
    opaque = nil
  # detect Windows-style drive letter authorities ("file://c:/dir/file.ext")
  elsif host && host =~ %r[\A[A-Z]\z]i
    path = SLASH + host + COLON + fixup(path)
    host = nil
  # detect UNC-type paths ("file:////server/Share/dir/file.ext")
  elsif !host && path && path =~ %r[\A//+]
    path = path.sub(%r[\A/+], DBL_SLASH).gsub(COLON, SPECIAL)
    host = ''
  # ...urgh
  elsif path && path =~ %r[\A//+]
    path = fixup(path.sub(%r[\A//+], SLASH))
  else
    path = fixup(path) if path
  end
  super(scheme, userinfo, host, port, registry, path, opaque, query, fragment, parser, arg_check)
end

Instance Method Details

#merge(oth) ⇒ Object Also known as: +

Args

oth

URI or String

Description

Merges two URI’s.

Usage

require 'uri'

uri = URI.parse("http://my.example.com")
p uri.merge("/main.rbx?page=1")
# =>  #<URI::HTTP:0x2021f3b0 URL:http://my.example.com/main.rbx?page=1>



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/file-uri/win.rb', line 67

def merge(oth)
  rel = parser.send(:convert_to_uri, oth)

  if rel.absolute?
    #raise BadURIError, "both URI are absolute" if absolute?
    # hmm... should return oth for usability?
    return rel
  end

  unless self.absolute?
    raise BadURIError, "both 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
    # Difference from URI::Generic -- handle drive letter
    base_path = base.path
    rel_path = rel.path
    if base_path && rel_path
      if rel_path =~ %r[\A(\.\.(?=/|\z)|/(?![A-Z]:(/|\z)))]i && base_path.sub!(%r[\A/?[A-Z]:(?=/|\z)]i, '')
        base.set_path($~[0] + merge_path(base_path, rel_path))
      else
        base.set_path(merge_path(base_path, rel_path))
      end
    end
  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

#to_file_path(localhost: true) ⇒ Object

localhost:

* true  => 'file://localhost/' is local, 'file://example.com/' is non-local
* false => 'file://localhost/' is non-local



127
128
129
130
131
132
 
# File 'lib/file-uri/win.rb', line 127

def to_file_path localhost: true
  raise "no local path for non-local URI #{to_s}" unless local?(localhost: localhost)
  path = scrub(@path)
  #path = path.gsub(SLASH, File::SEPARATOR)
  path
end