Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A fast URI parser that wraps Google's chromium URL canonicalization library
C++ Ruby C



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.


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


require 'uri_parser'

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

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


Copyright 2011 SEOmoz. See LICENSE for details.

google-url is copyright Google.

Something went wrong with that request. Please try again.