iso¶ ↑
This project is a ruby implementation of ISO
639-1 alpha2 and ISO
3166-1. It includes definitions of all two letter language and region codes.
Languages¶ ↑
Languages are defined by ISO 639-1 alpha-2; that is the 2 letter lowercase language code.
These have been augmented to contain the plural rule names and the language's direction.
> ISO::Language.find('ru') => #<ISO::Language:0x007fe2ba43db50 @plural_rule_names=["one", "few", "many", "other"], @direction="ltr", @code="ru", @name="Russian">
Regions¶ ↑
Regions are defined by ISO 3166-1; that is the 2 letter uppercase region code.
> ISO::Region.find('MX') => #<ISO::Region:0x007fe2ba070e50 @code="MX", @name="Mexico">
Regions can also be defined by the UN M49 standard; that is the 3 digit region code.
> ISO::UN::Region.find('419') => #<ISO::Region:0x007fe2ba43db50 @code="419", @name="Latin America and the Caribbean">
Tags¶ ↑
The combination of a language and a region is called a Tag :
> ISO::Tag.new('pt-BR') => #<ISO::Tag:0x007fe2bb005b90 @code="pt-BR", @language=#<ISO::Language:0x007fe2ba256918 @plural_rule_names=["one", "other"], @direction="ltr", @code="pt", @name="Portuguese">, @region=#<ISO::Region:0x007fe2ba412e28 @code="BR", @name="Brazil">>
You can check if a Tag is valid like so :
> ISO::Tag.new('pt-BR').valid? => true > ISO::Tag.new('lolcat').valid? => false
I18n¶ ↑
Language and region names are internationalized - contribute to the I18n project directly on Locale for any changes.