Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: about 2 months ago
JSON representation

Ruby: country/language names and 2-letter-code pairs, in 85 languages, for country/language i18n

Awesome Lists containing this project

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)

[email protected]

License: MIT

[![CI](https://github.com/grosser/i18n_data/actions/workflows/actions.yml/badge.svg)](https://github.com/grosser/i18n_data/actions/workflows/actions.yml?query=branch%3Amaster)