vocab 0.0.2 → 0.0.3

data/spec/data/android/translations/values-es/es-string-file.xml

@@ -4,4 +4,15 @@
   <string name="delete">La funci&oacute;n Child Lock</string>
   <string name="pd_app_name">el Panel para padres bien</string>
   <string name="translator_cruft">Malo</string>
+  <string name="apostrophe">Translator&apos;s evil apostrophe don\'t care</string>
+
+  <plurals name="user_count">
+       <item quantity="one">1 usuario</item>
+       <item quantity="many">%d usuarios</item>
+  </plurals>
+
+  <plurals name="fish_count">
+       <item quantity="one">1 pescado</item>
+       <item quantity="many">%d peces</item>
+  </plurals>
 </resources>

data/spec/data/android/write.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <resources>
+  <string name="apostrophe">Translator\'s evil apostrophe don\'t care</string>
   <string name="app_name">Kid Mode</string>
   <string name="delete">La funci&amp;#xF3;n Child Lock</string>
   <string name="pd_app_name">Parent Dashboard</string>

data/spec/data/android/write_plurals.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<resources>
+  <string name="app_name">Kid Mode</string>
+  <string name="delete">La funci&amp;#xF3;n Child Lock</string>
+  <string name="pd_app_name">Parent Dashboard</string>
+  <plurals name="deer">
+    <item quantity="one">1 deer</item>
+    <item quantity="other">2 deer</item>
+  </plurals>
+  <plurals name="users">
+    <item quantity="one">1 user</item>
+    <item quantity="other">2 users</item>
+  </plurals>
+</resources>

data/spec/data/rails/locales/en.yml

@@ -8,3 +8,7 @@ en:
     first: First menu item
     second: Second menu item
   not_in_es: This key not in spanish
+  users:
+    one: 1 user
+    other: "%{count} users"
+

data/spec/extractor/android_spec.rb

@@ -6,21 +6,22 @@ describe "Vocab::Extractor::Android" do
     @locale = "#{vocab_root}/spec/data/android/locales/values/strings.xml"
   end
 
-  describe 'extract_current' do
+  describe 'current_strings' do
 
     it "extracts hash of current string translations" do
-      actual = Vocab::Extractor::Android.extract_current( @locale )
+      actual = Vocab::Extractor::Android.current_strings( @locale )
       actual.should eql( { "app_name"   =>"Kid Mode",
                            "delete"     =>"Delete",
                            "cancel"     =>"Cancel",
                            "app_current"=>"current",
                            "pd_app_name"=>"Parent Dashboard",
-                           "not_in_es"  =>"This key not in spanish",} )
+                           "not_in_es"  =>"This key not in spanish",
+                           "debug_key"  =>"Should be ignored" } )
     end
 
   end
 
-  describe 'extract_previous' do
+  describe 'previous_strings' do
 
     before( :each ) do
       Dir.chdir( vocab_root )
@@ -32,7 +33,7 @@ describe "Vocab::Extractor::Android" do
     end
 
     it "extracts hash of previous string translations" do
-      actual = Vocab::Extractor::Android.extract_previous( @locale )
+      actual = Vocab::Extractor::Android.previous_strings( @locale )
       actual.should eql( { 'app_name'    => 'Kid Mode',
                            'pd_app_name' => 'Parent Dashboard',
                            'app_current' => 'current' } )
@@ -40,13 +41,46 @@ describe "Vocab::Extractor::Android" do
 
   end
 
+  describe 'current_plurals' do
+
+    it "extracts the plural definitions from the strings file" do
+      expected = { "user_count" => { "one"  => "1 user",
+                                     "many" => "%d users" },
+                   "fish_count" => { "one"  => "1 fish",
+                                     "many" => "%d fish" } }
+      Vocab::Extractor::Android.current_plurals( @locale ).should eql( expected )
+    end
+
+  end
+
+  describe 'previous_plurals' do
+
+    before( :each ) do
+      Dir.chdir( vocab_root )
+    end
+
+    before( :each ) do
+      @sha = '618e87b6a53e8fc216f046e51b1606313052bf75'
+      Vocab.settings.stub!( :last_translation ).and_return( @sha )
+    end
+
+    it "extracts hash of previous string translations" do
+      actual = Vocab::Extractor::Android.previous_plurals( @locale )
+      actual.should eql( { "fish_count" => { "one"  => "1 fishes",
+                                             "many" => "%d fish" } } )
+    end
+
+  end
+
   describe 'write_full' do
 
     it 'writes the full translation to the correct xml file' do
-      hash = { 'foo' => 'bar' }
+      strings = { 'foo' => 'bar' }
+      plurals = { 'users' => { 'one'  => '1 user',
+                               'other' => '2 users' } }
       Vocab::Translator::Android.should_receive( :write ).
-              with( hash, "#{vocab_root}/strings.full.xml" )
-      Vocab::Extractor::Android.write_full( hash )
+              with( strings, plurals, "#{vocab_root}/strings.full.xml" )
+      Vocab::Extractor::Android.write_full( strings, plurals )
     end
 
   end
@@ -54,25 +88,12 @@ describe "Vocab::Extractor::Android" do
   describe 'write_diff' do
 
     it 'writes the diff translation to the correct xml file' do
-      hash = { 'foo' => 'bar' }
+      strings = { 'foo' => 'bar' }
+      plurals = { 'users' => { 'one'  => '1 user',
+                               'other' => '2 users' } }
       Vocab::Translator::Android.should_receive( :write ).
-              with( hash, "#{vocab_root}/strings.diff.xml" )
-      Vocab::Extractor::Android.write_diff( hash )
-    end
-
-  end
-
-  describe 'write' do
-
-    it 'writes the translation to a xml file' do
-      translation = { 'app_name' => 'Kid Mode',
-                      'pd_app_name' => 'Parent Dashboard',
-                      'delete' => "La función Child Lock" }
-      path = "#{vocab_root}/spec/tmp/strings.xml"
-      Vocab::Translator::Android.write( translation, path )
-      should_eql_file( File.open( path ) { |f| f.read },
-                       "spec/data/android/write.xml" )
-      File.delete( path )
+              with( strings, plurals, "#{vocab_root}/strings.diff.xml" )
+      Vocab::Extractor::Android.write_diff( strings, plurals )
     end
 
   end

data/spec/extractor/base_spec.rb

@@ -36,6 +36,20 @@ describe "Vocab::Extractor::Base" do
                        :"en.models.product.id_126.name"=>"This is new"}
     end
 
+    it "finds new plural definitions" do
+      @current = { 'users' => {}, 'fish' => {} }
+      @previous = { 'users' => {} }
+      diff = Vocab::Extractor::Base.diff( @previous, @current )
+      diff.should == { 'fish' => {} }
+    end
+
+    it "finds updated plural definitions" do
+      @current =  { 'users' => { 'one' => '1 user',   'other' => '%d users' }, 'fish' => {} }
+      @previous = { 'users' => { 'one' => '1 person', 'other' => '%d users' }, 'fish' => {} }
+      diff = Vocab::Extractor::Base.diff( @previous, @current )
+      diff.should == { 'users' => { 'one' => '1 user', 'other' => '%d users' } }
+    end
+
   end
 
   describe "extract" do
@@ -49,11 +63,14 @@ describe "Vocab::Extractor::Base" do
     it "extracts the strings that need to be translated into a yml file" do
       current = { 1 => 5, 3 => 4 }
       previous = { 1 => 2 }
-      Vocab::Extractor::Base.should_receive( :extract_current ).and_return( current )
-      Vocab::Extractor::Base.should_receive( :extract_previous ).and_return( previous )
-      Vocab::Extractor::Base.should_receive( :write_diff ).with( { 1 => 5, 3 => 4 }, @diff_path )
-      Vocab::Extractor::Base.should_receive( :write_full ).with( current, @full_path )
+      Vocab::Extractor::Base.should_receive( :current_strings ).and_return( current )
+      Vocab::Extractor::Base.should_receive( :previous_strings ).and_return( previous )
+      Vocab::Extractor::Base.should_receive( :current_plurals ).and_return( {} )
+      Vocab::Extractor::Base.should_receive( :previous_plurals ).and_return( {} )
+      Vocab::Extractor::Base.should_receive( :write_diff ).with( { 1 => 5, 3 => 4 }, {}, @diff_path )
+      Vocab::Extractor::Base.should_receive( :write_full ).with( current, {}, @full_path )
       Vocab::Extractor::Base.should_receive( :mkdir_examples )
+      Vocab::Extractor::Base.should_receive( :update_settings )
       Vocab::Extractor::Base.extract( @diff_path, @full_path )
     end
 
@@ -68,22 +85,22 @@ describe "Vocab::Extractor::Base" do
 
     it "returns the contents of a file from a specific git version" do
       contents = Vocab::Extractor::Base.previous_file( @path, 'a19f7c5c28c1158792a966c0d2153a04490dd35e' )
-      should_eql_file( contents, 'spec/data/android/previous.xml' )
+      contents.should eql_file( 'spec/data/android/previous.xml' )
 
       contents = Vocab::Extractor::Base.previous_file( @path, '0533bcd9a304cd6e74d6a56959dbcabd57b2f1b9' )
-      should_eql_file( contents, 'spec/data/android/current.xml' )
+      contents.should eql_file( 'spec/data/android/current.xml' )
     end
 
     it "returns the correct contents when a full path is specified" do
       contents = Vocab::Extractor::Base.previous_file( "#{vocab_root}/#{@path}", 'a19f7c5c28c1158792a966c0d2153a04490dd35e' )
-      should_eql_file( contents, 'spec/data/android/previous.xml' )
+      contents.should eql_file( 'spec/data/android/previous.xml' )
     end
 
     it "returns the contents of a file when in a subdir of the git directory" do
       Dir.chdir( "spec" )
       @path = "data/android/locales/strings.xml"
       contents = Vocab::Extractor::Base.previous_file( @path, 'a19f7c5c28c1158792a966c0d2153a04490dd35e' )
-      should_eql_file( contents, 'spec/data/android/previous.xml' )
+      contents.should eql_file( 'spec/data/android/previous.xml' )
     end
 
   end

data/spec/extractor/rails_spec.rb

@@ -7,7 +7,7 @@ describe "Vocab::Extractor::Rails" do
     it 'writes the full en translation to a file' do
       translation = { :en => { :full => 'translation' } }
       path = "#{vocab_root}/spec/tmp/en.full.yml"
-      Vocab::Extractor::Rails.write_full( translation, path )
+      Vocab::Extractor::Rails.write_full( translation, {}, path )
       YAML.load_file( path ).should eql( translation )
       File.delete( path )
     end
@@ -27,7 +27,7 @@ describe "Vocab::Extractor::Rails" do
 
   end
 
-  describe "previous" do
+  describe "previous_strings" do
 
     before( :each ) do
       @last_translation = '5ab8cf4d081d7ba1d5f020118dd00c3ea2d0437a'
@@ -37,7 +37,7 @@ describe "Vocab::Extractor::Rails" do
     end
 
     it "creates a hash of the english translation strings from the last translation" do
-      actual = Vocab::Extractor::Rails.extract_previous( @locales_root )
+      actual = Vocab::Extractor::Rails.previous_strings( @locales_root )
       expected = { :"en.models.product.id_36.description" =>"Polarized and lazer resistant",
                    :"en.marketing.banner"                 =>"This product is so good",
                    :"en.models.product.id_36.name"        =>"This nested value has changed",
@@ -54,13 +54,13 @@ describe "Vocab::Extractor::Rails" do
     it 'creates a tmp folder if one does not exist' do
       dir = "#{vocab_root}/tmp/last_translation"
       FileUtils.rm_rf( "#{vocab_root}/tmp/last_translation" )
-      Vocab::Extractor::Rails.extract_previous( @locales_root )
+      Vocab::Extractor::Rails.previous_strings( @locales_root )
       File.exists?( dir ).should be_true
     end
 
   end
 
-  describe "current" do
+  describe "current_strings" do
 
     before( :each ) do
       Dir.chdir( vocab_root )
@@ -68,19 +68,21 @@ describe "Vocab::Extractor::Rails" do
     end
 
     it "creates a hash of the english translation strings currently in the config" do
-      actual = Vocab::Extractor::Rails.extract_current( @locales_root )
-      expected = { :"en.menu.second"                      =>"Second menu item",
-                   :"en.models.product.id_36.description" =>"Polarized and lazer resistant",
-                   :"en.marketing.banner"                 =>"This product is so good",
-                   :"en.models.product.id_36.name"        =>"This nested value has changed",
-                   :"en.menu.first"                       =>"First menu item",
-                   :"en.models.product.id_55.description" =>"A new nested description",
-                   :"en.models.product.id_125.description"=>"Green with megawatts",
-                   :"en.dashboard.chart"                  =>"This value has changed",
-                   :"en.models.product.id_55.name"        =>"a new nested name",
-                   :"en.models.product.id_125.name"       =>"Lazer",
-                   :"en.dashboard.details"                =>"This key/value has been added",
-                   :"en.not_in_es"                        =>"This key not in spanish" }
+      actual = Vocab::Extractor::Rails.current_strings( @locales_root )
+      expected = {:"en.marketing.banner"=>"This product is so good",
+                  :"en.dashboard.chart"=>"This value has changed",
+                  :"en.dashboard.details"=>"This key/value has been added",
+                  :"en.menu.first"=>"First menu item",
+                  :"en.menu.second"=>"Second menu item",
+                  :"en.not_in_es"=>"This key not in spanish",
+                  :"en.users.one"=>"1 user",
+                  :"en.users.other"=>"%{count} users",
+                  :"en.models.product.id_125.description"=>"Green with megawatts",
+                  :"en.models.product.id_125.name"=>"Lazer",
+                  :"en.models.product.id_36.description"=>"Polarized and lazer resistant",
+                  :"en.models.product.id_36.name"=>"This nested value has changed",
+                  :"en.models.product.id_55.description"=>"A new nested description",
+                  :"en.models.product.id_55.name"=>"a new nested name"}
       actual.should eql( expected )
     end
 
@@ -94,8 +96,9 @@ describe "Vocab::Extractor::Rails" do
     end
 
     it "extracts the strings that need to be translated into a yml file" do
-      Vocab::Extractor::Rails.should_receive( :extract_current ).and_return( { :en => { 1 => 5, 3 => 4 } } )
-      Vocab::Extractor::Rails.should_receive( :extract_previous ).and_return( { :en => { 1 => 2 } } )
+      Vocab::Extractor::Rails.should_receive( :current_strings ).and_return( { :en => { 1 => 5, 3 => 4 } } )
+      Vocab::Extractor::Rails.should_receive( :previous_strings ).and_return( { :en => { 1 => 2 } } )
+      Vocab.settings.should_receive( :update_translation )
       Vocab::Extractor::Rails.extract( @diff_path, @full_path )
       YAML.load_file( @diff_path ).should == { :en => { 1 => 5, 3 => 4 } }
 

data/spec/merger/android_spec.rb

@@ -27,7 +27,6 @@ describe "Vocab::Merger::Android" do
   describe "merge" do
 
     before( :each ) do
-      Vocab.settings.should_receive( :update_translation )
       @merger = Vocab::Merger::Android.new( @merge_dir, @update_dir )
       @merger.merge
     end
@@ -47,66 +46,120 @@ describe "Vocab::Merger::Android" do
       @file = "#{@merge_dir}/values-es/strings.xml"
       @merger = Vocab::Merger::Android.new( @merge_dir, @update_dir )
       @merger.merge_file( @file )
-      @merged = Vocab::Translator::Android.hash_from_xml( @file )
     end
 
-    it "merges updated android translations" do
-      @merged['pd_app_name'].should eql( 'el Panel para padres bien' )
-    end
+    context "strings" do
 
-    it "integrates new android translations" do
-      @merged['cancel'].should eql( 'Cancelar' )
-    end
+      before( :each ) do
+        @merged = Vocab::Translator::Android.hash_from_xml( @file )
+      end
 
-    it "properly encodes html entities" do
-      @merged['delete'].should eql( "La función Child Lock" )
-    end
+      it "merges updated android translations" do
+        @merged['pd_app_name'].should eql( 'el Panel para padres bien' )
+      end
 
-    it "ignores key accidentally introduced by the translators into android translations" do
-      @merged['translator_cruft'].should be( nil )
-    end
+      it "integrates new android translations" do
+        @merged['cancel'].should eql( 'Cancelar' )
+      end
+
+      it "properly encodes html entities" do
+        @merged['delete'].should eql( "La función Child Lock" )
+      end
+
+      it "ignores key accidentally introduced by the translators into android translations" do
+        @merged['translator_cruft'].should be( nil )
+      end
+
+      it "retains unchanged android translations" do
+        @merged['app_name'].should eql( 'Modo Niños' )
+      end
+
+      it 'does not include keys where there is no translation' do
+        @merged['not_in_es'].should be( nil )
+      end
 
-    it "retains unchanged android translations" do
-      @merged['app_name'].should eql( 'Modo Niños' )
     end
 
-    it 'does not include keys where there is no translation' do
-      @merged['not_in_es'].should be( nil )
+    context "strings" do
+
+      before( :each ) do
+        @merged = Vocab::Translator::Android.plurals_from_xml( @file )
+      end
+
+      it "includes plurals where an item is updated" do
+        @merged[ 'fish_count' ].should eql( { 'one' => '1 pescado', 'many' => '%d peces' } )
+      end
+
+      it "includes new plural definition" do
+        @merged[ 'user_count' ].should eql( {"one"=>"1 usuario", "many"=>"%d usuarios"} )
+      end
     end
 
   end
 
-  describe 'english_keys' do
+  describe 'string_keys' do
 
     it 'fetches the english keys' do
       merger = Vocab::Merger::Android.new( @merge_dir )
       keys = ["app_name", "delete", "cancel", "app_current", "not_in_es", "pd_app_name"]
-      merger.english_keys.should =~ keys
+      merger.string_keys.should =~ keys
+    end
+
+  end
+
+  describe 'plural_keys' do
+
+    it 'fetches the plural definition keys from the english file' do
+      merger = Vocab::Merger::Android.new( @merge_dir )
+      keys = ["fish_count", "user_count"]
+      merger.plural_keys.should =~ keys
     end
 
   end
 
-  describe 'current_for_locale' do
+  describe 'current_strings_for_locale' do
 
     it 'returns hash of the current translations that match a locale file' do
       merger = Vocab::Merger::Android.new( @merge_dir )
       expected = { "app_name"   =>"Modo Niños",
                    "app_current"=>"actual",
                    "pd_app_name"=>"el Panel para padres"}
-      merger.current_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
+      merger.current_strings_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
     end
 
   end
 
-  describe 'updates' do
+  describe 'update_strings_for_locale' do
 
     it 'returns hash of the updates that match a locale file' do
       merger = Vocab::Merger::Android.new( @merge_dir, @update_dir )
       expected = { 'cancel'           => 'Cancelar',
                    'delete'           => "La función Child Lock",
                    'pd_app_name'      => 'el Panel para padres bien',
-                   'translator_cruft' => 'Malo' }
-      merger.updates_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
+                   'translator_cruft' => 'Malo',
+                   'apostrophe'       => "Translator\\'s evil apostrophe don\\'t care" }
+      merger.update_strings_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
+    end
+
+  end
+
+  describe 'current_plurals_for_locale' do
+
+    it 'returns hash of the current translations that match a locale file' do
+      merger = Vocab::Merger::Android.new( @merge_dir )
+      expected = { "fish_count" => { "one" => "1 pescado", "many" => "%d peces" } }
+      merger.current_plurals_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
+    end
+
+  end
+
+  describe 'update_plurals_for_locale' do
+
+    it 'returns hash of the updates that match a locale file' do
+      merger = Vocab::Merger::Android.new( @merge_dir, @update_dir )
+      expected = { "user_count" => { "one" => "1 usuario", "many" => "%d usuarios" },
+                   "fish_count" => { "one" => "1 pescado", "many" => "%d peces" } }
+      merger.update_plurals_for_locale( "#{@merge_dir}/values-es/strings.xml" ).should == expected
     end
 
   end

data/spec/merger/base_spec.rb

@@ -6,7 +6,6 @@ describe "Vocab::Extractor::Base" do
 
     before( :each ) do
       @merger = Vocab::Merger::Base.new
-      @merger.should_receive( :update_settings )
     end
 
     it 'merges a list of files' do

data/spec/merger/rails_spec.rb

@@ -89,7 +89,6 @@ describe "Vocab::Merger::Rails" do
     before( :each ) do
       init_merge_dir
       @update_dir = "#{vocab_root}/spec/data/rails/translations"
-      Vocab.settings.should_receive( :update_translation )
       @merger = Vocab::Merger::Rails.new( @merge_dir, @update_dir )
       @merger.merge
     end
@@ -116,7 +115,7 @@ describe "Vocab::Merger::Rails" do
     it "returns the keys that should be in a file" do
       path = "#{vocab_root}/spec/data/rails/locales/es.yml"
       actual = Vocab::Merger::Rails.keys_for_file( path )
-      expected = [:"dashboard.details", :"menu.first", :"dashboard.chart", :"menu.second", :"marketing.banner", :"not_in_es"]
+      expected = [:"dashboard.details", :"menu.first", :"dashboard.chart", :"menu.second", :"marketing.banner", :"not_in_es", :"users.one", :"users.other"]
       actual.each { |key| expected.should include( key ) }
       actual.size.should eql( expected.size )
     end

data/spec/spec_helper.rb

@@ -6,6 +6,13 @@ require "vocab"
 require "support/matchers"
 require "support/shared"
 
+require 'simplecov'
+
+SimpleCov.start do
+    coverage_dir 'coverage'
+    add_filter "/spec/"
+  end
+
 Vocab.ui.silent = true
 
 RSpec.configure do |config|
@@ -16,8 +23,4 @@ def vocab_root
   return File.expand_path( '../..', __FILE__ )
 end
 
-def should_eql_file( actual, path )
-  @tmp = File.open( "#{vocab_root}/#{path}.tmp","wb") { |io| io.write actual }
-  @expected = File.open("#{vocab_root}/#{path}","rb") {|io| io.read }
-  actual.chomp.strip.should eql( @expected.chomp.strip )
-end
+

data/spec/support/matchers.rb

@@ -10,4 +10,29 @@ module Vocab
       #end
     end
   end
+end
+
+# Matcher to compare an in-memory string with a ground truth file.
+# Exports the actual value as a .tmp file as a side effect.
+
+RSpec::Matchers.define :eql_file do |expected|
+
+  description do
+    "match the contents of #{expected}"
+  end
+  
+  match do |actual|
+    File.open( "#{vocab_root}/#{expected}.tmp","wb" ) { |io| io.write actual }
+    slurped = File.open( "#{vocab_root}/#{expected}","rb" ) {|io| io.read }
+    actual == slurped
+  end
+
+  failure_message_for_should do |actual|
+    "expected that #{actual} would match the contents of #{expected}"
+  end
+
+  failure_message_for_should_not do |actual|
+    "expected that #{actual} would not match the contents of #{expected}"
+  end
+  
 end

data/spec/translator/android_spec.rb

@@ -2,12 +2,12 @@ require "spec_helper"
 
 describe 'Vocab::Translator::Android' do
 
-  describe 'english_keys' do
+  describe 'string_keys' do
 
     it 'returns the english keys for a locales dir' do
       locales_dir = "#{vocab_root}/spec/data/android/locales"
       expected = ["app_name", "delete", "cancel", "app_current", "not_in_es", "pd_app_name"]
-      Vocab::Translator::Android.english_keys( locales_dir ).should =~ expected
+      Vocab::Translator::Android.string_keys( locales_dir ).should =~ expected
     end
 
   end
@@ -21,4 +21,47 @@ describe 'Vocab::Translator::Android' do
 
   end
 
+  describe 'write' do
+
+    it 'writes the strings to a xml file' do
+      strings = { 'app_name'    => 'Kid Mode',
+                  'pd_app_name' => 'Parent Dashboard',
+                  'delete'      => "La función Child Lock",
+                  'apostrophe'  => "Translator\\'s evil apostrophe don\\'t care"}
+      plurals = {}
+      path = "#{vocab_root}/spec/tmp/strings.xml"
+      Vocab::Translator::Android.write( strings, plurals, path )
+      strings = File.open( path ) { |f| f.read }
+      strings.should eql_file( "spec/data/android/write.xml" )
+      File.delete( path )
+    end
+
+    it 'writes the strings and plurals to a xml file' do
+      strings = { 'app_name' => 'Kid Mode',
+                  'pd_app_name' => 'Parent Dashboard',
+                  'delete' => "La función Child Lock" }
+      plurals = { 'users' => { 'one'  => '1 user',
+                               'other' => '2 users' },
+                  'deer'  => { 'one'  => '1 deer',
+                               'other' => '2 deer' } }
+      path = "#{vocab_root}/spec/tmp/strings.xml"
+      Vocab::Translator::Android.write( strings, plurals, path )
+      strings = File.open( path ) { |f| f.read }
+      strings.should eql_file( "spec/data/android/write_plurals.xml" )
+      File.delete( path )
+    end
+
+  end
+
+  describe 'android resource special cases' do
+
+    it "escapes apostrophes to be compatible with android resources" do
+      hash = Vocab::Translator::Android.hash_from_xml( "#{vocab_root}/spec/data/android/translations/values-es/es-string-file.xml" )
+      hash['apostrophe'].should eql( %q[Translator\'s evil apostrophe don\'t care] )
+
+
+    end
+
+  end
+
 end