public
Description: Addressable is a replacement for the URI implementation that is part of Ruby's standard library. It more closely conforms to the relevant RFCs and adds support for IRIs and URI templates.
Homepage: http://addressable.rubyforge.org/
Clone URL: git://github.com/sporkmonger/addressable.git
sporkmonger (author)
Sun Nov 01 14:27:03 -0800 2009
commit  c28cd8106c080d718fe9e67ba4c7246b4c5a2800
tree    059ca9e49885bbe9deefbbafa16e3a2392ca1f69
parent  f33fadf0a7fc0f311ad5bc72e5f58669a7ba4667
addressable / README
100644 51 lines (42 sloc) 1.473 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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
48
49
50
51
Addressable is a replacement for the URI implementation that is part of
Ruby's standard library. It more closely conforms to the relevant RFCs and
adds support for IRIs and URI templates. Additionally, it provides extensive
support for URI templates.
 
Example usage:
 
  require "addressable/uri"
 
  uri = Addressable::URI.parse("http://example.com/path/to/resource/")
  uri.scheme
  #=> "http"
  uri.host
  #=> "example.com"
  uri.path
  #=> "/path/to/resource/"
 
  uri = Addressable::URI.parse("http://www.詹姆斯.com/")
  uri.normalize
  #=> #<Addressable::URI:0xc9a4c8 URI:http://www.xn--8ws00zhy3a.com/>
 
  require "addressable/template"
 
  template = Addressable::Template.new("http://example.com/{-list|+|query}/")
  template.expand({
    "query" => "an example query".split(" ")
  })
  #=> #<Addressable::URI:0xc9d95c URI:http://example.com/an+example+query/>
 
  template = Addressable::Template.new(
    "http://example.com/{-join|&|one,two,three}/"
  )
  template.partial_expand({"one" => "1", "three" => 3}).pattern
  #=> "http://example.com/?one=1{-prefix|&two=|two}&three=3"
 
  template = Addressable::Template.new(
    "http://{host}/{-suffix|/|segments}?{-join|&|one,two,bogus}\#{fragment}"
  )
  uri = Addressable::URI.parse(
    "http://example.com/a/b/c/?one=1&two=2#foo"
  )
  template.extract(uri)
  #=>
  # {
  # "host" => "example.com",
  # "segments" => ["a", "b", "c"],
  # "one" => "1",
  # "two" => "2",
  # "fragment" => "foo"
  # }