mini_i18n 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7a18d6e7a53f09252437f9557843123ec13e0838
+  data.tar.gz: 07a9b806306b8d5fd249de308fda043f4f855b41
+SHA512:
+  metadata.gz: d2b2e9c69c77528d54bbd24d723441d0cbe009001855ce77fe69fe164738956ec021e5ccb6288adf588997c50735a305336b1da7ace3186f8239c9afedd3e4a1
+  data.tar.gz: 0ae3f4faa23a0f81088d7180afa463b419f2309af6b0aedc715bb853208b4f7cd0bf91b4a3eecc2eabdb8037db00a83029fb35ed65925f2cc0b134340a2db9c8

data/lib/mini_i18n/utils.rb

@@ -0,0 +1,31 @@
+module MiniI18n
+  module Utils
+    extend self
+
+    def interpolate(string, keys)
+      string % keys
+    rescue KeyError
+      string
+    end
+
+    def replace_with(array, old_elem, new_elem)
+      array.map { |elem| elem == old_elem ? new_elem : elem }
+    end
+
+    def deep_merge(merge_to, merge_from)
+      merged = merge_to.clone
+
+      merge_from.each do |key, value|
+        key = key.to_s
+
+        if value.is_a?(Hash) && merged[key].is_a?(Hash)
+          merged[key] = deep_merge(merged[key], value)
+        else
+          merged[key] = value
+        end
+      end
+
+      merged
+    end
+  end
+end

data/lib/mini_i18n/version.rb

@@ -0,0 +1,3 @@
+module MiniI18n
+  VERSION = "0.1.0"
+end

data/lib/mini_i18n.rb

@@ -0,0 +1,105 @@
+require "yaml"
+require "mini_i18n/version"
+require "mini_i18n/utils"
+
+module MiniI18n
+  class << self
+    DEFAULT_LOCALE = :en
+    SEPARATOR = '.'
+
+    attr_accessor :fallbacks
+
+    def default_locale
+      @@default_locale ||= DEFAULT_LOCALE
+    end
+
+    def default_locale=(new_locale)
+      @@default_locale = valid_locale?(new_locale) || default_locale
+    end
+
+    def default_available_locales
+      @@default_available_locales ||= translations.keys
+    end
+
+    def available_locales
+      @@available_locales ||= default_available_locales
+    end
+
+    def available_locales=(new_locales)
+      @@available_locales = new_locales.map(&:to_s)
+    end
+
+    def translations
+      @@translations ||= {}
+    end
+
+    def locale
+      Thread.current[:mini_i18n_locale] ||= default_locale
+    end
+
+    def locale=(new_locale)
+      set_locale(new_locale)
+    end
+
+    def configure
+      yield(self) if block_given?
+    end
+
+    def load_translations(path)
+      Dir[path].each do |file|
+        _translations = YAML.load_file(file)
+        _translations.each do |locale, values|
+          locale = locale.to_s
+          @@available_locales << locale unless available_locale?(locale)
+
+          if translations[locale]
+            translations[locale] = Utils.deep_merge(translations[locale], values)
+          else
+            translations[locale] = values
+          end
+        end
+      end
+    end
+
+    def translate(key, options = {})
+      return if key.empty? || translations.empty?
+
+      _locale = available_locale?(options[:locale]) || locale
+      scope = options[:scope]
+
+      keys = [_locale.to_s]
+      keys << scope.to_s.split(SEPARATOR) if scope
+      keys << key.to_s.split(SEPARATOR)
+      keys = keys.flatten
+
+      result = translations.dig(*keys)
+
+      if fallbacks && result.empty?
+        keys = Utils.replace_with(keys, _locale, default_locale.to_s)
+        result = translations.dig(*keys)
+      end
+
+      if result.respond_to?(:match) && result.match(/%{\w+}/)
+        result = Utils.interpolate(result, options)
+      end
+
+      result || options[:default]
+    end
+    alias t translate
+
+    private
+
+    def set_locale(new_locale)
+      new_locale = new_locale.to_s
+      if available_locale?(new_locale)
+        Thread.current[:mini_i18n_locale] = new_locale
+      end
+      locale
+    end
+
+    def available_locale?(new_locale)
+      new_locale = new_locale.to_s
+      available_locales.include?(new_locale) && new_locale
+    end
+  end
+end

data/spec/fixtures/locales/en.yml

@@ -0,0 +1,6 @@
+en:
+  hello: "hello"
+  hello_interpolation: "hello %{name}"
+  fallback: "fallback"
+  second_level:
+    hello: ""

data/spec/fixtures/locales/multiple.yml

@@ -0,0 +1,19 @@
+en:
+  bye: "bye"
+  second_level:
+    hello: "hello 2"
+
+es:
+  hello: "hola"
+  hello_interpolation: "hola %{name}"
+  fallback: ""
+  bye: "adiós"
+  second_level:
+    hello: "hola 2"
+
+fr:
+  hello: "bonjour"
+  hello_interpolation: "bonjour %{name}"
+  bye: "au revoir"
+  second_level:
+    hello: "bonjour 2"

data/spec/mini_i18n_spec.rb

@@ -0,0 +1,68 @@
+RSpec.describe MiniI18n do
+  before(:all) do
+    MiniI18n.load_translations File.expand_path(__dir__ + '/fixtures/locales/*')
+  end
+
+  before(:each) do
+    MiniI18n.locale = :en
+    MiniI18n.fallbacks = false
+  end
+
+  describe 'load_translations' do
+    it "allows to load multiple locales and translations from different files" do
+      expect(MiniI18n.available_locales).to eq ["en", "es", "fr"]
+      expect(MiniI18n.translations.size). to eq 3
+      expect(MiniI18n.translations["en"]).to include 'bye'
+    end
+  end
+
+  describe 'translate' do
+    it "simple key" do
+      expect(MiniI18n.t(:hello)).to eq 'hello'
+    end
+
+    it "nested key" do
+      expect(MiniI18n.t('second_level')).to be_a Hash
+      expect(MiniI18n.t('second_level.hello')).to eq 'hello 2'
+    end
+
+    it "locale" do
+      expect(MiniI18n.t('hello', locale: :fr)).to eq 'bonjour'
+      expect(MiniI18n.t('hello', locale: :es)).to eq 'hola'
+    end
+
+    it "scope" do
+      expect(MiniI18n.t('hello', scope: :second_level)).to eq 'hello 2'
+    end
+
+    it "returns nil if key does not exist" do
+      expect(MiniI18n.t('foo')).to eq nil
+    end
+
+    it "returns default if key does not exist" do
+      expect(MiniI18n.t('foo', default: 'bar')).to eq 'bar'
+    end
+
+    it "with interpolation" do
+      expect(MiniI18n.t('hello_interpolation')).to eq 'hello %{name}'
+      expect(MiniI18n.t('hello_interpolation', name: 'world')).to eq 'hello world'
+    end
+
+    it "fallbacks" do
+      expect(MiniI18n.t('fallback', locale: :es)).to eq ''
+
+      MiniI18n.fallbacks = true
+      expect(MiniI18n.t('fallback', locale: :es)).to eq 'fallback'
+    end
+  end
+
+  describe 'locale' do
+    it 'allows to change locale globally' do
+      MiniI18n.locale = :en
+      expect(MiniI18n.t(:hello)).to eq 'hello'
+
+      MiniI18n.locale = :es
+      expect(MiniI18n.t(:hello)).to eq 'hola'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require "mini_i18n"
+
+RSpec.configure do |config|
+  config.order = :rand
+  config.disable_monkey_patching!
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: mini_i18n
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- markets
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-17 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.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- srmarc.ai@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mini_i18n.rb
+- lib/mini_i18n/utils.rb
+- lib/mini_i18n/version.rb
+- spec/fixtures/locales/en.yml
+- spec/fixtures/locales/multiple.yml
+- spec/mini_i18n_spec.rb
+- spec/spec_helper.rb
+homepage: 
+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.13
+signing_key: 
+specification_version: 4
+summary: Minimalist I18n library
+test_files:
+- spec/fixtures/locales/en.yml
+- spec/fixtures/locales/multiple.yml
+- spec/mini_i18n_spec.rb
+- spec/spec_helper.rb