iso-639 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 William Melody
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# ISO 639
+
+A Ruby gem that provides the ISO 639-2 and ISO 639-1 data sets along with a some convenience methods for accessing different entries and entry fields. The data comes from the [LOC ISO 639-2 UTF-8 data set](http://www.loc.gov/standards/iso639-2/ascii_8bits.html).
+
+To install:
+
+    gem install iso-639
+
+The [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) specification uses a two-letter code to identify a language and is often the recommended way to identify languages in computer applications. The ISO 639-1 specification covers most developed and widely used languages.
+
+The [ISO 639-2](http://www.loc.gov/standards/iso639-2/) ([Wikipedia](http://en.wikipedia.org/wiki/ISO_639-2)) specification uses a three-letter code, is used primarily in bibliography and terminology and covers many more languages than the ISO 639-1 specification.
+
+The other ISO 639 standards are considered beyond the scope of this library.
+
+## Usage
+
+    require 'iso-639'
+
+To find a language entry:
+
+    # by alpha-2 or alpha-3 code
+    ISO_639.find_by_code("en")
+    # or
+    ISO_639.find("en")
+    # by English name
+    ISO_639.find_by_english_name("Russian")
+    # by French name
+    ISO_639.find_by_french_name("français")
+
+Entries are arrays with convenience methods for accessing fields:
+    
+    @entry = ISO_639.find("slo")
+    # => ["slo", "slk", "sk", "Slovak", "slovaque"]
+    @entry.alpha3_bibliographic
+    # => "slo"
+    @entry.alpha3 # shortcut for #alpha3_bibliographic
+    # => "slo"
+    @entry.alpha3_terminologic
+    # => "slk"
+    @entry.alpha2
+    # => "sk"
+    @entry.english_name
+    # => "Slovak"
+    @entry.french_name
+    # => "slovaque"
+
+The full data set is available through the `ISO_639::ISO_639_1` and `ISO_639::ISO_639_2` constants.
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 William Melody. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "iso-639"
+    gem.summary = %Q{ISO 639-1 and ISO 639-2 language code entries and convenience methods}
+    gem.description = %Q{ISO 639-1 and ISO 639-2 language code entries and convenience methods}
+    gem.email = "hi@williammelody.com"
+    gem.homepage = "http://github.com/autodata/iso-639"
+    gem.authors = ["William Melody"]
+    gem.add_development_dependency "thoughtbot-shoulda"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "ISO-639 #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/iso-639.gemspec

@@ -0,0 +1,54 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{iso-639}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["William Melody"]
+  s.date = %q{2010-01-20}
+  s.description = %q{ISO 639-1 and ISO 639-2 language code entries and convenience methods}
+  s.email = %q{hi@williammelody.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "iso-639.gemspec",
+     "lib/iso-639.rb",
+     "test/test_ISO_639.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/autodata/iso-639}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{ISO 639-1 and ISO 639-2 language code entries and convenience methods}
+  s.test_files = [
+    "test/test_helper.rb",
+     "test/test_ISO_639.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
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+  end
+end
+

data/lib/iso-639.rb

@@ -0,0 +1,547 @@
+# encoding: UTF-8
+# http://www.loc.gov/standards/iso639-2/ascii_8bits.html
+
+class ISO_639 < Array
+  
+  # The ISO 639-2 dataset as an array of entries. Each entry is an array with
+  # the following format:
+  # * [0]: an alpha-3 (bibliographic) code
+  # * [1]: an alpha-3 (terminologic) code (when given)
+  # * [2]: an alpha-2 code (when given)
+  # * [3]: an English name
+  # * [4]: a French name of a language
+  ISO_639_2 = [
+    self["aar", "", "aa", "Afar", "afar"],
+    self["abk", "", "ab", "Abkhazian", "abkhaze"],
+    self["ace", "", "", "Achinese", "aceh"],
+    self["ach", "", "", "Acoli", "acoli"],
+    self["ada", "", "", "Adangme", "adangme"],
+    self["ady", "", "", "Adyghe; Adygei", "adyghé"],
+    self["afa", "", "", "Afro-Asiatic languages", "afro-asiatiques, langues"],
+    self["afh", "", "", "Afrihili", "afrihili"],
+    self["afr", "", "af", "Afrikaans", "afrikaans"],
+    self["ain", "", "", "Ainu", "aïnou"],
+    self["aka", "", "ak", "Akan", "akan"],
+    self["akk", "", "", "Akkadian", "akkadien"],
+    self["alb", "sqi", "sq", "Albanian", "albanais"],
+    self["ale", "", "", "Aleut", "aléoute"],
+    self["alg", "", "", "Algonquian languages", "algonquines, langues"],
+    self["alt", "", "", "Southern Altai", "altai du Sud"],
+    self["amh", "", "am", "Amharic", "amharique"],
+    self["ang", "", "", "English, Old (ca.450-1100)", "anglo-saxon (ca.450-1100)"],
+    self["anp", "", "", "Angika", "angika"],
+    self["apa", "", "", "Apache languages", "apaches, langues"],
+    self["ara", "", "ar", "Arabic", "arabe"],
+    self["arc", "", "", "Official Aramaic (700-300 BCE); Imperial Aramaic (700-300 BCE)", "araméen d'empire (700-300 BCE)"],
+    self["arg", "", "an", "Aragonese", "aragonais"],
+    self["arm", "hye", "hy", "Armenian", "arménien"],
+    self["arn", "", "", "Mapudungun; Mapuche", "mapudungun; mapuche; mapuce"],
+    self["arp", "", "", "Arapaho", "arapaho"],
+    self["art", "", "", "Artificial languages", "artificielles, langues"],
+    self["arw", "", "", "Arawak", "arawak"],
+    self["asm", "", "as", "Assamese", "assamais"],
+    self["ast", "", "", "Asturian; Bable; Leonese; Asturleonese", "asturien; bable; léonais; asturoléonais"],
+    self["ath", "", "", "Athapascan languages", "athapascanes, langues"],
+    self["aus", "", "", "Australian languages", "australiennes, langues"],
+    self["ava", "", "av", "Avaric", "avar"],
+    self["ave", "", "ae", "Avestan", "avestique"],
+    self["awa", "", "", "Awadhi", "awadhi"],
+    self["aym", "", "ay", "Aymara", "aymara"],
+    self["aze", "", "az", "Azerbaijani", "azéri"],
+    self["bad", "", "", "Banda languages", "banda, langues"],
+    self["bai", "", "", "Bamileke languages", "bamiléké, langues"],
+    self["bak", "", "ba", "Bashkir", "bachkir"],
+    self["bal", "", "", "Baluchi", "baloutchi"],
+    self["bam", "", "bm", "Bambara", "bambara"],
+    self["ban", "", "", "Balinese", "balinais"],
+    self["baq", "eus", "eu", "Basque", "basque"],
+    self["bas", "", "", "Basa", "basa"],
+    self["bat", "", "", "Baltic languages", "baltes, langues"],
+    self["bej", "", "", "Beja; Bedawiyet", "bedja"],
+    self["bel", "", "be", "Belarusian", "biélorusse"],
+    self["bem", "", "", "Bemba", "bemba"],
+    self["ben", "", "bn", "Bengali", "bengali"],
+    self["ber", "", "", "Berber languages", "berbères, langues"],
+    self["bho", "", "", "Bhojpuri", "bhojpuri"],
+    self["bih", "", "bh", "Bihari languages", "langues biharis"],
+    self["bik", "", "", "Bikol", "bikol"],
+    self["bin", "", "", "Bini; Edo", "bini; edo"],
+    self["bis", "", "bi", "Bislama", "bichlamar"],
+    self["bla", "", "", "Siksika", "blackfoot"],
+    self["bnt", "", "", "Bantu (Other)", "bantoues, autres langues"],
+    self["bos", "", "bs", "Bosnian", "bosniaque"],
+    self["bra", "", "", "Braj", "braj"],
+    self["bre", "", "br", "Breton", "breton"],
+    self["btk", "", "", "Batak languages", "batak, langues"],
+    self["bua", "", "", "Buriat", "bouriate"],
+    self["bug", "", "", "Buginese", "bugi"],
+    self["bul", "", "bg", "Bulgarian", "bulgare"],
+    self["bur", "mya", "my", "Burmese", "birman"],
+    self["byn", "", "", "Blin; Bilin", "blin; bilen"],
+    self["cad", "", "", "Caddo", "caddo"],
+    self["cai", "", "", "Central American Indian languages", "amérindiennes de L'Amérique centrale, langues"],
+    self["car", "", "", "Galibi Carib", "karib; galibi; carib"],
+    self["cat", "", "ca", "Catalan; Valencian", "catalan; valencien"],
+    self["cau", "", "", "Caucasian languages", "caucasiennes, langues"],
+    self["ceb", "", "", "Cebuano", "cebuano"],
+    self["cel", "", "", "Celtic languages", "celtiques, langues; celtes, langues"],
+    self["cha", "", "ch", "Chamorro", "chamorro"],
+    self["chb", "", "", "Chibcha", "chibcha"],
+    self["che", "", "ce", "Chechen", "tchétchène"],
+    self["chg", "", "", "Chagatai", "djaghataï"],
+    self["chi", "zho", "zh", "Chinese", "chinois"],
+    self["chk", "", "", "Chuukese", "chuuk"],
+    self["chm", "", "", "Mari", "mari"],
+    self["chn", "", "", "Chinook jargon", "chinook, jargon"],
+    self["cho", "", "", "Choctaw", "choctaw"],
+    self["chp", "", "", "Chipewyan; Dene Suline", "chipewyan"],
+    self["chr", "", "", "Cherokee", "cherokee"],
+    self["chu", "", "cu", "Church Slavic; Old Slavonic; Church Slavonic; Old Bulgarian; Old Church Slavonic", "slavon d'église; vieux slave; slavon liturgique; vieux bulgare"],
+    self["chv", "", "cv", "Chuvash", "tchouvache"],
+    self["chy", "", "", "Cheyenne", "cheyenne"],
+    self["cmc", "", "", "Chamic languages", "chames, langues"],
+    self["cop", "", "", "Coptic", "copte"],
+    self["cor", "", "kw", "Cornish", "cornique"],
+    self["cos", "", "co", "Corsican", "corse"],
+    self["cpe", "", "", "Creoles and pidgins, English based", "créoles et pidgins basés sur l'anglais"],
+    self["cpf", "", "", "Creoles and pidgins, French-based ", "créoles et pidgins basés sur le français"],
+    self["cpp", "", "", "Creoles and pidgins, Portuguese-based ", "créoles et pidgins basés sur le portugais"],
+    self["cre", "", "cr", "Cree", "cree"],
+    self["crh", "", "", "Crimean Tatar; Crimean Turkish", "tatar de Crimé"],
+    self["crp", "", "", "Creoles and pidgins ", "créoles et pidgins"],
+    self["csb", "", "", "Kashubian", "kachoube"],
+    self["cus", "", "", "Cushitic languages", "couchitiques, langues"],
+    self["cze", "ces", "cs", "Czech", "tchèque"],
+    self["dak", "", "", "Dakota", "dakota"],
+    self["dan", "", "da", "Danish", "danois"],
+    self["dar", "", "", "Dargwa", "dargwa"],
+    self["day", "", "", "Land Dayak languages", "dayak, langues"],
+    self["del", "", "", "Delaware", "delaware"],
+    self["den", "", "", "Slave (Athapascan)", "esclave (athapascan)"],
+    self["dgr", "", "", "Dogrib", "dogrib"],
+    self["din", "", "", "Dinka", "dinka"],
+    self["div", "", "dv", "Divehi; Dhivehi; Maldivian", "maldivien"],
+    self["doi", "", "", "Dogri", "dogri"],
+    self["dra", "", "", "Dravidian languages", "dravidiennes, langues"],
+    self["dsb", "", "", "Lower Sorbian", "bas-sorabe"],
+    self["dua", "", "", "Duala", "douala"],
+    self["dum", "", "", "Dutch, Middle (ca.1050-1350)", "néerlandais moyen (ca. 1050-1350)"],
+    self["dut", "nld", "nl", "Dutch; Flemish", "néerlandais; flamand"],
+    self["dyu", "", "", "Dyula", "dioula"],
+    self["dzo", "", "dz", "Dzongkha", "dzongkha"],
+    self["efi", "", "", "Efik", "efik"],
+    self["egy", "", "", "Egyptian (Ancient)", "égyptien"],
+    self["eka", "", "", "Ekajuk", "ekajuk"],
+    self["elx", "", "", "Elamite", "élamite"],
+    self["eng", "", "en", "English", "anglais"],
+    self["enm", "", "", "English, Middle (1100-1500)", "anglais moyen (1100-1500)"],
+    self["epo", "", "eo", "Esperanto", "espéranto"],
+    self["est", "", "et", "Estonian", "estonien"],
+    self["ewe", "", "ee", "Ewe", "éwé"],
+    self["ewo", "", "", "Ewondo", "éwondo"],
+    self["fan", "", "", "Fang", "fang"],
+    self["fao", "", "fo", "Faroese", "féroïen"],
+    self["fat", "", "", "Fanti", "fanti"],
+    self["fij", "", "fj", "Fijian", "fidjien"],
+    self["fil", "", "", "Filipino; Pilipino", "filipino; pilipino"],
+    self["fin", "", "fi", "Finnish", "finnois"],
+    self["fiu", "", "", "Finno-Ugrian languages", "finno-ougriennes, langues"],
+    self["fon", "", "", "Fon", "fon"],
+    self["fre", "fra", "fr", "French", "français"],
+    self["frm", "", "", "French, Middle (ca.1400-1600)", "français moyen (1400-1600)"],
+    self["fro", "", "", "French, Old (842-ca.1400)", "français ancien (842-ca.1400)"],
+    self["frr", "", "", "Northern Frisian", "frison septentrional"],
+    self["frs", "", "", "Eastern Frisian", "frison oriental"],
+    self["fry", "", "fy", "Western Frisian", "frison occidental"],
+    self["ful", "", "ff", "Fulah", "peul"],
+    self["fur", "", "", "Friulian", "frioulan"],
+    self["gaa", "", "", "Ga", "ga"],
+    self["gay", "", "", "Gayo", "gayo"],
+    self["gba", "", "", "Gbaya", "gbaya"],
+    self["gem", "", "", "Germanic languages", "germaniques, langues"],
+    self["geo", "kat", "ka", "Georgian", "géorgien"],
+    self["ger", "deu", "de", "German", "allemand"],
+    self["gez", "", "", "Geez", "guèze"],
+    self["gil", "", "", "Gilbertese", "kiribati"],
+    self["gla", "", "gd", "Gaelic; Scottish Gaelic", "gaélique; gaélique écossais"],
+    self["gle", "", "ga", "Irish", "irlandais"],
+    self["glg", "", "gl", "Galician", "galicien"],
+    self["glv", "", "gv", "Manx", "manx; mannois"],
+    self["gmh", "", "", "German, Middle High (ca.1050-1500)", "allemand, moyen haut (ca. 1050-1500)"],
+    self["goh", "", "", "German, Old High (ca.750-1050)", "allemand, vieux haut (ca. 750-1050)"],
+    self["gon", "", "", "Gondi", "gond"],
+    self["gor", "", "", "Gorontalo", "gorontalo"],
+    self["got", "", "", "Gothic", "gothique"],
+    self["grb", "", "", "Grebo", "grebo"],
+    self["grc", "", "", "Greek, Ancient (to 1453)", "grec ancien (jusqu'à 1453)"],
+    self["gre", "ell", "el", "Greek, Modern (1453-)", "grec moderne (après 1453)"],
+    self["grn", "", "gn", "Guarani", "guarani"],
+    self["gsw", "", "", "Swiss German; Alemannic; Alsatian", "suisse alémanique; alémanique; alsacien"],
+    self["guj", "", "gu", "Gujarati", "goudjrati"],
+    self["gwi", "", "", "Gwich'in", "gwich'in"],
+    self["hai", "", "", "Haida", "haida"],
+    self["hat", "", "ht", "Haitian; Haitian Creole", "haïtien; créole haïtien"],
+    self["hau", "", "ha", "Hausa", "haoussa"],
+    self["haw", "", "", "Hawaiian", "hawaïen"],
+    self["heb", "", "he", "Hebrew", "hébreu"],
+    self["her", "", "hz", "Herero", "herero"],
+    self["hil", "", "", "Hiligaynon", "hiligaynon"],
+    self["him", "", "", "Himachali languages; Western Pahari languages", "langues himachalis; langues paharis occidentales"],
+    self["hin", "", "hi", "Hindi", "hindi"],
+    self["hit", "", "", "Hittite", "hittite"],
+    self["hmn", "", "", "Hmong", "hmong"],
+    self["hmo", "", "ho", "Hiri Motu", "hiri motu"],
+    self["hrv", "", "hr", "Croatian", "croate"],
+    self["hsb", "", "", "Upper Sorbian", "haut-sorabe"],
+    self["hun", "", "hu", "Hungarian", "hongrois"],
+    self["hup", "", "", "Hupa", "hupa"],
+    self["iba", "", "", "Iban", "iban"],
+    self["ibo", "", "ig", "Igbo", "igbo"],
+    self["ice", "isl", "is", "Icelandic", "islandais"],
+    self["ido", "", "io", "Ido", "ido"],
+    self["iii", "", "ii", "Sichuan Yi; Nuosu", "yi de Sichuan"],
+    self["ijo", "", "", "Ijo languages", "ijo, langues"],
+    self["iku", "", "iu", "Inuktitut", "inuktitut"],
+    self["ile", "", "ie", "Interlingue; Occidental", "interlingue"],
+    self["ilo", "", "", "Iloko", "ilocano"],
+    self["ina", "", "ia", "Interlingua (International Auxiliary Language Association)", "interlingua (langue auxiliaire internationale)"],
+    self["inc", "", "", "Indic languages", "indo-aryennes, langues"],
+    self["ind", "", "id", "Indonesian", "indonésien"],
+    self["ine", "", "", "Indo-European languages", "indo-européennes, langues"],
+    self["inh", "", "", "Ingush", "ingouche"],
+    self["ipk", "", "ik", "Inupiaq", "inupiaq"],
+    self["ira", "", "", "Iranian languages", "iraniennes, langues"],
+    self["iro", "", "", "Iroquoian languages", "iroquoises, langues"],
+    self["ita", "", "it", "Italian", "italien"],
+    self["jav", "", "jv", "Javanese", "javanais"],
+    self["jbo", "", "", "Lojban", "lojban"],
+    self["jpn", "", "ja", "Japanese", "japonais"],
+    self["jpr", "", "", "Judeo-Persian", "judéo-persan"],
+    self["jrb", "", "", "Judeo-Arabic", "judéo-arabe"],
+    self["kaa", "", "", "Kara-Kalpak", "karakalpak"],
+    self["kab", "", "", "Kabyle", "kabyle"],
+    self["kac", "", "", "Kachin; Jingpho", "kachin; jingpho"],
+    self["kal", "", "kl", "Kalaallisut; Greenlandic", "groenlandais"],
+    self["kam", "", "", "Kamba", "kamba"],
+    self["kan", "", "kn", "Kannada", "kannada"],
+    self["kar", "", "", "Karen languages", "karen, langues"],
+    self["kas", "", "ks", "Kashmiri", "kashmiri"],
+    self["kau", "", "kr", "Kanuri", "kanouri"],
+    self["kaw", "", "", "Kawi", "kawi"],
+    self["kaz", "", "kk", "Kazakh", "kazakh"],
+    self["kbd", "", "", "Kabardian", "kabardien"],
+    self["kha", "", "", "Khasi", "khasi"],
+    self["khi", "", "", "Khoisan languages", "khoïsan, langues"],
+    self["khm", "", "km", "Central Khmer", "khmer central"],
+    self["kho", "", "", "Khotanese; Sakan", "khotanais; sakan"],
+    self["kik", "", "ki", "Kikuyu; Gikuyu", "kikuyu"],
+    self["kin", "", "rw", "Kinyarwanda", "rwanda"],
+    self["kir", "", "ky", "Kirghiz; Kyrgyz", "kirghiz"],
+    self["kmb", "", "", "Kimbundu", "kimbundu"],
+    self["kok", "", "", "Konkani", "konkani"],
+    self["kom", "", "kv", "Komi", "kom"],
+    self["kon", "", "kg", "Kongo", "kongo"],
+    self["kor", "", "ko", "Korean", "coréen"],
+    self["kos", "", "", "Kosraean", "kosrae"],
+    self["kpe", "", "", "Kpelle", "kpellé"],
+    self["krc", "", "", "Karachay-Balkar", "karatchai balkar"],
+    self["krl", "", "", "Karelian", "carélien"],
+    self["kro", "", "", "Kru languages", "krou, langues"],
+    self["kru", "", "", "Kurukh", "kurukh"],
+    self["kua", "", "kj", "Kuanyama; Kwanyama", "kuanyama; kwanyama"],
+    self["kum", "", "", "Kumyk", "koumyk"],
+    self["kur", "", "ku", "Kurdish", "kurde"],
+    self["kut", "", "", "Kutenai", "kutenai"],
+    self["lad", "", "", "Ladino", "judéo-espagnol"],
+    self["lah", "", "", "Lahnda", "lahnda"],
+    self["lam", "", "", "Lamba", "lamba"],
+    self["lao", "", "lo", "Lao", "lao"],
+    self["lat", "", "la", "Latin", "latin"],
+    self["lav", "", "lv", "Latvian", "letton"],
+    self["lez", "", "", "Lezghian", "lezghien"],
+    self["lim", "", "li", "Limburgan; Limburger; Limburgish", "limbourgeois"],
+    self["lin", "", "ln", "Lingala", "lingala"],
+    self["lit", "", "lt", "Lithuanian", "lituanien"],
+    self["lol", "", "", "Mongo", "mongo"],
+    self["loz", "", "", "Lozi", "lozi"],
+    self["ltz", "", "lb", "Luxembourgish; Letzeburgesch", "luxembourgeois"],
+    self["lua", "", "", "Luba-Lulua", "luba-lulua"],
+    self["lub", "", "lu", "Luba-Katanga", "luba-katanga"],
+    self["lug", "", "lg", "Ganda", "ganda"],
+    self["lui", "", "", "Luiseno", "luiseno"],
+    self["lun", "", "", "Lunda", "lunda"],
+    self["luo", "", "", "Luo (Kenya and Tanzania)", "luo (Kenya et Tanzanie)"],
+    self["lus", "", "", "Lushai", "lushai"],
+    self["mac", "mkd", "mk", "Macedonian", "macédonien"],
+    self["mad", "", "", "Madurese", "madourais"],
+    self["mag", "", "", "Magahi", "magahi"],
+    self["mah", "", "mh", "Marshallese", "marshall"],
+    self["mai", "", "", "Maithili", "maithili"],
+    self["mak", "", "", "Makasar", "makassar"],
+    self["mal", "", "ml", "Malayalam", "malayalam"],
+    self["man", "", "", "Mandingo", "mandingue"],
+    self["mao", "mri", "mi", "Maori", "maori"],
+    self["map", "", "", "Austronesian languages", "austronésiennes, langues"],
+    self["mar", "", "mr", "Marathi", "marathe"],
+    self["mas", "", "", "Masai", "massaï"],
+    self["may", "msa", "ms", "Malay", "malais"],
+    self["mdf", "", "", "Moksha", "moksa"],
+    self["mdr", "", "", "Mandar", "mandar"],
+    self["men", "", "", "Mende", "mendé"],
+    self["mga", "", "", "Irish, Middle (900-1200)", "irlandais moyen (900-1200)"],
+    self["mic", "", "", "Mi'kmaq; Micmac", "mi'kmaq; micmac"],
+    self["min", "", "", "Minangkabau", "minangkabau"],
+    self["mis", "", "", "Uncoded languages", "langues non codées"],
+    self["mkh", "", "", "Mon-Khmer languages", "môn-khmer, langues"],
+    self["mlg", "", "mg", "Malagasy", "malgache"],
+    self["mlt", "", "mt", "Maltese", "maltais"],
+    self["mnc", "", "", "Manchu", "mandchou"],
+    self["mni", "", "", "Manipuri", "manipuri"],
+    self["mno", "", "", "Manobo languages", "manobo, langues"],
+    self["moh", "", "", "Mohawk", "mohawk"],
+    self["mon", "", "mn", "Mongolian", "mongol"],
+    self["mos", "", "", "Mossi", "moré"],
+    self["mul", "", "", "Multiple languages", "multilingue"],
+    self["mun", "", "", "Munda languages", "mounda, langues"],
+    self["mus", "", "", "Creek", "muskogee"],
+    self["mwl", "", "", "Mirandese", "mirandais"],
+    self["mwr", "", "", "Marwari", "marvari"],
+    self["myn", "", "", "Mayan languages", "maya, langues"],
+    self["myv", "", "", "Erzya", "erza"],
+    self["nah", "", "", "Nahuatl languages", "nahuatl, langues"],
+    self["nai", "", "", "North American Indian languages", "nord-amérindiennes, langues"],
+    self["nap", "", "", "Neapolitan", "napolitain"],
+    self["nau", "", "na", "Nauru", "nauruan"],
+    self["nav", "", "nv", "Navajo; Navaho", "navaho"],
+    self["nbl", "", "nr", "Ndebele, South; South Ndebele", "ndébélé du Sud"],
+    self["nde", "", "nd", "Ndebele, North; North Ndebele", "ndébélé du Nord"],
+    self["ndo", "", "ng", "Ndonga", "ndonga"],
+    self["nds", "", "", "Low German; Low Saxon; German, Low; Saxon, Low", "bas allemand; bas saxon; allemand, bas; saxon, bas"],
+    self["nep", "", "ne", "Nepali", "népalais"],
+    self["new", "", "", "Nepal Bhasa; Newari", "nepal bhasa; newari"],
+    self["nia", "", "", "Nias", "nias"],
+    self["nic", "", "", "Niger-Kordofanian languages", "nigéro-kordofaniennes, langues"],
+    self["niu", "", "", "Niuean", "niué"],
+    self["nno", "", "nn", "Norwegian Nynorsk; Nynorsk, Norwegian", "norvégien nynorsk; nynorsk, norvégien"],
+    self["nob", "", "nb", "Bokmål, Norwegian; Norwegian Bokmål", "norvégien bokmål"],
+    self["nog", "", "", "Nogai", "nogaï; nogay"],
+    self["non", "", "", "Norse, Old", "norrois, vieux"],
+    self["nor", "", "no", "Norwegian", "norvégien"],
+    self["nqo", "", "", "N'Ko", "n'ko"],
+    self["nso", "", "", "Pedi; Sepedi; Northern Sotho", "pedi; sepedi; sotho du Nord"],
+    self["nub", "", "", "Nubian languages", "nubiennes, langues"],
+    self["nwc", "", "", "Classical Newari; Old Newari; Classical Nepal Bhasa", "newari classique"],
+    self["nya", "", "ny", "Chichewa; Chewa; Nyanja", "chichewa; chewa; nyanja"],
+    self["nym", "", "", "Nyamwezi", "nyamwezi"],
+    self["nyn", "", "", "Nyankole", "nyankolé"],
+    self["nyo", "", "", "Nyoro", "nyoro"],
+    self["nzi", "", "", "Nzima", "nzema"],
+    self["oci", "", "oc", "Occitan (post 1500); Provençal", "occitan (après 1500); provençal"],
+    self["oji", "", "oj", "Ojibwa", "ojibwa"],
+    self["ori", "", "or", "Oriya", "oriya"],
+    self["orm", "", "om", "Oromo", "galla"],
+    self["osa", "", "", "Osage", "osage"],
+    self["oss", "", "os", "Ossetian; Ossetic", "ossète"],
+    self["ota", "", "", "Turkish, Ottoman (1500-1928)", "turc ottoman (1500-1928)"],
+    self["oto", "", "", "Otomian languages", "otomi, langues"],
+    self["paa", "", "", "Papuan languages", "papoues, langues"],
+    self["pag", "", "", "Pangasinan", "pangasinan"],
+    self["pal", "", "", "Pahlavi", "pahlavi"],
+    self["pam", "", "", "Pampanga; Kapampangan", "pampangan"],
+    self["pan", "", "pa", "Panjabi; Punjabi", "pendjabi"],
+    self["pap", "", "", "Papiamento", "papiamento"],
+    self["pau", "", "", "Palauan", "palau"],
+    self["peo", "", "", "Persian, Old (ca.600-400 B.C.)", "perse, vieux (ca. 600-400 av. J.-C.)"],
+    self["per", "fas", "fa", "Persian", "persan"],
+    self["phi", "", "", "Philippine languages", "philippines, langues"],
+    self["phn", "", "", "Phoenician", "phénicien"],
+    self["pli", "", "pi", "Pali", "pali"],
+    self["pol", "", "pl", "Polish", "polonais"],
+    self["pon", "", "", "Pohnpeian", "pohnpei"],
+    self["por", "", "pt", "Portuguese", "portugais"],
+    self["pra", "", "", "Prakrit languages", "prâkrit, langues"],
+    self["pro", "", "", "Provençal, Old (to 1500)", "provençal ancien (jusqu'à 1500)"],
+    self["pus", "", "ps", "Pushto; Pashto", "pachto"],
+    self["qaa-qtz", "", "", "Reserved for local use", "réservée à l'usage local"],
+    self["que", "", "qu", "Quechua", "quechua"],
+    self["raj", "", "", "Rajasthani", "rajasthani"],
+    self["rap", "", "", "Rapanui", "rapanui"],
+    self["rar", "", "", "Rarotongan; Cook Islands Maori", "rarotonga; maori des îles Cook"],
+    self["roa", "", "", "Romance languages", "romanes, langues"],
+    self["roh", "", "rm", "Romansh", "romanche"],
+    self["rom", "", "", "Romany", "tsigane"],
+    self["rum", "ron", "ro", "Romanian; Moldavian; Moldovan", "roumain; moldave"],
+    self["run", "", "rn", "Rundi", "rundi"],
+    self["rup", "", "", "Aromanian; Arumanian; Macedo-Romanian", "aroumain; macédo-roumain"],
+    self["rus", "", "ru", "Russian", "russe"],
+    self["sad", "", "", "Sandawe", "sandawe"],
+    self["sag", "", "sg", "Sango", "sango"],
+    self["sah", "", "", "Yakut", "iakoute"],
+    self["sai", "", "", "South American Indian (Other)", "indiennes d'Amérique du Sud, autres langues"],
+    self["sal", "", "", "Salishan languages", "salishennes, langues"],
+    self["sam", "", "", "Samaritan Aramaic", "samaritain"],
+    self["san", "", "sa", "Sanskrit", "sanskrit"],
+    self["sas", "", "", "Sasak", "sasak"],
+    self["sat", "", "", "Santali", "santal"],
+    self["scn", "", "", "Sicilian", "sicilien"],
+    self["sco", "", "", "Scots", "écossais"],
+    self["sel", "", "", "Selkup", "selkoupe"],
+    self["sem", "", "", "Semitic languages", "sémitiques, langues"],
+    self["sga", "", "", "Irish, Old (to 900)", "irlandais ancien (jusqu'à 900)"],
+    self["sgn", "", "", "Sign Languages", "langues des signes"],
+    self["shn", "", "", "Shan", "chan"],
+    self["sid", "", "", "Sidamo", "sidamo"],
+    self["sin", "", "si", "Sinhala; Sinhalese", "singhalais"],
+    self["sio", "", "", "Siouan languages", "sioux, langues"],
+    self["sit", "", "", "Sino-Tibetan languages", "sino-tibétaines, langues"],
+    self["sla", "", "", "Slavic languages", "slaves, langues"],
+    self["slo", "slk", "sk", "Slovak", "slovaque"],
+    self["slv", "", "sl", "Slovenian", "slovène"],
+    self["sma", "", "", "Southern Sami", "sami du Sud"],
+    self["sme", "", "se", "Northern Sami", "sami du Nord"],
+    self["smi", "", "", "Sami languages", "sames, langues"],
+    self["smj", "", "", "Lule Sami", "sami de Lule"],
+    self["smn", "", "", "Inari Sami", "sami d'Inari"],
+    self["smo", "", "sm", "Samoan", "samoan"],
+    self["sms", "", "", "Skolt Sami", "sami skolt"],
+    self["sna", "", "sn", "Shona", "shona"],
+    self["snd", "", "sd", "Sindhi", "sindhi"],
+    self["snk", "", "", "Soninke", "soninké"],
+    self["sog", "", "", "Sogdian", "sogdien"],
+    self["som", "", "so", "Somali", "somali"],
+    self["son", "", "", "Songhai languages", "songhai, langues"],
+    self["sot", "", "st", "Sotho, Southern", "sotho du Sud"],
+    self["spa", "", "es", "Spanish; Castilian", "espagnol; castillan"],
+    self["srd", "", "sc", "Sardinian", "sarde"],
+    self["srn", "", "", "Sranan Tongo", "sranan tongo"],
+    self["srp", "", "sr", "Serbian", "serbe"],
+    self["srr", "", "", "Serer", "sérère"],
+    self["ssa", "", "", "Nilo-Saharan languages", "nilo-sahariennes, langues"],
+    self["ssw", "", "ss", "Swati", "swati"],
+    self["suk", "", "", "Sukuma", "sukuma"],
+    self["sun", "", "su", "Sundanese", "soundanais"],
+    self["sus", "", "", "Susu", "soussou"],
+    self["sux", "", "", "Sumerian", "sumérien"],
+    self["swa", "", "sw", "Swahili", "swahili"],
+    self["swe", "", "sv", "Swedish", "suédois"],
+    self["syc", "", "", "Classical Syriac", "syriaque classique"],
+    self["syr", "", "", "Syriac", "syriaque"],
+    self["tah", "", "ty", "Tahitian", "tahitien"],
+    self["tai", "", "", "Tai languages", "tai, langues"],
+    self["tam", "", "ta", "Tamil", "tamoul"],
+    self["tat", "", "tt", "Tatar", "tatar"],
+    self["tel", "", "te", "Telugu", "télougou"],
+    self["tem", "", "", "Timne", "temne"],
+    self["ter", "", "", "Tereno", "tereno"],
+    self["tet", "", "", "Tetum", "tetum"],
+    self["tgk", "", "tg", "Tajik", "tadjik"],
+    self["tgl", "", "tl", "Tagalog", "tagalog"],
+    self["tha", "", "th", "Thai", "thaï"],
+    self["tib", "bod", "bo", "Tibetan", "tibétain"],
+    self["tig", "", "", "Tigre", "tigré"],
+    self["tir", "", "ti", "Tigrinya", "tigrigna"],
+    self["tiv", "", "", "Tiv", "tiv"],
+    self["tkl", "", "", "Tokelau", "tokelau"],
+    self["tlh", "", "", "Klingon; tlhIngan-Hol", "klingon"],
+    self["tli", "", "", "Tlingit", "tlingit"],
+    self["tmh", "", "", "Tamashek", "tamacheq"],
+    self["tog", "", "", "Tonga (Nyasa)", "tonga (Nyasa)"],
+    self["ton", "", "to", "Tonga (Tonga Islands)", "tongan (Îles Tonga)"],
+    self["tpi", "", "", "Tok Pisin", "tok pisin"],
+    self["tsi", "", "", "Tsimshian", "tsimshian"],
+    self["tsn", "", "tn", "Tswana", "tswana"],
+    self["tso", "", "ts", "Tsonga", "tsonga"],
+    self["tuk", "", "tk", "Turkmen", "turkmène"],
+    self["tum", "", "", "Tumbuka", "tumbuka"],
+    self["tup", "", "", "Tupi languages", "tupi, langues"],
+    self["tur", "", "tr", "Turkish", "turc"],
+    self["tut", "", "", "Altaic languages", "altaïques, langues"],
+    self["tvl", "", "", "Tuvalu", "tuvalu"],
+    self["twi", "", "tw", "Twi", "twi"],
+    self["tyv", "", "", "Tuvinian", "touva"],
+    self["udm", "", "", "Udmurt", "oudmourte"],
+    self["uga", "", "", "Ugaritic", "ougaritique"],
+    self["uig", "", "ug", "Uighur; Uyghur", "ouïgour"],
+    self["ukr", "", "uk", "Ukrainian", "ukrainien"],
+    self["umb", "", "", "Umbundu", "umbundu"],
+    self["und", "", "", "Undetermined", "indéterminée"],
+    self["urd", "", "ur", "Urdu", "ourdou"],
+    self["uzb", "", "uz", "Uzbek", "ouszbek"],
+    self["vai", "", "", "Vai", "vaï"],
+    self["ven", "", "ve", "Venda", "venda"],
+    self["vie", "", "vi", "Vietnamese", "vietnamien"],
+    self["vol", "", "vo", "Volapük", "volapük"],
+    self["vot", "", "", "Votic", "vote"],
+    self["wak", "", "", "Wakashan languages", "wakashanes, langues"],
+    self["wal", "", "", "Walamo", "walamo"],
+    self["war", "", "", "Waray", "waray"],
+    self["was", "", "", "Washo", "washo"],
+    self["wel", "cym", "cy", "Welsh", "gallois"],
+    self["wen", "", "", "Sorbian languages", "sorabes, langues"],
+    self["wln", "", "wa", "Walloon", "wallon"],
+    self["wol", "", "wo", "Wolof", "wolof"],
+    self["xal", "", "", "Kalmyk; Oirat", "kalmouk; oïrat"],
+    self["xho", "", "xh", "Xhosa", "xhosa"],
+    self["yao", "", "", "Yao", "yao"],
+    self["yap", "", "", "Yapese", "yapois"],
+    self["yid", "", "yi", "Yiddish", "yiddish"],
+    self["yor", "", "yo", "Yoruba", "yoruba"],
+    self["ypk", "", "", "Yupik languages", "yupik, langues"],
+    self["zap", "", "", "Zapotec", "zapotèque"],
+    self["zbl", "", "", "Blissymbols; Blissymbolics; Bliss", "symboles Bliss; Bliss"],
+    self["zen", "", "", "Zenaga", "zenaga"],
+    self["zha", "", "za", "Zhuang; Chuang", "zhuang; chuang"],
+    self["znd", "", "", "Zande languages", "zandé, langues"],
+    self["zul", "", "zu", "Zulu", "zoulou"],
+    self["zun", "", "", "Zuni", "zuni"],
+    self["zxx", "", "", "No linguistic content; Not applicable", "pas de contenu linguistique; non applicable"],
+    self["zza", "", "", "Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki", "zaza; dimili; dimli; kirdki; kirmanjki; zazaki"]
+  ]
+  
+  # The ISO 639-1 dataset as an array of entries. Each entry is an array with
+  # the following format:
+  # * [0]: an ISO 369-2 alpha-3 (bibliographic) code
+  # * [1]: an ISO 369-2 alpha-3 (terminologic) code (when given)
+  # * [2]: an ISO 369-1 alpha-2 code (when given)
+  # * [3]: an English name
+  # * [4]: a French name
+  ISO_639_1 = ISO_639_2.collect do |entry|
+    entry unless entry[2].empty?
+  end.compact
+  
+  class << self
+    # Returns the entry array for an alpha-2 or alpha-3 code
+    def find_by_code(code)
+      case code.length
+      when 3
+        ISO_639_2.detect { |entry| entry if entry.alpha3 == code }
+      when 2
+        ISO_639_1.detect { |entry| entry if entry.alpha2 == code }
+      end
+    end
+    alias_method :find, :find_by_code
+    
+    # Returns the entry array for a language specified by its English name.
+    def find_by_english_name(name)
+      ISO_639_2.detect { |entry| entry if entry.english_name == name }
+    end
+    
+    # Returns the entry array for a language specified by its French name.
+    def find_by_french_name(name)
+      ISO_639_2.detect { |entry| entry if entry.french_name == name }
+    end
+  end
+  
+  # The entry's alpha-3 bibliotigraphic code.
+  def alpha3_bibliographic;  self[0] end
+  alias_method :alpha3, :alpha3_bibliographic
+  # The entry's alpha-3 terminologic (when given)
+  def alpha3_terminologic;   self[1] end
+  # The entry's alpha-2 code (when given)
+  def alpha2;               self[2] end
+  # The entry's english name.
+  def english_name;         self[3] end
+  # The entry's french name.
+  def french_name;          self[4] end
+  
+end

data/test/test_ISO_639.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+
+class TestISO639 < Test::Unit::TestCase
+  
+  should "have full code list in ISO_639_2" do
+    assert_equal 485, ISO_639::ISO_639_2.length
+  end
+  
+  should "have shorter code list in ISO_639_1" do
+    assert_equal 184, ISO_639::ISO_639_1.length
+  end
+  
+  should "return entry for alpha-2 code" do
+    assert_equal ["eng", "", "en", "English", "anglais"], ISO_639.find_by_code("en")
+    assert_equal ["eng", "", "en", "English", "anglais"], ISO_639.find("en")
+  end
+  
+  should "find by english name" do
+    assert_equal ["eng", "", "en", "English", "anglais"], ISO_639.find_by_english_name("English")
+  end
+  
+  should "find by french name" do
+    assert_equal ["eng", "", "en", "English", "anglais"], ISO_639.find_by_french_name("anglais")
+  end
+  
+  %w[
+    alpha3_bibliographic
+    alpha3
+    alpha3_terminologic
+    alpha2
+    english_name
+    french_name
+  ].each_with_index do |m, i|
+    should "respond to and return #{m}" do
+      @entry = ISO_639.find("en")
+      assert @entry.respond_to?(m)
+      assert_equal ["eng", "eng", "", "en", "English", "anglais"][i], @entry.send(m)
+    end
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'iso-639'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: iso-639
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- William Melody
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-20 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: ISO 639-1 and ISO 639-2 language code entries and convenience methods
+email: hi@williammelody.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- iso-639.gemspec
+- lib/iso-639.rb
+- test/test_ISO_639.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/autodata/iso-639
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: ISO 639-1 and ISO 639-2 language code entries and convenience methods
+test_files: 
+- test/test_helper.rb
+- test/test_ISO_639.rb