sundawg_country_codes 0.0.3 → 0.0.4

data/Manifest

@@ -1,11 +1,14 @@
-Manifest
-README
+README.rdoc
 Rakefile
 lib/countries.yml
 lib/country_iso_translater.rb
+lib/language_iso_translater.rb
+lib/languages.yml
 lib/usa_state_translater.rb
 lib/usa_states.yml
 sundawg_country_codes.gemspec
 test/country_iso_translater_test.rb
+test/language_iso_translater_test.rb
 test/test_helper.rb
 test/usa_translater_test.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,116 @@
+= SunDawg Country Codes
+
+== About
+
+This project is a Ruby gem to manage ISO 3166 country names and their corresponding alpha-2 and alpha-3 codes. Additional support has been added for ISO 4127 currency information and standard conventions for states in the USA (based on the the 3166-2:US code).
+
+Reference information can be found:
+
+ISO 3166 Country Codes
+  
+  http://en.wikipedia.org/wiki/ISO_3166-1
+
+ISO 4217 Currency Information
+
+  http://www.xe.com/iso4217.php
+  http://www.xe.com/symbols.php
+
+ISO 3166-2:US Codes
+
+  http://code.google.com/apis/chart/statecodes.html
+  http://en.wikipedia.org/wiki/ISO_3166-2:US
+
+ISO 639 Languages
+
+  http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+
+== Testing
+
+Tests can be executed by running:
+
+  rake test
+
+== Code Examples
+
+To translate from a country's name to their ISO Alpha-2 code:
+
+  SunDawg::CountryIsoTranslater.translate_iso3166_name_to_alpha2("United States")
+
+To translate from a country's name to their ISO Alpha-3 code:
+
+  SunDawg::CountryIsoTranslater.translate_iso3166_name_to_alpha3("Egypt")
+
+To translate from a country's ISO Alpha-2 code to country name:
+
+  SunDawg::CountryIsoTranslater.translate_iso3166_alpha2_to_name("US")
+
+To translate form a country's ISO Alpha-3 code to country name:
+
+  SunDawg::CountryIsoTranslater.translate_iso3166_alpha3_to_name("ESP")
+
+To obtain currency information for a country:
+
+  currency = SunDawg::CountryIsoTranslater.get_iso4217_currency_by_iso3166_alpha2("US")
+  assert_equal currency["code"], "USD"
+  assert_equal currency["symbol"], "$"
+  assert_equal currency["name"], "Dollars"
+  assert_equal currency["unicode_hex"], 36
+
+NOTE: 
+
+Not all countries have currency information and not all currency information contains both the symbol. Some currency information contain a second currency under currency["alt_currency"] which will then contain the same hash values for a currency.
+
+Furthermore, while the hex value for representing the unicode symbol is stored in the .yml file, the import into Ruby is converting it into decimal. You can convert back to hex as so:
+
+  assert_equal currency["unicode_hex"].to_s(16), "24"
+
+The unicode value, either in base 10 or base 16 will allow you to render the symbol properly in HTML:
+
+$ or $
+
+More information:
+
+  http://www.fileformat.info/info/unicode/char/0024/index.htm
+
+To build the unicode HTML for a symbol:
+
+  currency = SunDawg::CountryIsoTranslater.get_iso4217_currency_by_iso3166_alpha2("UZ")
+  assert_equal SunDawg::CountryIsoTranslater.build_html_unicode(currency["unicode_hex"]), "&#x43b&#x432"
+
+To translate to and from USA state name and the 2-digit code:
+
+  SunDawg::USAStateTranslater.translate_name_to_code('New York')
+  SunDawg::USAStateTranslater.translate_code_to_name('NY')
+
+To translate ISO-639 languages from alpha 2 code:
+
+  language = SunDawg::LanguageIsoTranslater.get_iso_639_1_translation("en")
+  assert_equal "English", language['name']
+  assert_equal "eng", language['alpha3t']
+
+NOTE: Some languages have an alternate alpha3b code per ISO-639-2/B to indicate the "B" alpha 3 letter code for the language.
+
+== Data Files
+
+All country code and names are stored in a countries.yml file that can be changed as you need. The latest codes and country names are derived from:
+
+  http://en.wikipedia.org/wiki/ISO_3166-1
+
+== Gem Install
+
+This gem is hosted on rubygems.org. 
+
+  http://rubygems.org/gems/sundawg_country_codes
+
+== Rails Install
+
+To include this gem in your Rails project, add the following to your config/environment.rb:
+
+  config.gem 'sundawg_country_codes', :lib => 'country_iso_translater'
+
+== History
+v0.0.4 - Added ISO 639 Language translater, cleaned up documents.
+v0.0.3 - Added USA State translater and cleaned up unit tests.
+v0.0.2b - Completed all currency information, unicode HTML utility, and bug fixes. Gem version re-published as 0.0.2.
+v0.0.2 - Added ISO 4217 currency information.
+v0.0.1 - Allows basic ISO 3166 translation.

data/Rakefile

@@ -3,8 +3,8 @@ require 'rubygems'
 require 'rake'
 require 'echoe'
 
-Echoe.new('sundawg_country_codes', '0.0.3') do |p|
-  p.description    = "Manage ISO 3166 Country Names and Codes."
+Echoe.new('sundawg_country_codes', '0.0.4') do |p|
+  p.description    = "Manage ISO 3166 Country Names and Codes, ISO 639 Languages, and ISO 4217 Currencies."
   p.url            = "http://github.com/SunDawg/country_codes"
   p.author         = "Christopher Sun"
   p.email          = "christopher.sun@gmail.com"

data/lib/language_iso_translater.rb

@@ -0,0 +1,30 @@
+# manages language ISO-639 information
+# http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+
+require 'yaml'
+
+module SunDawg 
+  module LanguageIsoTranslater
+    # allows client application to override YAML hash
+    FILE = File.expand_path(File.join(File.dirname(__FILE__), 'languages.yml')) unless defined?(FILE)
+    LANGUAGES = YAML.load_file(FILE) unless defined?(LANGUAGES)
+
+    # O(1) fetch of language properties given the ISO_639_1 2-letter code
+    def self.get_iso_639_1_translation(code)
+      raise NoLanguageError.new("[#{code}] IS NOT VALID") if LANGUAGES[code].nil?
+      LANGUAGES[code]
+    end
+
+    class NoLanguageError < StandardError
+    end
+  end
+end
+
+# Needed to process "no" for Norwegian. It is a reserved word in YAML :/.
+SunDawg::LanguageIsoTranslater::LANGUAGES.keys.each do |k|
+  if k.size > 2
+    v = SunDawg::LanguageIsoTranslater::LANGUAGES[k]
+    SunDawg::LanguageIsoTranslater::LANGUAGES.delete(k)
+    SunDawg::LanguageIsoTranslater::LANGUAGES[k[2..3]] = v
+  end
+end

data/lib/languages.yml

@@ -0,0 +1,750 @@
+ab:
+  name: Abkhaz
+  family: Northwest Caucasian
+  alpha3t: abk
+aa:
+  name: Afar
+  family: Afro-Asiatic
+  alpha3t: aar
+af:
+  name: Afrikaans
+  family: Indo-European
+  alpha3t: afr
+ak:
+  name: Akan
+  family: Niger-Congo
+  alpha3t: aka
+sq:
+  name: Albanian
+  family: Indo-European
+  alpha3t: sqi
+am:
+  name: Amharic
+  family: Afro-Asiatic
+  alpha3t: amh
+ar:
+  name: Arabic
+  family: Afro-Asiatic
+  alpha3t: ara
+an:
+  name: Aragonese 
+  family: Indo-European
+  alpha3t: arg
+hy:
+  name: Armenian
+  family: Indo-European
+  alpha3t: hye 
+as:
+  name: Assamese
+  family: Indo-European
+  alpha3t: asm
+av:
+  name: Avaric
+  family: Northeast Caucasian
+  alpha3t: ava
+ae:
+  name: Avestan
+  family: Indo-European
+  alpha3t: ave
+ay:
+  name: Aymara
+  family: Aymaran
+  alpha3t: aym
+az:
+  name: Azerbaijani
+  family: Turkic
+  alpha3t: aze
+bm:
+  name: Bambara
+  family: Niger-Congo
+  alpha3t: bam
+ba:
+  name: Bashkir
+  family: Turkic
+  alpha3t: bak
+eu:
+  name: Baque
+  family: Language Isolate
+  alpha3t: eus
+  alpha3b: baq
+be:
+  name: Belarusian
+  family: Indo-European
+  alpha3t: bel
+bn:
+  name: Bengali 
+  family: Indo-European 
+  alpha3t: ben
+bh:
+  name: Bihari
+  family: Indo-European
+  alpha3t: bih
+bi:
+  name: Bislama
+  family: Creole
+  alpha3t: bis
+bs:
+  name: Bosnian
+  family: Indo-European
+  alpha3t: bos
+br:
+  name: Breton
+  family: Indo-European
+  alpha3t: bre
+bg:
+  name: Bulgarian
+  family: Indo-European
+  alpha3t: bul
+my:
+  name: Burmese
+  family: Sino-Tibetan
+  alpha3t: mya
+  alpha3b: bur
+ca:
+  name: Catalan
+  family: Indo-European
+  alpha3t: cat
+ch:
+  name: Chamorro
+  family: Austronesian
+  alpha3t: cha
+ce:
+  name: Chechen
+  family: Northeast Caucasian
+  alpha3t: che
+ny:
+  name: Chichewa
+  family: Niger-Congo
+  alpha3t: nya
+zh:
+  name: Chinese
+  family: Sino-Tibetan
+  alpha3t: zho
+  alpha3b: chi
+cv:
+  name: Chuvash
+  family: Turkic
+  alpha3t: chv
+kw:
+  name: Cornish
+  family: Indo-European
+  alpha3t: cor
+co:
+  name: Corsican
+  family: Indo-European
+  alpha3t: cos
+cr:
+  name: Cree
+  family: Algonquian
+  alpha3t: cre
+hr:
+  name: Croatian
+  family: Indo-European
+  alpha3t: hrv
+cs:
+  name: Czech
+  family: Indo-European
+  alpha3t: ces
+  alpha3b: cze
+da:
+  name: Danish
+  family: Indo-European
+  alpha3t: dan
+dv:
+  name: Divehi
+  family: Indo-European
+  alpha3t: div
+nl:
+  name: Dutch
+  family: Indo-European
+  alpha3t: nld
+  alpha3b: dut
+dz:
+  name: Dzongkha
+  family: Sino-Tibetan
+  alpha3t: dzo
+en:
+  name: English
+  family: Indo-European
+  alpha3t: eng
+eo:
+  name: Esperanto
+  family: Constructed
+  alpha3t: epo
+et:
+  name: Estonian
+  family: Finno-Ugric
+  alpha3t: est
+ee:
+  name: Ewe
+  family: Niger-Congo
+  alpha3t: ewe
+fo:
+  name: Faroese
+  family: Indo-European
+  alpha3t: fao
+fj:
+  name: Fijian
+  family: Austronesian
+  alpha3t: fij
+fi:
+  name: Finnish
+  family: Finno-Ugric
+  alpha3t: fin
+fr:
+  name: French
+  family: Indo-European
+  alpha3t: fra
+  alpha3b: fre
+ff:
+  name: Fula
+  family: Niger-Congo
+  alpha3t: ful
+gl:
+  name: Galican
+  family: Indo-European
+  alpha3t: glg
+ka:
+  name: Georgian
+  family: South Caucasian
+  alpha3t: kat
+  alpha3b: geo
+de:
+  name: German
+  family: Indo-European
+  alpha3t: deu
+  alpha3b: ger
+el:
+  name: Greek
+  family: Indo-European
+  alpha3t: ell
+  alpha3b: gre
+gn:
+  name: Guarani
+  family: Tupi-Guarani
+  alpha3t: grn
+gu:
+  name: Gujarati
+  family: Indo-European
+  alpha3t: guj
+ht:
+  name: Haitian
+  family: Creole
+  alpha3t: hat
+ha:
+  name: Hausa
+  family: Afro-Asiatic
+  alpha3t: hau
+he:
+  name: Hebrew
+  family: Afro-Asiatic
+  alpha3t: heb
+hz:
+  name: Herero
+  family: Niger-Congo
+  alpha3t: her
+hi:
+  name: Hindi
+  family: Indo-European
+  alpha3t: hin
+ho:
+  name: Hiri Motu
+  family: Austronesian
+  alpha3t: hmo
+hu:
+  name: Hungarian
+  family: Finno-Ugric
+  alpha3t: hun
+ia:
+  name: Interlingua
+  family: Constructed
+  alpha3t: ina
+id:
+  name: Indonesian
+  family: Austronesian
+  alpha3t: ind
+ie:
+  name: Interlingue
+  family: Constructed
+  alpha3t: ile
+ga:
+  name: Irish
+  family: Indo-European
+  alpha3t: gle
+ig:
+  name: Igbo
+  family: Niger-Congo
+  alpha3t: ibo
+ik:
+  name: Inupiaq
+  family: Eskimo-Aleut
+  alpha3t: ipk
+io:
+  name: Ido
+  family: Constructed
+  alpha3t: ido
+is:
+  name: Icelandic
+  family: Indo-European
+  alpha3t: isl
+  alpha3b: ice
+it:
+  name: Italian
+  family: Indo-European
+  alpha3t: ita
+iu:
+  name: Inuktitut
+  family: Eskimo-Aleut
+  alpha3t: iku
+ja:
+  name: Japanese
+  family: Japonic
+  alpha3t: jpn
+jv:
+  name: Javanese
+  family: Austronesian
+  alpha3t: jav
+kl:
+  name: Kalaallisut
+  family: Eskimo-Aleut
+  alpha3t: kal
+kn:
+  name: Kannada
+  family: Dravidian
+  alpha3t: kan
+kr:
+  name: Kanuri
+  family: Nilo-Saharan
+  alpha3t: kau
+ks:
+  name: Kashmiri
+  family: Indo-European
+  alpha3t: kas
+kk:
+  name: Kazakh
+  family: Turkic
+  alpha3t: kaz
+km:
+  name: Khmer
+  family: Austro-Asiatic
+  alpha3t: khm
+ki:
+  name: Kikuyu
+  family: Niger-Congo
+  alpha3t: kik
+rw:
+  name: Kinyarwanda
+  family: Niger-Congo
+  alpha3t: kin
+ky:
+  name: Kirghiz
+  family: Turkic
+  alpha3t: kir
+kv:
+  name: Komi
+  family: Finno-Ugric
+  alpha3t: kom
+kg:
+  name: Kongo
+  family: Niger-Congo
+  alpha3t: kon
+ko:
+  name: Korean
+  family: Language Isolate
+  alpha3t: kor
+ku:
+  name: Kurdish
+  family: Indo-European
+  alpha3t: kur
+kj:
+  name: Kwanyama
+  family: Niger-Congo
+  alpha3t: kua
+la:
+  name: Latin
+  family: Indo-European
+  alpha3t: lat
+lb:
+  name: Luxembourgish
+  family: Indo-European
+  alpha3t: ltz
+lg:
+  name: Luganda
+  family: Niger-Congo
+  alpha3t: lug
+li:
+  name: Limburgish
+  family: Indo-European
+  alpha3t: lim
+ln:
+  name: Lingala
+  family: Niger-Congo
+  alpha3t: lin
+lo:
+  name: Lao
+  family: Tai-Kadai
+  alpha3t: lao
+lt:
+  name: Lithuanian
+  family: Indo-European
+  alpha3t: lit
+lu:
+  name: Luba-Katanga
+  family: Niger-Congo
+  alpha3t: lub
+lv:
+  name: Latvian
+  family: Indo-European
+  alpha3t: lav
+gv:
+  name: Manx
+  family: Indo-European
+  alpha3t: glv
+mk:
+  name: Macedonian
+  family: Indo-European
+  alpha3t: mkd
+  alpha3b: mac
+mg:
+  name: Malagasy
+  family: Austronesian
+  alpha3t: mlg
+ms:
+  name: Malay
+  family: Austronesian
+  alpha3t: msa
+  alpha3b: may
+ml:
+  name: Malayalam
+  family: Dravidian
+  alpha3t: mal
+mt:
+  name: Maltese
+  family: Afro-Asiatic
+  alpha3t: mlt
+mi:
+  name: Māori
+  family: Austronesian
+  alpha3t: mri
+  alpha3b: mao
+mr:
+  name: Marathi
+  family: Indo-European
+  alpha3t: mar
+mh:
+  name: Marshallese
+  family: Austronesian
+  alpha3t: mah 
+mn:
+  name: Mongolian
+  family: Mongolic
+  alpha3t: mon
+na:
+  name: Nauru
+  family: Austronesian
+  alpha3t: nau
+nv:
+  name: Navajo
+  family: Dene-Yeniseian
+  alpha3t: nav
+nb:
+  name: Norwegian Bokmål
+  family: Indo-European
+  alpha3t: nob
+nd:
+  name: North Ndebele
+  family: Niger-Congo
+  alpha3t: nde
+ne:
+  name: Nepali
+  family: Indo-European
+  alpha3t: nep
+ng:
+  name: Ndonga
+  family: Niger-Congo
+  alpha3t: ndo
+nn:
+  name: Norwegian Nynorsk
+  family: Indo-European
+  alpha3t: nno
+x_no:
+  name: Norwegian
+  family: Indo-European
+  alpha3t: nor
+ii:
+  name: Nuosu
+  family: Sino-Tibetan
+  alpha3t: iii
+nr:
+  name: South Ndebele
+  family: Niger-Congo
+  alpha3t: nbl
+oc:
+  name: Occitan
+  family: Indo-European
+  alpha3t: oci
+oj:
+  name: Ojibwe
+  family: Algonquian
+  alpha3t: oji
+cu:
+  name: Old Church Slavonic
+  family: Indo-European
+  alpha3t: chu
+om:
+  name: Oromo
+  family: Afro-Asiatic
+  alpha3t: orm
+or:
+  name: Oriya
+  family: Indo-European
+  alpha3t: ori
+os:
+  name: Ossetian
+  family: Indo-European
+  alpha3t: oss
+pa:
+  name: Panjabi
+  family: Indo-European
+  alpha3t: pan
+pi:
+  name: Pāli
+  family: Indo-European
+  alpha3t: pli
+fa:
+  name: Persian
+  family: Indo-European
+  alpha3t: fas
+  alpha3b: per
+pl:
+  name: Polish
+  family: Indo-European
+  alpha3t: pol
+ps:
+  name: Pashto
+  family: Indo-European
+  alpha3t: pus
+pt:
+  name: Portuguese
+  family: Indo-European
+  alpha3t: por
+qu:
+  name: Quechua
+  family: Quechuan
+  alpha3t: que
+rm:
+  name: Romansh
+  family: Indo-European
+  alpha3t: roh
+rn:
+  name: Kirundi
+  family: Niger-Congo
+  alpha3t: run
+ro:
+  name: Romanian
+  family: Indo-European
+  alpha3t: ron
+  alpha3b: rum
+ru:
+  name: Russian
+  family: Indo-European
+  alpha3t: rus
+sa:
+  name: Sanskrit
+  family: Indo-European
+  alpha3t: san
+sc:
+  name: Sardinian
+  family: Indo-European
+  alpha3t: srd
+sd:
+  name: Sindhi
+  family: Indo-European
+  alpha3t: snd
+se:
+  name: Northern Sami
+  family: Finno-Ugric
+  alpha3t: sme
+sm:
+  name: Samoan
+  family: Austronesian
+  alpha3t: smo
+sg:
+  name: Sango
+  family: Creole
+  alpha3t: sag
+sr:
+  name: Serbian
+  family: Indo-European
+  alpha3t: srp
+gd:
+  name: Scottish Gaelic
+  family: Indo-European
+  alpha3t: gla
+sn:
+  name: Shona
+  family: Niger-Congo
+  alpha3t: sna
+si:
+  name: Sinhala
+  family: Indo-European
+  alpha3t: sin
+sk:
+  name: Slovak
+  family: Indo-European
+  alpha3t: slk
+  alpha3b: slo
+sl:
+  name: Slovene
+  family: Indo-European
+  alpha3t: slv
+so:
+  name: Somali
+  family: Afro-Asiatic
+  alpha3t: som
+st:
+  name: Southern Sotho
+  family: Niger-Congo
+  alpha3t: sot
+es:
+  name: Spanish
+  family: Indo-European
+  alpha3t: spa
+su:
+  name: Sundanese
+  family: Indo-European
+  alpha3t: sun
+sw:
+  name: Swahili
+  family: Niger-Congo
+  alpha3t: swa
+ss:
+  name: Swati
+  family: Niger-Congo
+  alpha3t: ssw
+sv:
+  name: Swedish
+  family: Indo-European
+  alpha3t: swe
+ta:
+  name: Tamil
+  family: Dravidian
+  alpha3t: tam
+te:
+  name: Telugu
+  family: Dravidian
+  alpha3t: tel
+tg:
+  name: Tajik
+  family: Indo-European
+  alpha3t: tgk
+th:
+  name: Thai
+  family: Tai-Kadai
+  alpha3t: tha
+ti:
+  name: Tigrinya
+  family: Afro-Asiatic
+  alpha3t: tir
+bo:
+  name: Tibetan Standard
+  family: Sino-Tibetan
+  alpha3t: bod
+  alpha3b: tib
+tk:
+  name: Turkmen
+  family: Turkic
+  alpha3t: tuk
+tl:
+  name: Tagalog
+  family: Austronesian
+  alpha3t: tgl
+tn:
+  name: Tswana
+  family: Niger-Congo
+  alpha3t: tsn
+tn:
+  name: Tonga
+  family: Austronesian
+  alpha3t: ton
+tr:
+  name: Turkish
+  family: Turkic
+  alpha3t: tur
+ts:
+  name: Tsonga
+  family: Niger-Congo
+  alpha3t: tso
+tt:
+  name: Tatar
+  family: Turkic
+  alpha3t: tat
+tw:
+  name: Twi
+  family: Niger-Congo
+  alpha3t: twi
+ty:
+  name: Tahitian
+  family: Austronesian
+  alpha3t: tah
+uh:
+  name: Uighur
+  family: Turkic
+  alpha3t: ukr
+ur:
+  name: Urdu
+  family: Indo-European
+  alpha3t: urd
+uz:
+  name: Uzbek
+  family: Indo-European
+  alpha3t: uzb
+ve:
+  name: Venda
+  family: Niger-Congo
+  alpha3t: ven
+vi:
+  name: Vietnamese
+  family: Austro-Asiatic
+  alpha3t: vie
+vo:
+  name: Volapük
+  family: Constructed
+  alpha3t: vol
+wa:
+  name: Walloon
+  family: Indo-European
+  alpha3t: wln
+cy:
+  name: Welsh
+  family: Indo-European
+  alpha3t: cym
+  alpha3b: wel
+wo:
+  name: Wolof
+  family: Indo-European
+  alpha3t: wol
+fy:
+  name: Western Frisian
+  family: Indo-European
+  alpha3t: fry
+xh:
+  name: Xhosa
+  family: Niger-Congo
+  alpha3t: xho
+yi:
+  name: Yiddish
+  family: Indo-European
+  alpha3t: yid
+yo:
+  name: Yoruba
+  family: Niger-Congo
+  alpha3t: yor
+za:
+  name: Zhuang
+  family: Tai-Kadai
+  alpha3t: zha
+zu:
+  name: Zulu
+  family: Niger-Congo
+  alpha3t: zul

data/lib/usa_state_translater.rb

@@ -8,9 +8,9 @@ module SunDawg
 
     # O(N) translation from state name to 2-digit code
     def self.translate_name_to_code(name)
-      USA_STATES.each_pair { |key, value| 
+      USA_STATES.each_pair do |key, value| 
         return key if value["name"] == name 
-      }
+      end
       raise NoStateError.new("[#{name}] IS NOT VALID")
     end
 

data/sundawg_country_codes.gemspec

@@ -2,28 +2,28 @@
 
 Gem::Specification.new do |s|
   s.name = %q{sundawg_country_codes}
-  s.version = "0.0.3"
+  s.version = "0.0.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Christopher Sun"]
-  s.date = %q{2010-01-11}
-  s.description = %q{Manage ISO 3166 Country Names and Codes.}
+  s.date = %q{2010-08-27}
+  s.description = %q{Manage ISO 3166 Country Names and Codes, ISO 639 Languages, and ISO 4217 Currencies.}
   s.email = %q{christopher.sun@gmail.com}
-  s.extra_rdoc_files = ["README", "lib/countries.yml", "lib/country_iso_translater.rb", "lib/usa_state_translater.rb", "lib/usa_states.yml"]
-  s.files = ["Manifest", "README", "Rakefile", "lib/countries.yml", "lib/country_iso_translater.rb", "lib/usa_state_translater.rb", "lib/usa_states.yml", "sundawg_country_codes.gemspec", "test/country_iso_translater_test.rb", "test/test_helper.rb", "test/usa_translater_test.rb"]
+  s.extra_rdoc_files = ["README.rdoc", "lib/countries.yml", "lib/country_iso_translater.rb", "lib/language_iso_translater.rb", "lib/languages.yml", "lib/usa_state_translater.rb", "lib/usa_states.yml"]
+  s.files = ["README.rdoc", "Rakefile", "lib/countries.yml", "lib/country_iso_translater.rb", "lib/language_iso_translater.rb", "lib/languages.yml", "lib/usa_state_translater.rb", "lib/usa_states.yml", "sundawg_country_codes.gemspec", "test/country_iso_translater_test.rb", "test/language_iso_translater_test.rb", "test/test_helper.rb", "test/usa_translater_test.rb", "Manifest"]
   s.homepage = %q{http://github.com/SunDawg/country_codes}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Sundawg_country_codes", "--main", "README"]
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Sundawg_country_codes", "--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{sundawg_country_codes}
-  s.rubygems_version = %q{1.3.5}
-  s.summary = %q{Manage ISO 3166 Country Names and Codes.}
-  s.test_files = ["test/country_iso_translater_test.rb", "test/test_helper.rb", "test/usa_translater_test.rb"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Manage ISO 3166 Country Names and Codes, ISO 639 Languages, and ISO 4217 Currencies.}
+  s.test_files = ["test/country_iso_translater_test.rb", "test/language_iso_translater_test.rb", "test/test_helper.rb", "test/usa_translater_test.rb"]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
     else
     end
   else

data/test/country_iso_translater_test.rb

@@ -61,7 +61,7 @@ class CountryIsoTranslaterTest < Test::Unit::TestCase
   end
 
   def test_data_integrity
-    SunDawg::CountryIsoTranslater::COUNTRIES.each_pair { |k, v|
+    SunDawg::CountryIsoTranslater::COUNTRIES.each_pair do |k, v|
       # check country codes
       assert_not_nil v["alpha2"]
       assert_not_nil v["alpha3"]
@@ -83,10 +83,10 @@ class CountryIsoTranslaterTest < Test::Unit::TestCase
       end
 
       # check to make sure currency_iso4217 is spelled correctly
-      v.each_pair { |k2, v2|
+      v.each_pair do |k2, v2|
         assert_equal k2, "currency_iso4217" if (k2[0..1] == "c")
-      }
-    }
+      end
+    end 
   end
 
   def test_error_on_invalid_currency

data/test/language_iso_translater_test.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+
+# allows override of FILE
+module SunDawg 
+  module LanguageIsoTranslater
+    FILE = "lib/languages.yml"
+  end
+end
+
+require 'language_iso_translater'
+
+class LangaugeIsoTranslaterTest < Test::Unit::TestCase 
+  def test_english
+    h = client.get_iso_639_1_translation("en")
+    assert_equal "English", h['name']
+    assert_equal "eng", h['alpha3t']
+  end
+
+  def test_norwegian
+    h = client.get_iso_639_1_translation("no")
+    assert_equal "Norwegian", h['name']
+    assert_equal "nor", h['alpha3t']
+  end
+
+  def test_data_integrity
+    SunDawg::LanguageIsoTranslater::LANGUAGES.each_pair do |k, v|
+      assert_equal 2, k.to_s.size
+      assert v['name']
+      assert v['family']
+      assert v['alpha3t']
+      assert_equal 3, v['alpha3t'].size
+      assert ['Algonquian', 'Dene-Yeniseian', 'Japonic', 'Quechuan', 'Turkic', 'Northwest Caucasian', 'Nilo-Saharan', 'Language Isolate', 'Tai-Kadai', 'Sino-Tibetan', 'Aymaran', 'Constructed', 'Northeast Caucasian', 'Mongolic', 'Austro-Asiatic', 'South Caucasian', 'Tupi-Guarani', 'Creole', 'Finno-Ugric', 'Eskimo-Aleut', 'Turkic', 'Austronesian', 'Dravidian', 'Indo-European', 'Afro-Asiatic', 'Niger-Congo'].include?(v['family'])
+    end    
+  end
+
+  protected
+
+  def client
+    SunDawg::LanguageIsoTranslater
+  end
+end

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sundawg_country_codes
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - Christopher Sun
@@ -9,34 +15,39 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-11 00:00:00 -05:00
+date: 2010-08-27 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
-description: Manage ISO 3166 Country Names and Codes.
+description: Manage ISO 3166 Country Names and Codes, ISO 639 Languages, and ISO 4217 Currencies.
 email: christopher.sun@gmail.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- README
+- README.rdoc
 - lib/countries.yml
 - lib/country_iso_translater.rb
+- lib/language_iso_translater.rb
+- lib/languages.yml
 - lib/usa_state_translater.rb
 - lib/usa_states.yml
 files: 
-- Manifest
-- README
+- README.rdoc
 - Rakefile
 - lib/countries.yml
 - lib/country_iso_translater.rb
+- lib/language_iso_translater.rb
+- lib/languages.yml
 - lib/usa_state_translater.rb
 - lib/usa_states.yml
 - sundawg_country_codes.gemspec
 - test/country_iso_translater_test.rb
+- test/language_iso_translater_test.rb
 - test/test_helper.rb
 - test/usa_translater_test.rb
+- Manifest
 has_rdoc: true
 homepage: http://github.com/SunDawg/country_codes
 licenses: []
@@ -48,29 +59,37 @@ rdoc_options:
 - --title
 - Sundawg_country_codes
 - --main
-- README
+- README.rdoc
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
       version: "1.2"
-  version: 
 requirements: []
 
 rubyforge_project: sundawg_country_codes
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Manage ISO 3166 Country Names and Codes.
+summary: Manage ISO 3166 Country Names and Codes, ISO 639 Languages, and ISO 4217 Currencies.
 test_files: 
 - test/country_iso_translater_test.rb
+- test/language_iso_translater_test.rb
 - test/test_helper.rb
 - test/usa_translater_test.rb

data/README

@@ -1,98 +0,0 @@
-ABOUT
------
-This project is a Ruby gem to manage ISO 3166 country names and their corresponding alpha-2 and alpha-3 codes.
-
-Reference information can be found:
-
-ISO3166 Country Codes
-http://en.wikipedia.org/wiki/ISO_3166-1
-
-ISO4217 Currency Information
-http://www.xe.com/iso4217.php
-http://www.xe.com/symbols.php
-
-TEST
-----
-Tests can be executed by running:
-
-rake test
-
-SAMPLE USAGE
-------------
-To translate from a country's name to their ISO Alpha-2 code:
-
-SunDawg::CountryIsoTranslater.translate_iso3166_name_to_alpha2("United States")
-
-To translate from a country's name to their ISO Alpha-3 code:
-
-SunDawg::CountryIsoTranslater.translate_iso3166_name_to_alpha3("Egypt")
-
-To translate from a country's ISO Alpha-2 code to country name:
-
-SunDawg::CountryIsoTranslater.translate_iso3166_alpha2_to_name("US")
-
-To translate form a country's ISO Alpha-3 code to country name:
-
-SunDawg::CountryIsoTranslater.translate_iso3166_alpha3_to_name("ESP")
-
-To obtain currency information for a country:
-
-currency = SunDawg::CountryIsoTranslater.get_iso4217_currency_by_iso3166_alpha2("US")
-assert_equal currency["code"], "USD"
-assert_equal currency["symbol"], "$"
-assert_equal currency["name"], "Dollars"
-assert_equal currency["unicode_hex"], 36
-
-NOTE: 
-
-Not all countries have currency information and not all currency information contains both the symbol. Some currency information contain a second currency under the curreny["alt_currency"] which will then contain the same hash values for a currency.
-
-Furthermore, while the hex value for representing the unicode symbol is stored in the .yml file, the import into Ruby is converting it into decimal. You can convert back to hex as so:
-
-assert_equal currency["unicode_hex"].to_s(16), "24"
-
-The unicode value, either in base 10 or base 16  will allow you to render the symbol properly in HTML:
-
-$ or $
-
-More information:
-
-http://www.fileformat.info/info/unicode/char/0024/index.htm
-
-To build the unicode HTML for a symbol:
-
-currency = SunDawg::CountryIsoTranslater.get_iso4217_currency_by_iso3166_alpha2("UZ")
-assert_equal SunDawg::CountryIsoTranslater.build_html_unicode(currency["unicode_hex"]), "&#x43b&#x432"
-
-To translate to and from USA state name and the 2-digit code:
-
-SunDawg::USAStateTranslater.translate_name_to_code('New York')
-SunDawg::USAStateTranslater.translate_code_to_name('NY')
-
-DATA
-----
-All country code and names are stored in a countries.yml file that can be changed as you need. The latest codes and country names are derived from:
-
-http://en.wikipedia.org/wiki/ISO_3166-1
-
-GEM INSTALL
------------
-This gem is hosted gemcutter.org. To install the gem, you should install gemcutter as so:
-
-sudo gem install gemcutter
-gem tumble
-
-This will add gemcutter to your gem repository for downloading the country_codes gem.
-
-RAILS INSTALL
--------------
-To include this gem in your Rails project, add the following to your config/environment.rb:
-
-config.gem 'sundawg_country_codes', :lib => 'country_iso_translater'
-
-VERSION HISTORY
----------------
-v0.0.3 - Added USA State translater and cleaned up unit tests.
-v0.0.2b - Completed all currency information, unicode HTML utility, and bug fixes. Gem version re-published as 0.0.2.
-v0.0.2 - Added ISO 4217 currency information.
-v0.0.1 - Allows basic ISO 3166 translation.