Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A fast URI parser that wraps Google's chromium URL canonicalization library

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 ext
Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rvmrc
Octocat-spinner-32 Gemfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 uri_parser.gemspec
README.md

URIParser

What?

This is a very simple native gem to Google's chromium URL canonicalization library. Google's code is is BSD-licensed.

This gem requires the ICU library. Under Linux (Ubuntu) the proper version may be installed via apt-get (e.g. apt-get install libicu-dev). Under Mac OSX it may be installed with homebrew (e.g. brew install icu4c). Note that after installing with homebrew, you will likely have to brew link icu4c. See the printout after installing the package for details. If you still have difficulty compiling this plugin after linking icu4c in homebrew your homebrew includes might not be listed in your include path for gcc. Try running export CPATH="/usr/local/include" and then installing the gem.

Why?

Addressable provides the same functionality (and more!) but is slow. This gem is much faster.

Example

require 'uri_parser'

noncan = 'http://руцентр.рф/Iñtërnâtiônàlizætiøn!?i18n=true'
url = URIParser.new(noncan)
puts <<TO_THE_END
    non-canonicalized: #{noncan}
    canonicalized: #{url.uri}
    scheme: #{url.scheme}
    host: #{url.host}
    port: #{url.port}
    path: #{url.path}
    query: #{url.query}
    valid: #{url.valid?}
TO_THE_END

Note: If a URL is marked as invalid then the state/value of any of its other properties is undefined.

Copyright

Copyright 2011 SEOmoz. See LICENSE for details.

google-url is copyright Google.

Something went wrong with that request. Please try again.