i18n-inflector 1.0.0

data/test/backend/inflection_test.rb

@@ -0,0 +1,249 @@
+require 'test_helper'
+
+class I18nBackendInflectionTest < Test::Unit::TestCase
+  class Backend < I18n::Backend::Simple
+    include I18n::Backend::Inflector
+    include I18n::Backend::Fallbacks
+  end
+
+  def setup
+    I18n.backend = Backend.new
+    store_translations(:xx, :i18n => { :inflections => {
+                                            :gender => {
+                                              :m => 'male',
+                                              :f => 'female',
+                                              :n => 'neuter',
+                                              :s => 'strange',
+                                              :masculine  => '@m',
+                                              :feminine   => '@f',
+                                              :neuter     => '@n',
+                                              :neutral    => '@neuter',
+                                              :default    => 'neutral' },
+                                            :person => {
+                                              :i   => 'I',
+                                              :you => 'You'}
+                                        }   })
+
+    store_translations(:xx, 'welcome' => 'Dear @{f:Lady|m:Sir|n:You|All}!')
+  end
+
+  test "inflector has methods to test its switches" do
+    assert_equal true,  I18n.backend.inflector_unknown_defaults   = true
+    assert_equal false, I18n.backend.inflector_excluded_defaults  = false
+    assert_equal false, I18n.backend.inflector_raises             = false
+    assert_equal false, I18n.backend.inflector_raises?
+    assert_equal true,  I18n.backend.inflector_unknown_defaults?
+    assert_equal false, I18n.backend.inflector_excluded_defaults?
+  end
+
+  test "inflector store_translations: regenerates inflection structures when translations are loaded" do
+    store_translations(:xx, :i18n => { :inflections => { :gender => { :o => 'other' }}})
+    store_translations(:xx, 'hi' => 'Dear @{f:Lady|o:Others|n:You|All}!')
+    assert_equal 'Dear Others!',  I18n.t('hi', :gender => :o,       :locale => :xx)
+    assert_equal 'Dear Lady!',    I18n.t('hi', :gender => :f,       :locale => :xx)
+    assert_equal 'Dear You!',     I18n.t('hi', :gender => :unknown, :locale => :xx)
+    assert_equal 'Dear All!',     I18n.t('hi', :gender => :m,       :locale => :xx)
+  end
+
+  test "inflector store_translations: raises I18n::DuplicatedInflectionToken when duplicated token is given" do
+    assert_raise I18n::DuplicatedInflectionToken do
+      store_translations(:xx, :i18n => { :inflections => { :gender => { :o => 'other' }, :person => { :o => 'o' }}})
+    end
+  end
+  
+  test "inflector store_translations: raises I18n::BadInflectionAlias when bad alias is given" do
+     assert_raise I18n::BadInflectionAlias do
+       store_translations(:xx, :i18n => { :inflections => { :gender => { :o => '@nonexistant' }}})
+     end
+     assert_raise I18n::BadInflectionAlias do
+       store_translations(:xx, :i18n => { :inflections => { :gender => { :default => '@nonexistant' }}})
+     end
+   end
+
+   test "inflector store_translations: raises I18n::BadInflectionToken when duplicated token is given" do
+     assert_raise I18n::BadInflectionToken do
+       store_translations(:xx, :i18n => { :inflections => { :gender => { :o => '@' }}})
+       store_translations(:xx, :i18n => { :inflections => { :gender => { :tok => nil }}})
+     end
+   end
+
+  test "inflector translate: picks Lady for :f gender option" do
+    assert_equal 'Dear Lady!', I18n.t('welcome', :gender => :f, :locale => :xx)
+  end
+
+  test "inflector translate: picks Lady for f gender option" do
+    assert_equal 'Dear Lady!', I18n.t('welcome', :gender => 'f', :locale => :xx)
+  end
+  
+  test "inflector translate: picks Sir for :m gender option"  do
+    assert_equal 'Dear Sir!', I18n.t('welcome', :gender => :m, :locale => :xx)
+  end
+  
+  test "inflector translate: picks Sir for :masculine gender option" do
+    assert_equal 'Dear Sir!', I18n.t('welcome', :gender => :masculine, :locale => :xx)
+  end
+  
+  test "inflector translate: picks Sir for masculine gender option" do
+    assert_equal 'Dear Sir!', I18n.t('welcome', :gender => 'masculine', :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to default for the unknown gender option" do
+    assert_equal 'Dear You!', I18n.t('welcome', :gender => :unknown, :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to default for a gender option set to nil" do
+    assert_equal 'Dear You!', I18n.t('welcome', :gender => nil, :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to default for no gender option" do
+    assert_equal 'Dear You!', I18n.t('welcome', :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to free text for the proper gender option but not present in pattern" do
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :s, :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to free text when :inflector_unknown_defaults is false" do
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :unknown,  :locale => :xx, :inflector_unknown_defaults => false)
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :s,        :locale => :xx, :inflector_unknown_defaults => false)
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => nil,       :locale => :xx, :inflector_unknown_defaults => false)
+  end
+
+  test "inflector translate: falls back to default for no gender option when :inflector_unknown_defaults is false" do
+    assert_equal 'Dear You!', I18n.t('welcome', :locale => :xx, :inflector_unknown_defaults => false)
+  end
+  
+  test "inflector translate: falls back to free text for the unknown gender option when global inflector_unknown_defaults is false" do
+    I18n.backend.inflector_unknown_defaults = false
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :unknown, :locale => :xx)
+  end
+  
+  test "inflector translate: falls back to default for the unknown gender option when global inflector_unknown_defaults is overriden" do
+    I18n.backend.inflector_unknown_defaults = false
+    assert_equal 'Dear You!', I18n.t('welcome', :gender => :unknown, :locale => :xx, :inflector_unknown_defaults => true)
+  end
+    
+  test "inflector translate: falls back to default token for ommited gender option when :inflector_excluded_defaults is true" do
+    assert_equal 'Dear You!', I18n.t('welcome', :gender => :s, :locale => :xx, :inflector_excluded_defaults => true)
+    I18n.backend.inflector_excluded_defaults = true
+    assert_equal 'Dear You!', I18n.t('welcome', :gender => :s, :locale => :xx)
+  end
+
+  test "inflector translate: falls back to free text for ommited gender option when :inflector_excluded_defaults is false" do
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :s, :locale => :xx, :inflector_excluded_defaults => false)
+    I18n.backend.inflector_excluded_defaults = false
+    assert_equal 'Dear All!', I18n.t('welcome', :gender => :s, :locale => :xx)
+  end
+
+  test "inflector translate: works with %{} patterns" do
+    store_translations(:xx, 'hi' => 'Dear @{f:Lady|m:%{test}}!')
+    assert_equal 'Dear Dude!', I18n.t('hi', :gender => :m, :locale => :xx, :test => "Dude")
+  end
+
+  test "inflector translate: raises I18n::InvalidOptionForKind when bad kind is given and inflector_raises is true" do
+    assert_nothing_raised I18n::InvalidOptionForKind do
+      I18n.t('welcome', :locale => :xx, :inflector_raises => true)
+    end
+    tr = I18n.backend.send(:translations)
+    tr[:xx][:i18n][:inflections][:gender].delete(:default)
+    store_translations(:xx, :i18n => { :inflections => { :gender => { :o => 'other' }}})
+    assert_raise(I18n::InvalidOptionForKind) { I18n.t('welcome', :locale => :xx, :inflector_raises => true) }
+    assert_raise(I18n::InvalidOptionForKind) { I18n.t('welcome', :locale => :xx, :gender => "", :inflector_raises => true) }
+    assert_raise(I18n::InvalidOptionForKind) { I18n.t('welcome', :locale => :xx, :gender => nil, :inflector_raises => true) }
+    assert_raise I18n::InvalidOptionForKind do
+     I18n.backend.inflector_raises = true
+     I18n.t('welcome', :locale => :xx)
+    end
+  end
+
+  test "inflector translate: raises I18n::InvalidInflectionToken when bad token is given and inflector_raises is true" do
+    store_translations(:xx, 'hi' => 'Dear @{f:Lady|o:BAD_TOKEN|n:You|First}!')
+    assert_raise(I18n::InvalidInflectionToken) { I18n.t('hi', :locale => :xx, :inflector_raises => true) }
+    assert_raise I18n::InvalidInflectionToken do
+      I18n.backend.inflector_raises = true
+      I18n.t('hi', :locale => :xx)
+    end
+  end
+
+  test "inflector translate: raises I18n::MisplacedInflectionToken when bad token is given and inflector_raises is true" do
+    store_translations(:xx, 'hi' => 'Dear @{f:Lady|i:Me|n:You|First}!')
+    assert_raise(I18n::MisplacedInflectionToken) { I18n.t('hi', :locale => :xx, :inflector_raises => true) }
+    assert_raise I18n::MisplacedInflectionToken do
+      I18n.backend.inflector_raises = true
+      I18n.t('hi', :locale => :xx)
+    end
+  end
+
+  test "inflector inflected_locales: lists languages that support inflection" do
+    assert_equal [:xx], I18n.backend.inflected_locales
+    assert_equal [:xx], I18n.backend.inflected_locales(:gender)
+  end
+
+  test "inflector available_inflection_kinds: lists inflection kinds" do
+    assert_not_nil I18n.backend.available_inflection_kinds(:xx)
+    assert_equal [:gender,:person], I18n.backend.available_inflection_kinds(:xx).sort{|k,v| k.to_s<=>v.to_s}
+    I18n.locale = :xx
+    assert_equal [:gender,:person], I18n.backend.available_inflection_kinds.sort{|k,v| k.to_s<=>v.to_s}
+  end
+
+  test "inflector inflection_tokens: lists inflection tokens" do
+    h = {:m=>"male",:f=>"female",:n=>"neuter",:s=>"strange",
+         :masculine=>"male",:feminine=>"female",:neuter=>"neuter",
+         :neutral=>"neuter"}
+    ha = h.merge(:i=>'I', :you=>'You')
+    assert_equal h, I18n.backend.inflection_tokens(:gender, :xx)
+    I18n.locale = :xx
+    assert_equal h, I18n.backend.inflection_tokens(:gender)
+    assert_equal ha, I18n.backend.inflection_tokens
+  end
+
+  test "inflector inflection_true_tokens: lists true tokens" do
+    h  = {:m=>"male",:f=>"female",:n=>"neuter",:s=>"strange"}
+    ha = h.merge(:i=>"I",:you=>"You")
+    assert_equal h, I18n.backend.inflection_true_tokens(:gender, :xx)
+    I18n.locale = :xx
+    assert_equal h, I18n.backend.inflection_true_tokens(:gender)
+    assert_equal ha, I18n.backend.inflection_true_tokens
+  end
+
+  test "inflector inflection_raw_tokens: lists tokens in a so called raw format" do
+    h = {:m=>"male",:f=>"female",:n=>"neuter",:s=>"strange",
+         :masculine=>:m,:feminine=>:f,:neuter=>:n,
+         :neutral=>:n}
+    ha = h.merge(:i=>'I',:you=>"You")
+    assert_equal h, I18n.backend.inflection_raw_tokens(:gender, :xx)
+    I18n.locale = :xx
+    assert_equal h, I18n.backend.inflection_raw_tokens(:gender)
+    assert_equal ha, I18n.backend.inflection_raw_tokens    
+  end
+
+  test "inflector inflection_default_token: returns a default token for a kind" do
+    assert_equal :n, I18n.backend.inflection_default_token(:gender, :xx)
+    I18n.locale = :xx
+    assert_equal :n, I18n.backend.inflection_default_token(:gender)
+  end
+
+  test "inflector inflection_aliases: lists aliases" do
+    a = {:masculine=>:m, :feminine=>:f, :neuter=>:n, :neutral=>:n}
+    assert_equal a, I18n.backend.inflection_aliases(:gender, :xx)
+    I18n.locale = :xx
+    assert_equal a, I18n.backend.inflection_aliases(:gender)
+    assert_equal a, I18n.backend.inflection_aliases
+  end
+  
+  test "inflector inflection_token_description: returns token's description" do
+    assert_equal "male", I18n.backend.inflection_token_description(:m, :xx)
+    I18n.locale = :xx
+    assert_equal "male", I18n.backend.inflection_token_description(:m)
+    assert_equal nil, I18n.backend.inflection_token_description(:nonexistent, :xx)
+    assert_equal "neuter", I18n.backend.inflection_token_description(:neutral, :xx)
+  end
+  
+  test "inflector inflection_is_alias?: tests whether a token is an alias" do
+      assert_equal true, I18n.backend.inflection_is_alias?(:neutral, :xx)
+      assert_equal false, I18n.backend.inflection_is_alias?(:you, :xx)
+      I18n.locale = :xx
+      assert_equal true, I18n.backend.inflection_is_alias?(:neutral)
+  end
+    
+end

data/test/run_all.rb

@@ -0,0 +1,21 @@
+def bundle_check
+  `bundle check` == "The Gemfile's dependencies are satisfied\n"
+end
+
+command  = 'ruby -w -Ilib -Itest test/all.rb'
+gemfiles = %w(ci/Gemfile)
+
+results = gemfiles.map do |gemfile|
+  puts "BUNDLE_GEMFILE=#{gemfile}"
+  ENV['BUNDLE_GEMFILE'] = gemfile
+
+  unless bundle_check
+    puts "bundle install"
+    system('bundle install')
+  end
+
+  puts command
+  system('ruby -w -Ilib -Itest test/all.rb')
+end
+
+exit(results.inject(true) { |a, b| a && b })

data/test/test_helper.rb

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'test/unit'
+require 'bundler/setup'
+require 'i18n-inflector'
+require 'test_declarative'
+
+class Test::Unit::TestCase
+  def teardown
+    I18n.locale             = nil
+    I18n.default_locale     = :en
+    I18n.load_path          = []
+    I18n.available_locales  = nil
+    I18n.backend            = nil
+  end
+
+  def translations
+    I18n.backend.instance_variable_get(:@translations)
+  end
+
+  def store_translations(*args)
+    data   = args.pop
+    locale = args.pop || :en
+    I18n.backend.store_translations(locale, data)
+  end
+
+end
+
+Object.class_eval do
+  def meta_class
+    class << self; self; end
+  end
+end unless Object.method_defined?(:meta_class)

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification 
+name: i18n-inflector
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- "Pawe\xC5\x82 Wilk"
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDKjCCAhKgAwIBAgIBADANBgkqhkiG9w0BAQUFADA7MQ8wDQYDVQQDDAZzaWVm
+  Y2ExEzARBgoJkiaJk/IsZAEZFgNnbnUxEzARBgoJkiaJk/IsZAEZFgNvcmcwHhcN
+  MDkwNjA2MDkwODA5WhcNMTAwNjA2MDkwODA5WjA7MQ8wDQYDVQQDDAZzaWVmY2Ex
+  EzARBgoJkiaJk/IsZAEZFgNnbnUxEzARBgoJkiaJk/IsZAEZFgNvcmcwggEiMA0G
+  CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCdk4+9ieSx2I2OPslPcj/LjajwtsrH
+  mev6Fs3xK9hdDIbbLuQM9AypBS7NeKP/2YToEOGxsvzcpFzL2Ah71cP6Yfn+Z2Yo
+  zvqpAx5/nl79PrJKvjlkdzVNOFBp/EOkLK67QK4Pv97ABnG2PkF4FokqOjuNHLM7
+  47OkJPvFyfHyMBDZN7EFljBBNm3IuQRTiO48e5Jcp3L761PWOvCpnV8wiga0Wwt3
+  98Gmy7c1nWzfbQc1wHwKLPICY/aidKU20KymSHG63BSW5pO2cXZecIeYjw5YNjGA
+  M1RZMiwT7QJ9W86VVP+8EqbJKJOS95xlmQTHjPK56yXv8GiuyLQHpPh5AgMBAAGj
+  OTA3MAkGA1UdEwQCMAAwHQYDVR0OBBYEFKOKspZONq4bt5D2DEexB+vsMB2GMAsG
+  A1UdDwQEAwIEsDANBgkqhkiG9w0BAQUFAAOCAQEAUh0LnB4o5XKpH3yOxavEyp9X
+  Nen2e854wsSjAr0waSVzEt3XxY1voyIE6WCGxZJU//40CR0Be7j5CcsJsDU2CZyZ
+  8SXN1/mZjMqWvYyEMSfQP4XzkFSOuyDcoDAf43OGhOhdv5Jcs/Et/FH6DgWYwRxq
+  RtATRWON5R99ugPeRb7i1nIpnzGEBA9V32r6r959Bp3XjkVEXylbItYMqSARaZlY
+  qzKSsIUjh7vDyTNqta0DjSgCk26dhnOwc0hmzhvVZtBwfZritSVhfCLp5uFwqCqY
+  NK3TIZaPCh1S2/ES6wXNvjQ+5EnEEL9j/pSEop9DYEBPaM2WDVR5i0jJTAaRWw==
+  -----END CERTIFICATE-----
+
+date: 2010-12-22 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 0
+        version: 0.5.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: test_declarative
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 4
+        version: 0.0.4
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 8
+        - 0
+        version: 2.8.0
+  type: :development
+  version_requirements: *id003
+description: This backend module for I18n allows you to inflect translations by interpolating patterns.
+email: 
+- pw@gnu.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- Manifest.txt
+- docs/README
+- docs/LGPL-LICENSE
+- docs/LEGAL
+- docs/HISTORY
+- docs/COPYING
+files: 
+- ChangeLog
+- Gemfile
+- LGPL-LICENSE
+- Manifest.txt
+- README.textile
+- Rakefile
+- docs/COPYING
+- docs/HISTORY
+- docs/LEGAL
+- docs/LGPL-LICENSE
+- docs/README
+- docs/rdoc.css
+- lib/i18n-inflector.rb
+- lib/i18n-inflector/inflector.rb
+- lib/i18n-inflector/long_comments.rb
+- lib/i18n-inflector/shortcuts.rb
+- test/all.rb
+- test/backend/inflection_test.rb
+- test/run_all.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: https://rubygems.org/gems/i18n-inflector/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- docs/README
+- --title
+- Simple Inflector for I18n
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: i18n-inflector
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple Inflector backend module for I18n
+test_files: 
+- test/test_helper.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+!]�~��].c������>̅,�0^,@@Ɓ����d��:�Z��B&u���j�%`)2e� l�l���81s�R��**�k<IJ�ܕ����(�cn�
+���4Y>:�`EN�r�He�ѓeY[۟��<��c��?�9: �x���,����1�>���ϙO�ꃥ3�8�o���t��x�$��vS���K���,���A\<��3���h�*nD�ա�>L�