A Ruby gem that provides the ISO 639-2 and ISO 639-1 data sets along with some convenience methods for accessing different entries and entry fields. The data comes from the LOC ISO 639-2 UTF-8 data set.
The 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.
To install from RubyGems:
gem install iso-639
To install with Bundler, add the following to your Gemfile:
To find a language entry:
# by alpha-2 or alpha-3 code .("en") # or .find("en") # by English name .("Russian") # by French name .("français")
ISO_639.search class method searches across all fields and will
match names in cases where a record has multiple names. This method
always returns an array of 0 or more results. For example:
.("spanish") # => [["spa", "", "es", "Spanish; Castilian", "espagnol; castillan"]]
Entries are arrays with convenience methods for accessing fields:
@entry = .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
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 (c) 2010 William Melody. See LICENSE for details.