combined features and fixes currently in use by numerex for several production apps

.gitignore

@@ -0,0 +1,4 @@
+.idea/
+.bundle/
+log/*.log
+pkg/

.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

.rvmrc

@@ -0,0 +1 @@
+rvm use ruby-1.9.2@i18n --create

Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+gemspec
+
+gem 'rails','3.2.12'

Gemfile.lock

@@ -0,0 +1,113 @@
+PATH
+  remote: .
+  specs:
+    i18n_backend_database (0.1.0)
+      rails (>= 3)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.12)
+      actionpack (= 3.2.12)
+      mail (~> 2.4.4)
+    actionpack (3.2.12)
+      activemodel (= 3.2.12)
+      activesupport (= 3.2.12)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.5)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.12)
+      activesupport (= 3.2.12)
+      builder (~> 3.0.0)
+    activerecord (3.2.12)
+      activemodel (= 3.2.12)
+      activesupport (= 3.2.12)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.12)
+      activemodel (= 3.2.12)
+      activesupport (= 3.2.12)
+    activesupport (3.2.12)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    builder (3.0.4)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    hike (1.2.1)
+    i18n (0.6.1)
+    journey (1.0.4)
+    json (1.7.7)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.21)
+    multi_json (1.6.0)
+    polyglot (0.3.3)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.3)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.12)
+      actionmailer (= 3.2.12)
+      actionpack (= 3.2.12)
+      activerecord (= 3.2.12)
+      activeresource (= 3.2.12)
+      activesupport (= 3.2.12)
+      bundler (~> 1.0)
+      railties (= 3.2.12)
+    railties (3.2.12)
+      actionpack (= 3.2.12)
+      activesupport (= 3.2.12)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.0.3)
+    rdoc (3.12.1)
+      json (~> 1.4)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    rspec-rails (2.12.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.7)
+    thor (0.17.0)
+    tilt (1.3.3)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  i18n_backend_database!
+  rails (= 3.2.12)
+  rspec (>= 2.0.0)
+  rspec-rails (>= 2.0.0)
+  sqlite3 (>= 1.3.4)

README.textile

@@ -1,81 +1,72 @@
-h1. A Database Backend For Rails I18N
+h1. A Database Backend For Rails I18N (Now for rails 3!)
 
-Stores your translations in the database, rather than yaml files.  As you tag items with i18n.t() throughout your code base, all untranslated items are marked and added to the database.  An admin panel is provided so translators can quickly translate untranslated text.  All lookups occur in a cache store of your choice prior to hitting the database.
+Stores your translations in the database, rather than yaml files. As you tag items with t() throughout your code base, all untranslated items are marked and added to the database. An admin panel is provided so translators can quickly translate untranslated text. All lookups occur in a cache store of your choice prior to hitting the database.
 
 h2. DISCLAIMER!
 
-* -In implementing this into another project, I realized that the currency support is currently broken.  It basically boils down to the i18n gem accessing some of the Rails i18n yaml's in a different way than others.  In this case, it's requesting a parent key, and expects a hash to be returned containing the children.  This is not baked in the plugin at the moment, and any contributions toward this would be well received.-  Thank you wlorentson!
-
 * The translations_controller is unprotected, and you'll probably want to add some kind of authorization filter to it to make sure the outside world can't access it.
 
 h2. Installation
 
 <pre>
   <code>
-    script/generate i18n_backend_database       # add migration
-    rake db:migrate                             # migrate
-
-    rake i18n:populate:load_default_locales     # populate default locales
-    rake i18n:populate:from_rails               # populate the locales and translations tables from all Rails Locale YAML files.
-    rake i18n:populate:from_application         # populate the translation tables from translation calls within the application.
-    rake i18n:populate:synchronize_translations # create non-default locale translation records from default locale translations.
-    rake i18n:populate:all                      # run all populate tasks.
-    rake i18n:translate:google                  # translate all untranslated string values using Google Language Translation API.
+  script/generate i18n_backend_database             # add migration
+  rake db:migrate                                   # migrate
+
+  rake i18n:populate:load_default_locales           # populate default locales
+  rake i18n:populate:from_rails                     # populate the locales and translations tables from all Rails Locale YAML files.
+  rake i18n:populate:from_application               # populate the translation tables from translation calls within the application.
+  rake i18n:populate:synchronize_translations       # create non-default locale translation records from default locale translations.
+  rake i18n:populate:all                            # run all populate tasks.
+  rake i18n:translate:google                        # translate all untranslated string values using Google Language Translation API.
+
+  rake i18n:import_translations locale=<locale>     # Import the translations from the translations/<locale>.yml
+  rake i18n:export_translations                     # Exports all the database translations to the translations/ folder
   </code>
 </pre>
 
-
 In config/initialisers/i18n.rb
 
 <pre>
   <code>
-    I18n.backend = I18n::Backend::Database.new # registers the backend
     I18n.backend.cache_store = :memory_store   # optional: specify an alternate cache store
     I18n.backend.localize_text_tag = '##'      # optional: specify an alternate localize text tag, the default is ^^
   </code>
 </pre>
 
-In config/routes.rb to register admin panel routes
-
-<pre>
-  <code>
-    map.from_plugin 'i18n_backend_database'
-  </code>
-</pre>
-
 h2. Use
 
 All non-user generated text provided by the application needs to be wrapped in a call to I18n.t().
 <pre>
   <code>
-    I18n.t("Hello there!")
+    t("Hello there!")
   </code>
 </pre>
 
-Interpolation is handled by passing in key/value pairs as a value to an interpolation tag ( {{ }} ).
+Interpolation is handled by passing in key/value pairs as a value to an interpolation tag ( %{ } ).
 <pre>
   <code>
-    I18n.t("Hello there {{name}}!", :name => "Dylan")
+    t("Hello there %{name}!", :name => "Dylan")
   </code>
 </pre><pre>
   <code>
-    I18n.t("Click {{here}} or {{there}}", :here => "link_to(I18n.t('midnite'), croix_path)", :there => "link_to(I18n.t('staten_island'), wu_path)")
+    t("Click %{here} or %{there}", :here => "link_to(t('midnite'), croix_path)", :there => "link_to(t('staten_island'), wu_path)")
   </code>
 </pre>
 
 Pluralization is handled by passing in a "count" key value pair, which is a unique interpolation value.
 <pre>
   <code>
-    I18n.t("You are {{count}} years old", :count => 100)
+    I18n.t("You are %{count} years old", :count => 100)
   </code>
 </pre>
 
 Links to external documents that need to be translated should be tagged as well.
 <pre>
   <code>
-    I18n.t('http://www.elctech.com/core')
-    </code>
-  </pre>
+    t('http://www.elctech.com/core')
+  </code>
+</pre>
 
 All fragment cache view blocks need to have their keys prepended with the current locale.
 <pre>
@@ -84,42 +75,41 @@ All fragment cache view blocks need to have their keys prepended with the curren
   </code>
 </pre>
 
-Date/Time localization is handled by using the I18n.l method.  The format used will be :default (see next item for explanation).
+Date/Time localization is handled by using the localize (l) method.  The format used will be :default (see next item for explanation).
 <pre>
   <code>
-    I18n.l(@user.joined_at)
+    l(@user.joined_at)
   </code>
 </pre>
 
 Date/Time localization can take a format parameter that corresponds to a key in the translations table (the Rails defaults :default, :short, and :long are available).  We could in theory create our own like en.date.formats.espn_default.
 <pre>
   <code>
-    I18n.l(@user.joined_at, :format => :default)
-    I18n.l(@user.joined_at, :format => :short)
-    I18n.l(@user.joined_at, :format => :espn_default)
+    l(@user.joined_at, :format => :default)
+    l(@user.joined_at, :format => :short)
+    l(@user.joined_at, :format => :espn_default)
   </code>
 </pre>
 
 Date/Time localization can take a custom format string as well.
 <pre>
   <code>
-    I18n.l(@user.joined_at, :format => "%B %e, %Y")
+    l(@user.joined_at, :format => "%B %e, %Y")
   </code>
 </pre>
 
 Text stored in a database can be localized by tagging the text being stored and then localizing in the view etc.
 <pre>
   <code>
-    I18n.tlt("is now friends with") => "^^is now friends with^^"
-    I18n.lt("shane ^^is now friends with^^ dylan") => "shane ahora es con amigos dylan"
+    tlt("is now friends with") => "^^is now friends with^^"
+    lt("shane ^^is now friends with^^ dylan") => "shane ahora es con amigos dylan"
   </code>
 </pre>
 
 Images can be translated with the I18n.ta tag
 <pre>
   <code>
-    <%= image_tag(I18n.ta("logos/elc.gif"), :size => "134x75") %>
+    <%= image_tag(ta("logos/elc.gif"), :size => "134x75") %>
     </code>
   </pre>
 In this example, for a locale es, there should be an image: public/es/images/logos/elc.gif
-

Rakefile

@@ -0,0 +1,31 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'I18nBackendDatabase'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+task :default => :spec