https://github.com/grosser/i18n_data
Ruby: country/language names and 2-letter-code pairs, in 85 languages, for country/language i18n
https://github.com/grosser/i18n_data
Last synced: 6 months ago
JSON representation
Ruby: country/language names and 2-letter-code pairs, in 85 languages, for country/language i18n
- Host: GitHub
- URL: https://github.com/grosser/i18n_data
- Owner: grosser
- License: mit
- Created: 2009-01-04T19:20:16.000Z (almost 17 years ago)
- Default Branch: master
- Last Pushed: 2024-09-05T15:28:06.000Z (about 1 year ago)
- Last Synced: 2025-05-11T12:35:52.510Z (6 months ago)
- Language: Ruby
- Homepage:
- Size: 2.03 MB
- Stars: 222
- Watchers: 6
- Forks: 63
- Open Issues: 3
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ruby - i18n_data - country/language names and 2-letter-code pairs, in 85 languages, for country/language i18n. (Country Data)
- awesome-world - i18n_data gem :octocat: - country/language names and 2-letter-code pairs, in 85 languages, for country/language i18n in Ruby (World Data (Countries, Cities, etc.) / More)
README
- Present users coutries/languages in their language
- Convert a country/language-name to its 2-letter-code
- List of 2-letter-code/name pairs for all countries/languages in all languages
### Translations
Through [pkg-isocodes](https://salsa.debian.org/iso-codes-team/iso-codes.git):
- 185 Language codes (iso 639 - 2 letter) in 68 Languages
- 246 Country codes (iso 3166 - 2 letter) in 86 Languages
- Country specific codes e.g. zh_TW are also available, have a look at the isocodes website for all options
Install
=======
```Bash
gem install i18n_data
```
Usage
=====
```Ruby
require 'i18n_data'
...
I18nData.languages # {"DE"=>"German",...}
I18nData.languages('DE') # {"DE"=>"Deutsch",...}
I18nData.languages('FR') # {"DE"=>"Allemand",...}
...
I18nData.countries # {"DE"=>"Germany",...}
I18nData.countries('DE') # {"DE"=>"Deutschland",...}
...
I18nData.language_code('German') # DE
I18nData.language_code('Deutsch') # DE
I18nData.language_code('Allemand') # DE
..
I18nData.country_code('Germany') # DE
I18nData.country_code('Deutschland') # DE
..
```
Data Providers
==============
- FileDataProvider: _FAST_ (default) (loading data from cache-files)
- LiveDataProvider: _SLOW_ (fetching up-to-date data from svn repos)
Development
=======
- update FileDataProvider caches after each code-change to make changes available to users `rake write_cache_for_file_data_provider`
- FileDataProvider tests might fail if caches are not updates
Alphabetical localized sorting
==============================
If you would like to have the countries list sorted alphabetically in different languages there is a gem called [sort_alphabetical](https://github.com/grosser/sort_alphabetical) for that.
TODO
====
- include other language/country code formats (3-letter codes...) ?
- parse list of files on isocodes for write_cache instead of hardcoding country-specific ones
- rake task that checks that the readme is updated with language/country counters
Authors
=======
### [Contributors](https://github.com/grosser/i18n_data/contributors)
- [Barry Allard](https://github.com/steakknife)
- [Richard Doe](https://github.com/rwd)
[Michael Grosser](http://grosser.it)
michael@grosser.it
License: MIT
[](https://github.com/grosser/i18n_data/actions/workflows/actions.yml?query=branch%3Amaster)