SimpleIDN ruby gem
Ruby
Latest commit 007b5c7 Apr 13, 2016 @mmriis closes #9
Permalink
Failed to load latest commit information.
lib closes #9 Apr 12, 2016
spec closes #9 Apr 12, 2016
.gitignore Add Bundler support Feb 14, 2016
Gemfile Add Bundler support Feb 14, 2016
LICENCE year Nov 22, 2013
README.rdoc closes #9 Apr 12, 2016
Rakefile Add Bundler support Feb 14, 2016
simpleidn.gemspec Add Bundler support Feb 14, 2016

README.rdoc

SimpleIDN

This gem allows easy conversion from punycode ACE strings to unicode UTF-8 strings and visa versa.

The implementation is heavily based on the RFC3492 C example implementation but simplified since it does not preserve case.

This gem works with Ruby 1.8.7, 1.9.2, 1.9.3, 2.0, 2.1, 2.2.

Installation

[sudo] gem install simpleidn

sudo is optional depending on your setup.

In your Ruby script you can now.

require 'rubygems'
require 'simpleidn'

SimpleIDN.to_unicode("xn--mllerriis-l8a.com")
=> "møllerriis.com"

SimpleIDN.to_ascii(“møllerriis.com”)

=> "xn--mllerriis-l8a.com"

Testing / RSpec

In order to run the test suite you must have rspec installed.

The test suite has been copied from the IDN gem and uses examples from JOSEFSSON test vectors, taken from DRAFT-JOSEFSSON-IDN-TEST-VECTORS-00: www.gnu.org/software/libidn/draft-josefsson-idn-test-vectors.html

Known issues

Does not preserve uppercase. So if, for some reason, you use uppercase characters (eg. Ø instead of ø), please take note of that.

Please report any issues!