- Notifications
You must be signed in to change notification settings - Fork270
Addressable is an alternative implementation to the URI implementation that is part of Ruby's standard library. It is flexible, offers heuristic parsing, and additionally provides extensive support for IRIs and URI templates.
License
sporkmonger/addressable
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
- Homepage
- github.com/sporkmonger/addressable
- Author
- Bob Aman
- Copyright
- Copyright © Bob Aman
- License
- Apache 2.0
Addressable is an alternative implementation to the URI implementationthat is part of Ruby's standard library. It is flexible, offers heuristicparsing, and additionally provides extensive support for IRIs and URI templates.
Addressable closely conforms to RFC 3986, RFC 3987, and RFC 6570 (level 4).
- {Addressable::URI}
- {Addressable::Template}
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/>
For more details, seeRFC 6570.
require"addressable/template"template=Addressable::Template.new("http://example.com/{?query*}")template.expand({"query"=>{'foo'=>'bar','color'=>'red'}})#=> #<Addressable::URI:0xc9d95c URI:http://example.com/?foo=bar&color=red>template=Addressable::Template.new("http://example.com/{?one,two,three}")template.partial_expand({"one"=>"1","three"=>3}).pattern#=> "http://example.com/?one=1{&two}&three=3"template=Addressable::Template.new("http://{host}{/segments*}/{?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"# }
$gem install addressableYou may optionally turn on native IDN support by installing libidn and theidn gem:
$sudo apt-get install libidn11-dev# Debian/Ubuntu$brew install libidn# OS X$gem install idn-ruby
This project usesSemantic Versioning. You can (and should) specify yourdependency using a pessimistic version constraint covering the major and minorvalues:
spec.add_dependency'addressable','~> 2.7'
If you need a specific bug fix, you can also specify minimum tiny versionswithout preventing updates to the latest minor release:
spec.add_dependency'addressable','~> 2.3','>= 2.3.7'
About
Addressable is an alternative implementation to the URI implementation that is part of Ruby's standard library. It is flexible, offers heuristic parsing, and additionally provides extensive support for IRIs and URI templates.