URI

URI is a module providing classes to handle Uniform Resource Identifiers (RFC2396[http://tools.ietf.org/html/rfc2396]).

Features

  • Uniform way of handling URIs.
  • Flexibility to introduce custom URI schemes.
  • Flexibility to have an alternate URI::Parser (or just different patterns and regexp's).

Installation

Add this line to your application's Gemfile:

gem 'uri'

And then execute:

$ bundle

Or install it yourself as:

$ gem install uri

Usage

require 'uri'

uri = URI("http://foo.com/posts?id=30&limit=5#time=1305298413")
#=> #<URI::HTTP 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"

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/uri.