bbenno / languages Goto Github PK

It would be helpful for my use case to be able to access the collective codes included in ISO 639-2 and ISO 639-5, without needing to use separate gems for ISO 639-2/5 and ISO 639-3.

For example, the following returns nil:

require 'languages'
Languages[:nah]
=> nil

Ideally, I would be able to do the following:

Languages[:nah].name
=> "Nahuatl languages"
Languages[:nah].alpha2
=> nil
Languages[:nah].alpha3_bibliographic
=> "nah"
Languages[:nah].type
=> :collective

I understand that these collective codes are not included in ISO 639-3, but it would be helpful to have them all in a single gem.

The collective codes can be found in a file here: http://id.loc.gov/vocabulary/iso639-5.tsv

@bbenno if this fits with the direction of the project, I'd be happy to create a PR for this feature.

User story

As a developer, given an ISO-639-3 language code, I would like to find the name of its macrolanguage.

Specific example

The macrolanguages table lists zho (Chinese) as a macrolanguage of wuu (Wu Chinese).

It would be very convenient if, using this gem, I could do something like the following:

Languages[:wuu]&.macrolanguage
=> #<Languages::Language:0x000000011a48c4c8 @iso639_3=:zho, @iso639_2b=:chi, @iso639_2t=:zho, @iso639_1=:zh, @scope=:macrolanguage, @type=:living, @name="Chinese">

Source data

The macrolanguages table can be found at https://iso639-3.sil.org/sites/iso639-3/files/downloads/iso-639-3-macrolanguages.tab. The first column is the macrolanguage, the second column is the individual language.