country_to_locales_mapping 0.1.0

data/lib/country_to_locales_mapping.rb

@@ -0,0 +1,15 @@
+require "country_to_locales_mapping/version"
+require "country_to_locales_mapping/mapping"
+
+module CountryToLocalesMapping
+
+  module_function
+
+  def locale_country_codes(l)
+    Mapping::instance.locale_country_codes(l)
+  end
+
+  def country_code_locales(c)
+    Mapping::instance.country_code_locales(c)
+  end
+end

data/lib/country_to_locales_mapping/mapping.rb

@@ -0,0 +1,105 @@
+# (c) Copyright 2017 Ribose Inc.
+#
+
+require "json"
+require "singleton"
+
+module CountryToLocalesMapping
+  #
+  # Provides a mapping between ISO3166 country codes and RFC4646 locale
+  # codes. Locale codes are placed in order of usage in the region
+  # (e.g. de-CH > fr-CH > it-CH).
+  #
+  # Country-Locale data is stored in:
+  #   root/config/i18n/country_locale_map.csv
+  #
+  # Country-Locale csv columns:
+  #
+  #   ISO3166 Country Code,
+  #   Country name, (not used in processing)
+  #   RFC4646 Locale code,
+  #   (all columns after are RFC4646 Locale codes)
+  #
+  #   RFC4646 Locale codes are ordered to indicate preference.
+  #   i.e. locale code in column 3 is more important than the locale code
+  #   in column 5 for a country.
+  #
+  #   First Locale code always reflects the official language of country
+  #   (but might not be only official language, e.g. CH).
+  #
+  #
+  # Sources considered:
+  #   http://www.i18nguy.com/unicode/language-identifiers.html
+  #   http://www.infoplease.com/ipa/A0855611.html
+  #
+
+  #
+  # TODO: Give each locale a preference value: e.g. de-CH 0.6, fr-CH 0.3
+  #
+  class Mapping
+    include Singleton
+    attr_accessor :cc, :ll
+
+    def initialize
+      @cc = {}
+      @ll = {}
+      import_locale_map
+    end
+
+    # Imports country-locale map to memory for upcoming
+    # queries
+    def import_locale_map
+      json = JSON.parse(File.read(path_to_json))
+
+      json["countries"].each_pair do |country_code, country_data|
+        country_name = country_data["name"]
+        languages = country_data["locales"]
+
+        associate_country_with_locales(country_name, country_code, languages)
+      end
+    end
+
+    # Returns an array of country codes that match the given locale code.
+    #
+    # Note: Since in our current mapping, "en" is not assigned to any
+    # country, so "en" will not match anything while "en-us" will return
+    # "us".
+    #
+    def locale_country_codes(l)
+      if l.nil? || !@ll.has_key?(l)
+        raise ArgumentError, "Locale not recognized: #{l}"
+      end
+
+      @ll[l][:ccodes]
+    end
+
+    # Returns an array of locale ids that match the given country code.
+    #
+    def country_code_locales(c)
+      if c.nil? || !@cc.has_key?(c)
+        raise ArgumentError, "Country code not recognized: #{c}"
+      end
+
+      @cc[c][:locales]
+    end
+
+    private
+
+    def associate_country_with_locales(country_name, country_code, languages)
+      @cc[country_code] = {
+        name: country_name,
+        locales: languages,
+      }
+
+      languages.each do |l|
+        @ll[l] ||= {}
+        @ll[l][:ccodes] ||= []
+        @ll[l][:ccodes].push country_code
+      end
+    end
+
+    def path_to_json
+      File.expand_path("../../../data/country_locale_map.json", __FILE__)
+    end
+  end
+end

data/lib/country_to_locales_mapping/version.rb

@@ -0,0 +1,3 @@
+module CountryToLocalesMapping
+  VERSION = "0.1.0".freeze
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: country_to_locales_mapping
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ribose Inc.
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-03-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- open.source@ribose.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.ribose.yml"
+- ".rubocop.tb.yml"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.adoc
+- Rakefile
+- bin/console
+- bin/setup
+- country_to_locales_mapping.gemspec
+- data/country_locale_map.json
+- lib/country_to_locales_mapping.rb
+- lib/country_to_locales_mapping/mapping.rb
+- lib/country_to_locales_mapping/version.rb
+homepage: https://github.com/riboseinc/country_to_locales_mapping
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Languages spoken in each country, distributed as gem
+test_files: []