Adding fast_gettext source in vendor/

(ActionItem1315)

Adding fast_gettext source in vendor/
(ActionItem1315)
Antonio Terceiro
1 parent b04427d2
Showing 57 changed files with 3374 additions and 0 deletions Show diff stats
lib/fast_gettext
lib/fast_gettext.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/CHANGELOG
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/README.markdown
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/Rakefile
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/VERSION
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/base.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/baseline.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/fast_gettext.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/i18n_simple.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/ideal.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/misc/threadsave.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/namespace/fast_gettext.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/namespace/original.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/benchmark/original.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/examples/db/migration.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/examples/missing_translation_logger.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/fast_gettext.gemspec
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/lib/fast_gettext.rb
vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/lib/fast_gettext/VERSION
@@ -0,0 +1 @@
+../vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/lib/fast_gettext
 \ No newline at end of file
@@ -0,0 +1 @@
+../vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/lib/fast_gettext.rb
 \ No newline at end of file
@@ -0,0 +1,6 @@
+0.4.14 -- "" is translated as "", not as gettext meta information
+0.4.0 -- pluralisation_rules is no longer stored in each repository, only retrived. Added Chain and Logger repository.
+0.3.6 -- FastGettext.default_locale=
+0.3.5 -- FastGettext.default_text_domain=
+0.3.4 -- Exceptions are thrown, not returned when translating without text domain
+0.3 -- pluralisation methods accept/return n plural forms, contrary to singular/plural before
 \ No newline at end of file
@@ -0,0 +1,196 @@
+FastGettext
+===========
+GetText but 3.5 x faster, 560 x less memory, simple, clean namespace (7 vs 34) and threadsave!  
+
+It supports multiple backends (.mo, .po, .yml files, Database(ActiveRecor + any other), Chain, Loggers) and can easily be extended.
+
+[Example Rails application](https://github.com/grosser/gettext_i18n_rails_example)
+
+Comparison
+==========
+<table>
+  <tr>
+    <td></td>
+    <td width="100">Hash</td>
+    <td width="150">FastGettext</td>
+    <td width="100">GetText</td>
+    <td width="100">ActiveSupport I18n::Simple</td>
+  </tr>
+  <tr>
+    <td>Speed*</td>
+    <td>0.82s</td>
+    <td>1.36s</td>
+    <td>4.88s</td>
+    <td>21.77s</td>
+  </tr>
+  <tr>
+    <td>RAM*</td>
+    <td>4K</td>
+    <td>8K</td>
+    <td>4480K</td>
+    <td>10100K</td>
+  </tr>
+  <tr>
+    <td>Included backends</td>
+    <td></td>
+    <td>db, yml, mo, po, logger, chain</td>
+    <td>mo</td>
+    <td>yml</td>
+  </tr>
+</table>
+<small>*50.000 translations with ruby enterprise 1.8.6 through `rake benchmark`</small>
+
+Setup
+=====
+### 1. Install
+    sudo gem install fast_gettext
+
+### 2. Add a translation repository
+
+From mo files (traditional/default)
+    FastGettext.add_text_domain('my_app',:path=>'locale')
+
+Or po files (less maintenance than mo)
+    FastGettext.add_text_domain('my_app',:path=>'locale', :type=>:po)
+
+Or yaml files (use I18n syntax/indentation)
+    FastGettext.add_text_domain('my_app',:path=>'config/locales', :type=>:yaml)
+
+Or database (scaleable, good for many locales/translators)
+    # db access is cached <-> only first lookup hits the db 
+    require "fast_gettext/translation_repository/db"
+    include FastGettext::TranslationRepository::Db.require_models #load and include default models
+    FastGettext.add_text_domain('my_app', :type=>:db, :model=>TranslationKey)
+
+### 3. Choose text domain and locale for translation
+Do this once in every Thread. (e.g. Rails -> ApplicationController)
+    FastGettext.text_domain = 'my_app'
+    FastGettext.available_locales = ['de','en','fr','en_US','en_UK'] # only allow these locales to be set (optional)
+    FastGettext.locale = 'de'
+
+### 4. Start translating
+    include FastGettext::Translation
+    _('Car') == 'Auto'
+    _('not-found') == 'not-found'
+    s_('Namespace|no-found') == 'not-found'
+    n_('Axis','Axis',3) == 'Achsen' #German plural of Axis
+
+
+Managing translations
+============
+### mo/po-files
+Generate .po or .mo files using GetText parser (example tasks at [gettext_i18n_rails](http://github.com/grosser/gettext_i18n_rails))
+
+Tell Gettext where your .mo or .po files lie, e.g. for locale/de/my_app.po and locale/de/LC_MESSAGES/my_app.mo
+    FastGettext.add_text_domain('my_app',:path=>'locale')
+
+Use the [original GetText](http://github.com/mutoh/gettext) to create and manage po/mo-files.
+(Work on a po/mo parser & reader that is easier to use has started, contributions welcome @ [pomo](http://github.com/grosser/pomo) )
+
+###Database
+[Example migration for ActiveRecord](http://github.com/grosser/fast_gettext/blob/master/examples/db/migration.rb)  
+The default plural seperator is `||||` but you may overwrite it (or suggest a better one..).
+
+This is usable with any model DataMapper/Sequel or any other(non-database) backend, the only thing you need to do is respond to the self.translation(key, locale) call.
+If you want to use your own models, have a look at the [default models](http://github.com/grosser/fast_gettext/tree/master/lib/fast_gettext/translation_repository/db_models) to see what you want/need to implement.
+
+To manage translations via a Web GUI, use a [Rails application and the translation_db_engine](http://github.com/grosser/translation_db_engine)
+
+Rails
+=======================
+Try the [gettext_i18n_rails plugin](http://github.com/grosser/gettext_i18n_rails), it simplifies the setup.  
+Try the [translation_db_engine](http://github.com/grosser/translation_db_engine), to manage your translations in a db.
+
+Setting `available_locales`,`text_domain` or `locale` will not work inside the `evironment.rb`,
+since it runs in a different thread then e.g. controllers, so set them inside your application_controller.
+
+    #environment.rb after initializers
+    Object.send(:include,FastGettext::Translation)
+    FastGettext.add_text_domain('accounting',:path=>'locale')
+    FastGettext.add_text_domain('frontend',:path=>'locale')
+    ...
+
+    #application_controller.rb
+    class ApplicationController ...
+      include FastGettext::Translation
+      before_filter :set_locale
+      def set_locale
+        FastGettext.available_locales = ['de','en',...]
+        FastGettext.text_domain = 'frontend'
+        session[:locale] = I18n.locale = FastGettext.set_locale(params[:locale] || session[:locale] || request.env['HTTP_ACCEPT_LANGUAGE'] || 'en')
+      end
+
+
+Advanced features
+=================
+###Abnormal pluralisation
+Pluralisation rules can be set directly via a lambda (see specs/), or by using the Gettext
+plural definition (see spec/locale/en/test_plural.po or [Plural expressions for all languages](http://translate.sourceforge.net/wiki/l10n/pluralforms).
+
+
+###default_text_domain
+If you only use one text domain, setting `FastGettext.default_text_domain = 'app'`
+is sufficient and no more `text_domain=` is needed
+
+###default_locale
+If the simple rule of "first `availble_locale` or 'en'" is not suficcient for you, set `FastGettext.default_locale = 'de'`.
+
+###default_available_locales
+Fallback when no available_locales are set
+
+###Chains
+You can use any number of repositories to find a translation. Simply add them to a chain and when
+the first cannot translate a given key, the next is asked and so forth.
+    repos = [
+      FastGettext::TranslationRepository.build('new', :path=>'....'),
+      FastGettext::TranslationRepository.build('old', :path=>'....')
+    ]
+    FastGettext.add_text_domain 'combined', :type=>:chain, :chain=>repos
+
+###Logger
+When you want to know which keys could not be translated or were used, add a Logger to a Chain:
+    repos = [
+      FastGettext::TranslationRepository.build('app', :path=>'....')
+      FastGettext::TranslationRepository.build('logger', :type=>:logger, :callback=>lamda{|key_or_array_of_ids| ... }),
+    }
+    FastGettext.add_text_domain 'combined', :type=>:chain, :chain=>repos
+If the Logger is in position #1 it will see all translations, if it is in position #2 it will only see the unfound.
+Unfound may not always mean missing, if you chose not to translate a word because the key is a good translation, it will appear nevertheless.
+A lambda or anything that responds to `call` will do as callback. A good starting point may be `examples/missing_translations_logger.rb`.
+
+###Plugins
+Want a xml version ?
+Write your own TranslationRepository!
+    #fast_gettext/translation_repository/xxx.rb
+    module FastGettext
+      module TranslationRepository
+        class Wtf
+          define initialize(name,options), [key], plural(*keys) and
+          either inherit from TranslationRepository::Base or define available_locales and pluralisation_rule
+        end
+      end
+    end
+
+
+FAQ
+===
+ - [Problems with ActiveRecord messages?](http://wiki.github.com/grosser/fast_gettext/activerecord)
+
+
+TODO
+====
+ - YML backend that reads ActiveSupport::I18n files
+ - any ideas ? :D
+
+Author
+======
+Mo/Po-file parsing from Masao Mutoh, see vendor/README
+
+###Contributors
+ - [geekq](http://www.innoq.com/blog/vd)
+ - [Matt Sanford](http://blog.mzsanford.com)
+ - Rudolf Gavlas
+
+[Michael Grosser](http://pragmatig.wordpress.com)  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...  
@@ -0,0 +1,32 @@
+task :default => :spec
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+task :benchmark do
+  puts "Running on #{RUBY}"
+  %w[baseline ideal fast_gettext original i18n_simple].each do |bench|
+    puts `ruby benchmark/#{bench}.rb`
+    puts ""
+  end
+end
+
+task :namespaces do
+  puts `ruby benchmark/namespace/original.rb`
+  puts `ruby benchmark/namespace/fast_gettext.rb`
+end
+
+begin
+  require 'jeweler'
+  project_name = 'fast_gettext'
+  Jeweler::Tasks.new do |gem|
+    gem.name = project_name
+    gem.summary = "A simple, fast and threadsafe implementation of GetText"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install jeweler"
+end
 \ No newline at end of file
@@ -0,0 +1 @@
+lib/fast_gettext/VERSION
 \ No newline at end of file
@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'benchmark'
+
+RUNS = 50_0000
+DEFAULTS = {:memory=>0}
+
+def locale_folder(domain)
+  path = case domain
+  when 'test' then File.join(File.expand_path(File.dirname(__FILE__)),'..','spec','locale')
+  when 'large' then File.join(File.expand_path(File.dirname(__FILE__)),'locale')
+  end
+
+  mo = File.join(path,'de','LC_MESSAGES',"#{domain}.mo")
+  raise unless File.exist?(mo)
+  path
+end
+
+def results_test(&block)
+  print "#{(result(&block)).to_s.strip.split(' ').first}s / #{memory}K <-> "
+end
+
+def results_large
+  print "#{(result {_('login') == 'anmelden'}).to_s.strip.split(' ').first}s / #{memory}K"
+  puts ""
+end
+
+def result
+  result =Benchmark.measure do
+    RUNS.times do
+      raise "not translated" unless yield
+    end
+  end
+  result
+end
+
+def memory
+  pid = Process.pid
+  map = `pmap -d #{pid}`
+  map.split("\n").last.strip.squeeze(' ').split(' ')[3].to_i - DEFAULTS[:memory]
+end
+
+DEFAULTS[:memory] = memory + 4 #4 => 0 for base calls
 \ No newline at end of file
@@ -0,0 +1,5 @@
+require 'benchmark/base'
+
+puts "Baseline: (doing nothing in a loop)"
+results_test{true}
+puts ""
 \ No newline at end of file
@@ -0,0 +1,18 @@
+require 'benchmark/base'
+
+$LOAD_PATH.unshift 'lib'
+require 'fast_gettext'
+include FastGettext::Translation
+
+FastGettext.available_locales  = ['de','en']
+FastGettext.locale = 'de'
+
+puts "FastGettext:"
+FastGettext.add_text_domain('test',:path=>locale_folder('test'))
+FastGettext.text_domain = 'test'
+results_test{_('car') == 'Auto'}
+
+#i cannot add the large file, since its an internal applications mo file
+FastGettext.add_text_domain('large',:path=>locale_folder('large'))
+FastGettext.text_domain = 'large'
+results_large
 \ No newline at end of file
@@ -0,0 +1,7 @@
+require 'benchmark/base'
+require 'activesupport'
+I18n.backend = I18n::Backend::Simple.new
+I18n.load_path = ['benchmark/locale/de.yml']
+I18n.locale = :de
+puts "ActiveSupport I18n::Backend::Simple :"
+results_test{I18n.translate('activerecord.models.car')=='Auto'}
 \ No newline at end of file
@@ -0,0 +1,24 @@
+require 'benchmark/base'
+
+$LOAD_PATH.unshift 'lib'
+
+module FastestGettext
+  def set_domain(folder,domain,locale)
+    @data = {}
+    require 'fast_gettext/vendor/mofile'
+    FastGettext::GetText::MOFile.open(File.join(folder,locale,'LC_MESSAGES',"#{domain}.mo"), "UTF-8").each{|k,v|@data[k]=v}
+  end
+  def _(word)
+    @data[word]
+  end
+end
+
+
+include FastestGettext
+set_domain(locale_folder('test'),'test','de')
+puts "Ideal: (primitive Hash lookup)"
+results_test{_('car') == 'Auto'}
+
+#i cannot add the large file, since its an internal applications mo file
+set_domain(locale_folder('large'),'large','de')
+results_large
@@ -0,0 +1,21 @@
+require 'benchmark'
+BASELINE = 0
+def test
+  result = Benchmark.measure {1_000_000.times{ yield }}
+  result.to_s.strip.split(' ').first.to_f - BASELINE
+end
+
+BASELINE = (test{})
+Thread.current[:library_name]={}
+other = "x"
+puts "Ruby #{VERSION}"
+
+puts "generic:"
+puts "  Symbol: #{test{Thread.current[:library_name][:just_a_symbol]}}s"
+puts "  String concat: #{test{Thread.current["xxxxxx"<<other.to_s]}}s"
+puts "  String add: #{test{Thread.current["xxxxxx"+other.to_s]}}s"
+puts "  String insert: #{test{Thread.current["xxxxxx#{other}"]}}s"
+
+puts "single:"
+puts "  Symbol: #{test{Thread.current[:long_unique_symbol]}}s"
+puts "  String: #{test{Thread.current["xxxxxx"]}}s"
 \ No newline at end of file
@@ -0,0 +1,15 @@
+#Iconv will not be defined, unless it is found -> normalize test results for users that have Iconv/those who do not have it
+begin;require 'iconv';rescue;LoadError;end
+initial = methods.count + Module.constants.count
+
+#FastGettext
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__),'..','..','lib')
+require 'fast_gettext'
+FastGettext.locale = 'de'
+FastGettext.add_text_domain 'test', :path=>'spec/locale'
+FastGettext.text_domain = 'test'
+include FastGettext::Translation
+raise unless _('car')=='Auto'
+
+puts "FastGettext"
+puts methods.count + Module.constants.count - initial
 \ No newline at end of file
@@ -0,0 +1,14 @@
+require 'rubygems'
+initial = methods.count + Module.constants.count
+
+#GetText
+gem 'gettext', '>=2.0.0'
+require 'gettext'
+GetText.locale = 'de'
+GetText.bindtextdomain('test',:path=>'spec/locale')
+include GetText
+raise unless _('car') == 'Auto'
+
+
+puts "GetText"
+puts methods.count + Module.constants.count - initial
 \ No newline at end of file
@@ -0,0 +1,19 @@
+require 'benchmark/base'
+
+begin
+gem 'gettext', '>=2.0.0'
+rescue LoadError
+  $LOAD_PATH.unshift 'lib'
+end
+require 'gettext'
+include GetText
+
+self.locale = 'de'
+
+puts "GetText #{GetText::VERSION}:"
+bindtextdomain('test',:path=>locale_folder('test'))
+results_test{_('car') == 'Auto'}
+
+#i cannot add the large file, since its an internal applications mo file
+bindtextdomain('large',:path=>locale_folder('large'))
+results_large
@@ -0,0 +1,22 @@
+class CreateTranslationTables < ActiveRecord::Migration
+  def self.up
+    create_table :translation_keys do |t|
+      t.string :key, :unique=>true, :null=>false
+      t.timestamps
+    end
+    add_index :translation_keys, :key #I am not sure if this helps....
+
+    create_table :translation_texts do |t|
+      t.text :text
+      t.string :locale
+      t.integer :translation_key_id, :null=>false
+      t.timestamps
+    end
+    add_index :translation_texts, :translation_key_id
+  end
+
+  def self.down
+    drop_table :translation_keys
+    drop_table :translation_texts
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,13 @@
+class MissingTranslationLogger
+  def call(unfound)
+    logger.warn "#{FastGettext.locale}: #{unfound}" unless FastGettext.locale == 'en'
+  end
+
+  private
+
+  def logger
+    return @logger if @logger
+    require 'logger'
+    @logger = Logger.new("log/unfound_translations", 2, 5*(1024**2))#max 2x 5mb logfile
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,122 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{fast_gettext}
+  s.version = "0.5.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2010-01-30}
+  s.email = %q{grosser.michael@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "benchmark/base.rb",
+     "benchmark/baseline.rb",
+     "benchmark/fast_gettext.rb",
+     "benchmark/i18n_simple.rb",
+     "benchmark/ideal.rb",
+     "benchmark/locale/de.yml",
+     "benchmark/locale/de/LC_MESSAGES/large.mo",
+     "benchmark/misc/threadsave.rb",
+     "benchmark/namespace/fast_gettext.rb",
+     "benchmark/namespace/original.rb",
+     "benchmark/original.rb",
+     "examples/db/migration.rb",
+     "examples/missing_translation_logger.rb",
+     "fast_gettext.gemspec",
+     "lib/fast_gettext.rb",
+     "lib/fast_gettext/mo_file.rb",
+     "lib/fast_gettext/po_file.rb",
+     "lib/fast_gettext/storage.rb",
+     "lib/fast_gettext/translation.rb",
+     "lib/fast_gettext/translation_repository.rb",
+     "lib/fast_gettext/translation_repository/base.rb",
+     "lib/fast_gettext/translation_repository/chain.rb",
+     "lib/fast_gettext/translation_repository/db.rb",
+     "lib/fast_gettext/translation_repository/db_models/translation_key.rb",
+     "lib/fast_gettext/translation_repository/db_models/translation_text.rb",
+     "lib/fast_gettext/translation_repository/logger.rb",
+     "lib/fast_gettext/translation_repository/mo.rb",
+     "lib/fast_gettext/translation_repository/po.rb",
+     "lib/fast_gettext/translation_repository/yaml.rb",
+     "spec/aa_unconfigued_spec.rb",
+     "spec/fast_gettext/mo_file_spec.rb",
+     "spec/fast_gettext/storage_spec.rb",
+     "spec/fast_gettext/translation_repository/base_spec.rb",
+     "spec/fast_gettext/translation_repository/chain_spec.rb",
+     "spec/fast_gettext/translation_repository/db_spec.rb",
+     "spec/fast_gettext/translation_repository/logger_spec.rb",
+     "spec/fast_gettext/translation_repository/mo_spec.rb",
+     "spec/fast_gettext/translation_repository/po_spec.rb",
+     "spec/fast_gettext/translation_repository/yaml_spec.rb",
+     "spec/fast_gettext/translation_repository_spec.rb",
+     "spec/fast_gettext/translation_spec.rb",
+     "spec/fast_gettext_spec.rb",
+     "spec/locale/de/LC_MESSAGES/test.mo",
+     "spec/locale/de/test.po",
+     "spec/locale/en/LC_MESSAGES/plural_test.mo",
+     "spec/locale/en/LC_MESSAGES/test.mo",
+     "spec/locale/en/plural_test.po",
+     "spec/locale/en/test.po",
+     "spec/locale/yaml/de.yml",
+     "spec/locale/yaml/en.yml",
+     "spec/locale/yaml/notfound.yml",
+     "spec/spec_helper.rb",
+     "spec/vendor/fake_load_path/iconv.rb",
+     "spec/vendor/iconv_spec.rb",
+     "spec/vendor/string_spec.rb",
+     "vendor/README.rdoc",
+     "vendor/empty.mo",
+     "vendor/iconv.rb",
+     "vendor/mofile.rb",
+     "vendor/poparser.rb",
+     "vendor/string.rb"
+  ]
+  s.homepage = %q{http://github.com/grosser/fast_gettext}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A simple, fast and threadsafe implementation of GetText}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/aa_unconfigued_spec.rb",
+     "spec/vendor/fake_load_path/iconv.rb",
+     "spec/vendor/iconv_spec.rb",
+     "spec/vendor/string_spec.rb",
+     "spec/fast_gettext_spec.rb",
+     "spec/fast_gettext/translation_repository_spec.rb",
+     "spec/fast_gettext/translation_repository/mo_spec.rb",
+     "spec/fast_gettext/translation_repository/db_spec.rb",
+     "spec/fast_gettext/translation_repository/yaml_spec.rb",
+     "spec/fast_gettext/translation_repository/logger_spec.rb",
+     "spec/fast_gettext/translation_repository/base_spec.rb",
+     "spec/fast_gettext/translation_repository/po_spec.rb",
+     "spec/fast_gettext/translation_repository/chain_spec.rb",
+     "spec/fast_gettext/translation_spec.rb",
+     "spec/fast_gettext/mo_file_spec.rb",
+     "spec/fast_gettext/storage_spec.rb",
+     "examples/missing_translation_logger.rb",
+     "examples/db/migration.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+
@@ -0,0 +1,30 @@
+require 'fast_gettext/mo_file'
+require 'fast_gettext/storage'
+require 'fast_gettext/translation'
+require 'fast_gettext/translation_repository'
+require 'fast_gettext/vendor/string'
+
+module FastGettext
+  include FastGettext::Storage
+  extend self
+
+  VERSION = File.read( File.join(File.dirname(__FILE__), 'fast_gettext', 'VERSION') ).strip
+  LOCALE_REX =  /^[a-z]{2}$|^[a-z]{2}_[A-Z]{2}$/
+  NAMESPACE_SEPERATOR = '|'
+
+  # users should not include FastGettext, since this would conterminate their namespace
+  # rather use
+  # FastGettext.locale = ..
+  # FastGettext.text_domain = ..
+  # and
+  # include FastGettext::Translation
+  FastGettext::Translation.public_instance_methods.each do |method|
+    define_method method do |*args|
+      Translation.send(method,*args)
+    end
+  end
+
+  def add_text_domain(name,options)
+    translation_repositories[name] = TranslationRepository.build(name,options)
+  end
+end
@@ -0,0 +1 @@
+0.5.1
@@ -0,0 +1,67 @@
+require 'fast_gettext/vendor/mofile'
+module FastGettext
+  # Responsibility:
+  #  - abstract mo files for Mo Repository
+  class MoFile
+    PLURAL_SEPERATOR = "\000"
+
+    # file => path or FastGettext::GetText::MOFile
+    def initialize(file)
+      if file.is_a? FastGettext::GetText::MOFile
+        @data = file
+      else
+        @data = FastGettext::GetText::MOFile.open(file, "UTF-8")
+      end
+      make_singular_and_plural_available
+    end
+
+    def [](key)
+      @data[key]
+    end
+
+    #returns the plural forms or all singular translations that where found
+    def plural(*msgids)
+      translations = plural_translations(msgids)
+      return translations unless translations.empty?
+      msgids.map{|msgid| self[msgid] || msgid} #try to translate each id
+    end
+
+    def pluralisation_rule
+      #gettext uses 0 as default rule, which would turn off all pluralisation, very clever...
+      #additionally parsing fails when directly accessing po files, so this line was taken from gettext/mofile
+      (@data['']||'').split("\n").each do |line|
+        return lambda{|n|eval($2)} if /^Plural-Forms:\s*nplurals\s*\=\s*(\d*);\s*plural\s*\=\s*([^;]*)\n?/ =~ line
+      end
+      nil
+    end
+
+    def self.empty
+      MoFile.new(File.join(File.dirname(__FILE__),'vendor','empty.mo'))
+    end
+
+    private
+
+    #(if plural==singular, prefer singular)
+    def make_singular_and_plural_available
+      data = {}
+      @data.each do |key,translation|
+        next unless key.include? PLURAL_SEPERATOR
+        singular, plural = split_plurals(key)
+        translation = split_plurals(translation)
+        data[singular] ||= translation[0]
+        data[plural] ||= translation[1]
+      end
+      @data.merge!(data){|key,old,new| old}
+    end
+
+    def split_plurals(singular_plural)
+      singular_plural.split(PLURAL_SEPERATOR)
+    end
+
+    # Car, Cars => [Auto,Autos] or []
+    def plural_translations(msgids)
+      plurals = self[msgids*PLURAL_SEPERATOR]
+      if plurals then split_plurals(plurals) else [] end
+    end
+  end
+end
@@ -0,0 +1,14 @@
+require 'fast_gettext/mo_file'
+module FastGettext
+  # Responsibility:
+  #  - abstract po files for Po Repository
+  # TODO refactor...
+  class PoFile
+    def self.to_mo_file(file)
+      require 'fast_gettext/vendor/poparser'
+      mo_file = FastGettext::GetText::MOFile.new
+      FastGettext::GetText::PoParser.new.parse(File.read(file),mo_file)
+      MoFile.new(mo_file)
+    end
+  end
+end
@@ -0,0 +1,188 @@
+module FastGettext
+  # Responsibility:
+  #  - store data threadsave
+  #  - provide error messages when repositories are unconfigured
+  #  - accept/reject locales that are set by the user
+  module Storage
+    class NoTextDomainConfigured < RuntimeError
+      def to_s
+        "Current textdomain (#{FastGettext.text_domain.inspect}) was not added, use FastGettext.add_text_domain !"
+      end
+    end
+
+    [:available_locales, :_locale, :text_domain, :pluralisation_rule].each do |method_name|
+      key = "fast_gettext_#{method_name}".to_sym
+      define_method method_name do
+        Thread.current[key]
+      end
+
+      define_method "#{method_name}=" do |value|
+        Thread.current[key]=value
+        update_current_cache
+      end
+    end
+    private :_locale, :_locale=
+
+
+    def available_locales
+      Thread.current[:fast_gettext_available_locales] || default_available_locales
+    end
+
+    # == cattr_accessor :default_available_locales
+    @@default_available_locales = nil
+    def default_available_locales=(avail_locales)
+      @@default_available_locales = avail_locales
+      update_current_cache
+    end
+
+    def default_available_locales
+      @@default_available_locales
+    end
+
+
+    def text_domain
+      Thread.current[:fast_gettext_text_domain] || default_text_domain
+    end
+
+    # == cattr_accessor :default_text_domain
+    @@default_text_domain = nil
+    def default_text_domain=(domain)
+      @@default_text_domain = domain
+      update_current_cache
+    end
+
+    def default_text_domain
+      @@default_text_domain
+    end
+
+
+    def pluralisation_rule
+      Thread.current[:fast_gettext_pluralisation_rule] ||  current_repository.pluralisation_rule || lambda{|i| i!=1}
+    end
+
+    def current_cache
+      Thread.current[:fast_gettext_current_cache] || {}
+    end
+
+    def current_cache=(cache)
+      Thread.current[:fast_gettext_current_cache] = cache
+    end
+
+    #global, since re-parsing whole folders takes too much time...
+    @@translation_repositories={}
+    def translation_repositories
+      @@translation_repositories
+    end
+
+    # used to speedup simple translations, does not work for pluralisation
+    # caches[text_domain][locale][key]=translation
+    @@caches={}
+    def caches
+      @@caches
+    end
+
+    def current_repository
+      translation_repositories[text_domain] || raise(NoTextDomainConfigured)
+    end
+
+    def key_exist?(key)
+      !!(cached_find key)
+    end
+
+    def cached_find(key)
+      translation = current_cache[key]
+      return translation if translation or translation == false #found or was not found before
+      current_cache[key] = current_repository[key] || false
+    end
+
+    def cached_plural_find(*keys)
+      key = '||||' + keys * '||||'
+      translation = current_cache[key]
+      return translation if translation or translation == false #found or was not found before
+      current_cache[key] = current_repository.plural(*keys) || false
+    end
+
+    def locale
+      _locale || ( default_locale || (available_locales||[]).first || 'en' )
+    end
+
+    def locale=(new_locale)
+      new_locale = best_locale_in(new_locale)
+      self._locale = new_locale if new_locale
+    end
+
+    # for chaining: puts set_locale('xx') == 'xx' ? 'applied' : 'rejected'
+    # returns the current locale, not the one that was supplied
+    # like locale=(), whoes behavior cannot be changed
+    def set_locale(new_locale)
+      self.locale = new_locale
+      locale
+    end
+    
+    @@default_locale = nil
+    def default_locale=(new_locale)
+      @@default_locale = best_locale_in(new_locale)
+      update_current_cache
+    end
+
+    def default_locale
+      @@default_locale
+    end
+
+    #Opera: de-DE,de;q=0.9,en;q=0.8
+    #Firefox de-de,de;q=0.8,en-us;q=0.5,en;q=0.3
+    #IE6/7 de
+    #nil if nothing matches
+    def best_locale_in(locales)
+      formatted_sorted_locales(locales).each do |candidate|
+        return candidate if not available_locales
+        return candidate if available_locales.include?(candidate)
+        return candidate[0..1] if available_locales.include?(candidate[0..1])#available locales include a langauge
+      end
+      return nil#nothing found im sorry :P
+    end
+
+    #turn off translation if none was defined to disable all resulting errors
+    def silence_errors
+      require 'fast_gettext/translation_repository/base'
+      translation_repositories[text_domain] = TranslationRepository::Base.new('x')
+    end
+
+    private
+
+    # de-de,DE-CH;q=0.9 -> ['de_DE','de_CH']
+    def formatted_sorted_locales(locales)
+      found = weighted_locales(locales).reject{|x|x.empty?}.sort_by{|l|l.last}.reverse #sort them by weight which is the last entry
+      found.flatten.map{|l| format_locale(l)}
+    end
+
+    #split the locale and seperate it into different languages
+    #de-de,de;q=0.9,en;q=0.8 => [['de-de','de','0.5'], ['en','0.8']]
+    def weighted_locales(locales)
+      locales = locales.to_s.gsub(/\s/,'')
+      found = [[]]
+      locales.split(',').each do |part|
+        if part =~ /;q=/ #contains language and weight ?
+          found.last << part.split(/;q=/)
+          found.last.flatten!
+          found << []
+        else
+          found.last << part
+        end
+      end
+      found
+    end
+
+    #de-de -> de_DE
+    def format_locale(locale)
+      locale.sub(/^([a-zA-Z]{2})[-_]([a-zA-Z]{2})$/){$1.downcase+'_'+$2.upcase}
+    end
+
+    def update_current_cache
+      caches[text_domain] ||= {}
+      caches[text_domain][locale] ||= {}
+      caches[text_domain][locale][""] = false #ignore gettext meta key when translating
+      self.current_cache = caches[text_domain][locale]
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,53 @@
+module FastGettext
+  # this module should be included
+  # Responsibility:
+  #  - direct translation queries to the current repository
+  #  - handle untranslated values
+  #  - understand / enforce namespaces
+  #  - decide which plural form is used
+  module Translation
+    extend self
+
+    #make it usable in class definition, e.g.
+    # class Y
+    #   include FastGettext::Translation
+    #   @@x = _('y')
+    # end
+    def self.included(klas)  #:nodoc:
+      klas.extend self
+    end
+
+    def _(key)
+      FastGettext.cached_find(key) or key
+    end
+
+    #translate pluralized
+    # some languages have up to 4 plural forms...
+    # n_(singular, plural, plural form 2, ..., count)
+    # n_('apple','apples',3)
+    def n_(*keys)
+      count = keys.pop
+      translations = FastGettext.cached_plural_find *keys
+      selected = FastGettext.pluralisation_rule.call(count)
+      selected = selected ? 1 : 0 unless selected.is_a? Numeric #convert booleans to numbers
+      translations[selected] || keys[selected] || keys.last
+    end
+
+    #translate, but discard namespace if nothing was found
+    # Car|Tire -> Tire if no translation could be found
+    def s_(key,seperator=nil)
+      translation = FastGettext.cached_find(key) and return translation
+      key.split(seperator||NAMESPACE_SEPERATOR).last
+    end
+
+    #tell gettext: this string need translation (will be found during parsing)
+    def N_(translate)
+      translate
+    end
+
+    #tell gettext: this string need translation (will be found during parsing)
+    def Nn_(*keys)
+      keys
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,17 @@
+module FastGettext
+  # Responsibility:
+  #  - decide which repository to choose from given input
+  module TranslationRepository
+    extend self
+
+    # only single-word types supported atm (mytype works, MyType will not)
+    def build(name, options)
+      type = options[:type] || :mo
+      class_name = type.to_s.capitalize
+      unless FastGettext::TranslationRepository.constants.map{|c|c.to_s}.include?(class_name)
+        require "fast_gettext/translation_repository/#{type}" 
+      end
+      eval(class_name).new(name,options)
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,49 @@
+module FastGettext
+  module TranslationRepository
+    # Responsibility:
+    #  - base for all repositories
+    #  - fallback as empty repository, that cannot translate anything but does not crash
+    class Base
+      def initialize(name,options={})
+        @name = name
+        @options = options
+      end
+
+      def pluralisation_rule
+        nil
+      end
+
+      def available_locales
+        []
+      end
+
+      def [](key)
+        current_translations[key]
+      end
+
+      def plural(*keys)
+        current_translations.plural(*keys)
+      end
+
+      protected
+
+      def current_translations
+        MoFile.empty
+      end
+
+      def find_files_in_locale_folders(relative_file_path,path)
+        path ||= "locale"
+        raise "path #{path} cound not be found!" unless File.exist?(path)
+
+        @files = {}
+        Dir[File.join(path,'*')].each do |locale_folder|
+          next unless File.basename(locale_folder) =~ LOCALE_REX
+          file = File.join(locale_folder,relative_file_path)
+          next unless File.exist? file
+          locale = File.basename(locale_folder)
+          @files[locale] = yield(locale,file)
+        end
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,43 @@
+require 'fast_gettext/translation_repository/base'
+
+module FastGettext
+  module TranslationRepository
+    # Responsibility:
+    #  - delegate calls to members of the chain in turn
+    #TODO cache should be expired after a repo was added
+    class Chain < Base
+      attr_accessor :chain
+
+      def initialize(name,options={})
+        super
+        self.chain = options[:chain]
+      end
+
+      def available_locales
+        chain.map{|c|c.available_locales}.flatten.uniq
+      end
+
+      def pluralisation_rule
+        chain.each do |c|
+          result = c.pluralisation_rule and return result
+        end
+        nil
+      end
+
+      def [](key)
+        chain.each do |c|
+          result = c[key] and return result
+        end
+        nil
+      end
+
+      def plural(*keys)
+        chain.each do |c|
+          result = c.plural(*keys)
+          return result unless result.compact.empty?
+        end
+        []
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,57 @@
+require 'active_record'
+module FastGettext
+  module TranslationRepository
+    # Responsibility:
+    #  - provide access to translations in database through a database abstraction
+    #
+    #  Options:
+    #   :model => Model that represents your keys
+    #   you can either use the models supplied under db/, extend them or build your own
+    #   only constraints:
+    #     key: find_by_key, translations
+    #     translation: text, locale
+    class Db
+      def initialize(name,options={})
+        @model = options[:model]
+      end
+
+      @@seperator = '||||' # string that seperates multiple plurals
+      def self.seperator=(sep);@@seperator = sep;end
+      def self.seperator;@@seperator;end
+
+      def available_locales
+        if @model.respond_to? :available_locales
+          @model.available_locales || []
+        else
+          []
+        end
+      end
+
+      def pluralisation_rule
+        if @model.respond_to? :pluralsation_rule
+          @model.pluralsation_rule
+        else
+          nil
+        end
+      end
+
+      def [](key)
+        @model.translation(key, FastGettext.locale)
+      end
+
+      def plural(*args)
+        if translation = @model.translation(args*self.class.seperator, FastGettext.locale)
+          translation.to_s.split(self.class.seperator)
+        else
+          []
+        end
+      end
+
+      def self.require_models
+        require 'fast_gettext/translation_repository/db_models/translation_key'
+        require 'fast_gettext/translation_repository/db_models/translation_text'
+        FastGettext::TranslationRepository::DbModels
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,26 @@
+module FastGettext::TranslationRepository
+  module DbModels
+    class TranslationKey < ActiveRecord::Base
+      has_many :translations, :class_name=>'TranslationText'
+      accepts_nested_attributes_for :translations, :allow_destroy => true
+      
+      validates_uniqueness_of :key
+      validates_presence_of :key
+
+      def self.translation(key, locale)
+        return unless translation_key = find_by_key(key)
+        return unless translation_text = translation_key.translations.find_by_locale(locale)
+        translation_text.text
+      end
+
+      def self.available_locales
+        @@available_locales ||= TranslationText.count(:group=>:locale).keys.sort
+      end
+
+      #this is only for ActiveSupport to get polymorphic_url FastGettext::... namespace free
+      def self.model_name
+        ActiveSupport::ModelName.new('TranslationKey')
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,9 @@
+module FastGettext::TranslationRepository
+  module DbModels
+    class TranslationText < ActiveRecord::Base
+      belongs_to :key, :class_name=>'TranslationKey'
+      validates_presence_of :locale
+      validates_uniqueness_of :locale, :scope=>:translation_key_id
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,27 @@
+require 'fast_gettext/translation_repository/base'
+
+module FastGettext
+  module TranslationRepository
+    # This should be used in a TranslationRepository::Chain, so tat untranslated keys can be found
+    # Responsibility:
+    #  - log every translation call
+    class Logger < Base
+      attr_accessor :callback
+
+      def initialize(name,options={})
+        super
+        self.callback = options[:callback]
+      end
+
+      def [](key)
+        callback.call(key)
+        nil
+      end
+
+      def plural(*keys)
+        callback.call(keys)
+        []
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,35 @@
+require 'fast_gettext/translation_repository/base'
+module FastGettext
+  module TranslationRepository
+     # Responsibility:
+    #  - find and store mo files
+    #  - provide access to translations in mo files
+    class Mo < Base
+      def initialize(name,options={})
+        find_and_store_files(name,options)
+        super
+      end
+
+      def available_locales
+        @files.keys
+      end
+
+      def pluralisation_rule
+        current_translations.pluralisation_rule
+      end
+
+      protected
+
+      def find_and_store_files(name,options)
+        # parse all .mo files with the right name, that sit in locale/LC_MESSAGES folders
+        find_files_in_locale_folders(File.join('LC_MESSAGES',"#{name}.mo"), options[:path]) do |locale,file|
+          @files[locale] = MoFile.new(file)
+        end
+      end
+
+      def current_translations
+        @files[FastGettext.locale] || MoFile.empty
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,18 @@
+require 'fast_gettext/translation_repository/base'
+require 'fast_gettext/translation_repository/mo'
+module FastGettext
+  module TranslationRepository
+     # Responsibility:
+    #  - find and store po files
+    #  - provide access to translations in po files
+    class Po < Mo
+      protected
+      def find_and_store_files(name,options)
+        require 'fast_gettext/po_file'
+        find_files_in_locale_folders("#{name}.po",options[:path]) do |locale,file|
+          @files[locale] = PoFile.to_mo_file(file)
+        end
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,72 @@
+require 'fast_gettext/translation_repository/base'
+require 'yaml'
+
+module FastGettext
+  module TranslationRepository
+    # Responsibility:
+    #  - find and store yaml files
+    #  - provide access to translations in yaml files
+    class Yaml < Base
+      def initialize(name,options={})
+        find_and_store_files(options)
+        super
+      end
+
+      def available_locales
+        @files.keys
+      end
+
+      def plural(*keys)
+        ['one', 'other', 'plural2', 'plural3'].map do |name|
+          self[yaml_dot_notation(keys.first, name)]
+        end
+      end
+
+      def pluralisation_rule
+        self['pluralisation_rule'] ? lambda{|n| eval(self['pluralisation_rule']) } : nil
+      end
+
+      protected
+
+      MAX_FIND_DEPTH = 10
+
+      def find_and_store_files(options)
+        @files = {}
+        path = options[:path] || 'config/locales'
+        Dir["#{path}/??.yml"].each do |yaml_file|
+          locale = yaml_file.match(/([a-z]{2})\.yml$/)[1]
+          @files[locale] = load_yaml(yaml_file, locale)
+        end
+      end
+
+      def current_translations
+        @files[FastGettext.locale] || super
+      end
+
+      # Given a yaml file return a hash of key -> translation
+      def load_yaml(file, locale)
+        yaml = YAML.load_file(file)
+        yaml_hash_to_dot_notation(yaml[locale])
+      end
+
+      def yaml_hash_to_dot_notation(yaml_hash)
+        add_yaml_key({}, nil, yaml_hash)
+      end
+
+      def add_yaml_key(result, prefix, hash)
+        hash.each_pair do |key, value|
+          if value.kind_of?(Hash)
+            add_yaml_key(result, yaml_dot_notation(prefix, key), value)
+          else
+            result[yaml_dot_notation(prefix, key)] = value
+          end
+        end
+        result
+      end
+
+      def yaml_dot_notation(a,b)
+        a ? "#{a}.#{b}" : b
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,236 @@
+= Ruby-GetText-Package
+
+Ruby-GetText-Package is a Localization(L10n) library and tool  
+which is modeled after the GNU gettext package.
+
+This library translates original messages to localized  
+messages using client-side locale information(environment  
+variable or CGI variable).
+
+The tools for developers support creating, useing, and modifying  
+localized message files(message catalogs).
+
+((*Rails*))
+Rails support has been removed.  
+Rails / ActiveRecord specific code now lives in gettext_rails and gettext_activerecord.
+
+== Website
+* homepage[http://www.yotabanana.com/hiki/ruby-gettext.html]
+* on rubyforge[http://gettext/rubyforge.org/]
+* on github[http://github.com/gettext/]
+
+== Features
+* Simple APIs(similar to GNU gettext)
+
+* rgettext creates po-files from 
+  * ruby scripts 
+  * glade-2 XML file(.glade)
+  * ERB file(.rhtml, .erb)
+  * Anything (with your own parsers)
+  * The po-files are compatible to GNU gettext.
+
+* rmsgfmt creates a mo-file from a po-file.
+  The mo-file is compatible to GNU gettext(msgfmt).
+
+* textdomain's scope is adapt to ruby class/module mechanism.
+  * A class/module can have plural textdomains.
+  * a message is looked up in its class/module and ancestors.
+
+* CGI support (gettext/cgi)
+  * Locale is retrieved from client informations
+    (HTTP_ACCEPT_LANGUAGE, HTTP_ACCEPT_CHARSET, QUERY_STRING(lang), Cookies(lang)).
+
+* String%() is extended to use named argument such as <tt>%{foo}" %{:foo => 1}</tt>.
+  Notes that Ruby-1.9.x supports this format by itself.
+
+== Requirements
+* {Ruby 1.8.3 or later}[http://www.ruby-lang.org]
+* {Rubygems}[http://www.rubygems.org/]
+* {locale gem}[http://rubyforge.org/projects/locale/]
+  * $ gem install locale
+* (for development only)
+  * {GNU gettext 0.10.35 or later}[http://www.gnu.org/software/gettext/gettext.html]
+  * {Racc-1.4.3 or later}[http://www.ruby-lang.org/raa/list.rhtml?name=racc]
+    * (for compiling src/rmsgfmt.ry only)
+
+== Install
+* Uninstall old gettext if exists.
+    (sudo/su on POSIX system)
+    gem uninstall gettext
+
+* gem
+    #from github (edge/unstable)
+    (sudo/su on POSIX system)
+    gem install locale
+    gem install mutoh-gettext -s http://gems.github.com/
+
+    #from rubyforge (stable)
+    (sudo/su on POSIX system)
+    gem install locale
+    gem install gettext
+
+* download tar-ball
+    # De-Compress archive and enter its top directory.
+    (sudo/su on POSIX system)
+    ruby setup.rb
+
+You can also install files in your favorite directory by  
+supplying setup.rb some options. Try <tt>ruby setup.rb --help</tt>.
+
+== Usage
+===Translation
+- _: Basic translation method
+  Translates the message.
+    _("Hello")
+
+The gettext methods comes in 3 combinable flavors
+- n: Pluralized
+  Returns singular or plural form, depending on how many you have.
+    n_("Apple", "%{num} Apples", 3)
+    n_(["Apple", "%{num} Apples"], 3)
+
+- p: context aware
+  A context is a prefix to your translation, usefull when one word has different meanings, depending on its context.
+    p_("Printer","Open") <=> p_("File","Open")
+    is the same as s_("Printer|Open")  <=> s_("File|Open")
+
+- s: without context
+  If a translation could not be found, return the msgid without context.
+    s_("Printer|Open") => "Öffnen" #translation found
+    s_("Printer|Open") => "Open"   #translation not found
+
+- combinations
+    np_("Fruit", "Apple", "%{num} Apples", 3)
+    ns_("Fruit|Apple","%{num} Apples", 3)
+
+    np_(["Fruit","Apple","%{num} Apples"], 3)
+    ns_(["Fruit|Apple","%{num} Apples"], 3)
+
+- N_, Nn_: Makes dynamic translation messages readable for the gettext parser.
+  <tt>_(fruit)</tt> cannot be understood by the gettext parser. To help the parser find all your translations,
+  you can add <tt>fruit = N_("Apple")</tt> which does not translate, but tells the parser: "Apple" needs translation.
+
+    fruit = N_("Apple")   # same as fruit = "Apple"
+    _(fruit)              # does a normal translation
+
+    fruits = Nn_("Apple", "%{num} Apples")
+    n_(fruits, 3)
+
+=== Locale / Domain
+GetText stores the locale your are using
+  GetText.locale = "en_US" # translate into english from now on
+  GetText.locale # => en_US
+Or
+  include GetText
+  set_locale "en_US"
+
+Each locale can have different sets of translations (text domains) (e.g. Financial terms + Human-resource terms)
+  GetText.bindtextdomain('financial')
+Or
+  include GetText
+  bindtextdomain('financial')
+
+For more details and options, have a look at the samples folder or
+consult the tutorial[http://www.yotabanana.com/hiki/ruby-gettext-howto.html].
+
+
+== License
+This program is licenced under the same licence as Ruby.  
+(See the file 'COPYING'.)
+
+* mofile.rb
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>
+
+* gettext.rb
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>
+
+* rgettext 
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Yasushi Shoji <yashi at atmark-techno.com>
+
+* setup.rb
+  * Copyright (C) 2000-2005 Minero Aoki <aamine at loveruby.net>
+  * This file is released under LGPL. See the top of the install.rb.
+
+* Others
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+
+
+== Translators
+* Bosnian(bs)                - Sanjin Sehic <saserr at gmail.com>
+* Bulgarian(bg)              - Sava Chankov <sava.chankov at gmail.com>
+* Catalan(ca)                - Ramon Salvadó <rsalvado at gnuine.com>
+* Chinese(Simplified)(zh_CN)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * Yingfeng <blogyingfeng at gmail.com>
+* Chinese(Traditional)(zh_TW)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * LIN CHUNG-YI <xmarsh at gmail.com>
+* Croatian(hr)               - Sanjin Sehic <saserr at gmail.com>
+* Czech(cs)                  - Karel Miarka <kajism at yahoo.com>
+* Dutch(nl)                  - Menno Jonkers <ruby-gettext at jonkers.com>
+* Esperanto(eo)              - Malte Milatz <malte at gmx-topmail.de>
+* Estonian(et)               - Erkki Eilonen <erkki at itech.ee>
+* French(fr)
+  * Vincent Isambart <vincent.isambart at gmail.com> (current)
+  * David Sulc <davidsulc at gmail.com>
+  * Laurent Sansonetti <laurent.sansonetti at gmail.com>
+* German(de)
+  * Patrick Lenz <patrick at limited-overload.de> (current)
+  * Detlef Reichl <detlef.reichl at gmx.org>
+  * Sven Herzberg <herzi at abi02.de>
+  * Sascha Ebach <se at digitale-wertschoepfung.de>
+* Greek(el)                  - Vassilis Rizopoulos <damphyr at gmx.net>
+* Hungarian(hu)              - Tamás Tompa <tompata at gmail.com>
+* Italian(it)
+  * Marco Lazzeri <marco.lazzeri at gmail.com>
+  * Gabriele Renzi <surrender_it at yahoo.it>
+* Japanese(ja)               - Masao Mutoh <mutoh at highway.ne.jp>
+* Korean(ko)                 - Gyoung-Yoon Noh <nohmad at gmail.com>
+* Latvian(lv)                - Aivars Akots <aivars.akots at gmail.com>
+* Norwegian(nb)              - Runar Ingebrigtsen <runar at mopo.no>
+* Portuguese(Brazil)(pt_BR)  
+  * Antonio S. de A. Terceiro <terceiro at softwarelivre.org> (current)
+  * Joao Pedrosa <joaopedrosa at gmail.com>
+* Russian(ru)                - Yuri Kozlov <kozlov.y at gmail.com>
+* Serbian(sr)                - Slobodan Paunović" <slobodan.paunovic at gmail.com>
+* Spanish(es)
+  * David Espada <davinci at escomposlinux.org> (current)
+  * David Moreno Garza <damog at damog.net>
+* Swedish(sv)                - Nikolai Weibull <mailing-lists.ruby-talk at rawuncut.elitemail.org>
+* Ukrainian(ua)              - Alex Rootoff <rootoff at pisem.net>
+* Vietnamese(vi)             - Ngoc Dao Thanh <ngocdaothanh at gmail.com>
+
+== Status of translations
+* Bosnian(bs)               - 1.90.0 (old)
+* Bulgarian(bg)             - 2.0.0pre1 (new)
+* Catalan(ca)               - 2.0.0pre1
+* Croatian(hr)              - 1.90.0 (old)
+* Chinese(zh_CN)            - 2.0.0pre1
+* Chinese(zh_TW)            - 2.0.0pre1
+* Czech(cs)                 - 1.9.0 (old)
+* Dutch(nl)                 - 1.90.0 (old)
+* English(default)          - 1.90.0 (old)
+* Esperanto(eo)             - 2.0.0pre1
+* Estonian(et)              - 2.0.0pre1
+* French(fr)                - 2.0.0pre1
+* German(de)                - 2.0.0pre1
+* Greek(el)                 - 2.0.0pre1 
+* Hungarian(hu)             - 2.0.0pre1
+* Italian(it)               - 1.6.0 (old)
+* Japanese(ja)              - 2.0.0pre1
+* Korean(ko)                - 1.9.0 (old)
+* Latvian(lv)               - 2.0.0pre1 (new)
+* Norwegian(nb)             - 2.0.0pre1
+* Portuguese(Brazil)(pt_BR) - 2.0.0pre1
+* Russian(ru)               - 2.0.0pre1
+* Serbian(sr)               - 1.91.0 (old)
+* Spanish(es)               - 2.0.0pre1
+* Swedish(sv)               - 0.8.0 (too much old)
+* Ukrainian(ua)             - 2.0.0pre1
+* Vietnamese(vi)            - 2.0.0pre1
+
+== Maintainer
+Masao Mutoh <mutoh at highway.ne.jp>
@@ -0,0 +1,107 @@
+=begin
+  iconv.rb - Pseudo Iconv class. Supports Iconv.iconv, Iconv.conv.
+
+  For Matz Ruby:
+  If you don't have iconv but glib2, this library uses glib2 iconv functions.
+
+  For JRuby:
+  Use Java String class to convert strings.
+
+  Copyright (C) 2004-2007  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+  $Id: iconv.rb,v 1.6 2007/11/08 14:21:22 mutoh Exp $
+=end
+
+#Modifications
+#wrapped inside FastGettext namespace to reduce conflic
+
+begin
+  require 'iconv'
+rescue LoadError
+  # Provides Iconv.iconv which normally is provided through Ruby/GLib(1) functions.
+  # This library is required for 'gettext'.
+  # If you require 'gettext/iconv', it tries to call Ruby/GLib function
+  # when it doesn't find original Iconv class(iconv.so) it adds a pseudo class.
+  #
+  # One-click Ruby Installer for Win32 hadn’t had iconv and there hadn’t been a way to install iconv.so itself for Win32.
+  # And JRuby hadn’t had Iconv.
+  # I’ve not checked them currently, but if they’ve supported iconv now, we don’t need this anymore...
+  #
+  # (1) Ruby/GLib is a module which is provided from Ruby-GNOME2 Project. 
+  # You can get binaries for Win32(One-Click Ruby Installer).
+  # <URL: http://ruby-gnome2.sourceforge.jp/>
+  module FastGettext
+    class Iconv2
+      module Failure; end
+      class InvalidEncoding < ArgumentError;  include Failure; end
+      class IllegalSequence < ArgumentError;  include Failure; end
+      class InvalidCharacter < ArgumentError; include Failure; end
+
+      if RUBY_PLATFORM =~ /java/
+        def self.conv(to, from, str)
+          raise InvalidCharacter, "the 3rd argument is nil" unless str
+          begin
+            str = java.lang.String.new(str.unpack("C*").to_java(:byte), from)
+            str.getBytes(to).to_ary.pack("C*")
+          rescue java.io.UnsupportedEncodingException
+            raise InvalidEncoding
+          end
+        end
+      else
+        begin
+          require 'glib2'
+
+          def self.check_glib_version?(major, minor, micro) # :nodoc:
+            (GLib::BINDING_VERSION[0] > major ||
+             (GLib::BINDING_VERSION[0] == major &&
+              GLib::BINDING_VERSION[1] > minor) ||
+             (GLib::BINDING_VERSION[0] == major &&
+              GLib::BINDING_VERSION[1] == minor &&
+              GLib::BINDING_VERSION[2] >= micro))
+          end
+
+          if check_glib_version?(0, 11, 0)
+            # This is a function equivalent of Iconv.iconv.
+            # * to: encoding name for destination
+            # * from: encoding name for source
+            # * str: strings to be converted
+            # * Returns: Returns an Array of converted strings.
+            def self.conv(to, from, str)
+              begin
+                GLib.convert(str, to, from)
+              rescue GLib::ConvertError => e
+                case e.code
+                when GLib::ConvertError::NO_CONVERSION
+                  raise InvalidEncoding.new(str)
+                when GLib::ConvertError::ILLEGAL_SEQUENCE
+                  raise IllegalSequence.new(str)
+                else
+                  raise InvalidCharacter.new(str)
+                end
+              end
+            end
+          else
+            def self.conv(to, from, str) # :nodoc:
+              begin
+                GLib.convert(str, to, from)
+              rescue
+                raise IllegalSequence.new(str)
+              end
+            end
+          end
+        rescue LoadError
+          def self.conv(to, from, str) # :nodoc:
+            warn "Iconv was not found." if $DEBUG
+            str
+          end
+        end
+      end
+      def self.iconv(to, from, str)
+        conv(to, from, str).split(//)
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,296 @@
+=begin
+    mofile.rb - A simple class for operating GNU MO file.
+
+    Copyright (C) 2003-2008  Masao Mutoh
+    Copyright (C) 2002  Masahiro Sakai, Masao Mutoh
+    Copyright (C) 2001  Masahiro Sakai
+
+        Masahiro Sakai                  <s01397ms at sfc.keio.ac.jp>
+        Masao Mutoh                     <mutoh at highway.ne.jp>
+
+    You can redistribute this file and/or modify it under the same term
+    of Ruby.  License of Ruby is included with Ruby distribution in
+    the file "README".
+
+    $Id: mo.rb,v 1.10 2008/06/17 16:40:52 mutoh Exp $
+=end
+
+require 'iconv'
+require 'stringio'
+
+#Modifications:
+#  use Iconv or FastGettext::Icvon
+
+module FastGettext
+  module GetText
+    class MOFile < Hash
+      class InvalidFormat < RuntimeError; end;
+
+      attr_reader :filename
+
+      Header = Struct.new(:magic,
+                          :revision,
+                          :nstrings,
+                          :orig_table_offset,
+                          :translated_table_offset,
+                          :hash_table_size,
+                          :hash_table_offset)
+
+      # The following are only used in .mo files
+      # with minor revision >= 1.
+      class HeaderRev1 < Header
+        attr_accessor :n_sysdep_segments,
+        :sysdep_segments_offset,
+        :n_sysdep_strings,
+        :orig_sysdep_tab_offset,
+        :trans_sysdep_tab_offset
+      end
+
+      MAGIC_BIG_ENDIAN    = "\x95\x04\x12\xde"
+      MAGIC_LITTLE_ENDIAN = "\xde\x12\x04\x95"
+
+      def self.open(arg = nil, output_charset = nil)
+        result = self.new(output_charset)
+        result.load(arg)
+      end
+
+      def initialize(output_charset = nil)
+        @filename = nil
+        @last_modified = nil
+        @little_endian = true
+        @output_charset = output_charset
+        super()
+      end
+
+      def update!
+        if FileTest.exist?(@filename)
+          st = File.stat(@filename)
+          load(@filename) unless (@last_modified == [st.ctime, st.mtime])
+        else
+          warn "#{@filename} was lost." if $DEBUG
+          clear
+        end
+        self
+      end
+
+      def load(arg)
+        if arg.kind_of? String
+          begin
+            st = File.stat(arg)
+            @last_modified = [st.ctime, st.mtime]
+          rescue Exception
+          end
+          load_from_file(arg)
+        else
+          load_from_stream(arg)
+        end
+        @filename = arg
+        self
+      end
+
+      def load_from_stream(io)
+        magic = io.read(4)
+        case magic
+        when MAGIC_BIG_ENDIAN
+          @little_endian = false
+        when MAGIC_LITTLE_ENDIAN
+          @little_endian = true
+        else
+          raise InvalidFormat.new(sprintf("Unknown signature %s", magic.dump))
+        end
+
+        endian_type6 = @little_endian ? 'V6' : 'N6'
+        endian_type_astr = @little_endian ? 'V*' : 'N*'
+
+        header = HeaderRev1.new(magic, *(io.read(4 * 6).unpack(endian_type6)))
+
+        if header.revision == 1
+          # FIXME: It doesn't support sysdep correctly.
+          header.n_sysdep_segments = io.read(4).unpack(endian_type6)
+          header.sysdep_segments_offset = io.read(4).unpack(endian_type6)
+          header.n_sysdep_strings = io.read(4).unpack(endian_type6)
+          header.orig_sysdep_tab_offset = io.read(4).unpack(endian_type6)
+          header.trans_sysdep_tab_offset = io.read(4).unpack(endian_type6)
+        elsif header.revision > 1
+          raise InvalidFormat.new(sprintf("file format revision %d isn't supported", header.revision))
+        end
+        io.pos = header.orig_table_offset
+        orig_table_data = io.read((4 * 2) * header.nstrings).unpack(endian_type_astr)
+
+        io.pos = header.translated_table_offset
+        trans_table_data = io.read((4 * 2) * header.nstrings).unpack(endian_type_astr)
+
+        original_strings = Array.new(header.nstrings)
+        for i in 0...header.nstrings
+          io.pos = orig_table_data[i * 2 + 1]
+          original_strings[i] = io.read(orig_table_data[i * 2 + 0])
+        end
+
+        clear
+        for i in 0...header.nstrings
+          io.pos = trans_table_data[i * 2 + 1]
+          str = io.read(trans_table_data[i * 2 + 0])
+
+          if (! original_strings[i]) || original_strings[i] == ""
+            if str
+              @charset = nil
+              @nplurals = nil
+              @plural = nil
+              str.each_line{|line|
+                if /^Content-Type:/i =~ line and /charset=((?:\w|-)+)/i =~ line
+                  @charset = $1
+                elsif /^Plural-Forms:\s*nplurals\s*\=\s*(\d*);\s*plural\s*\=\s*([^;]*)\n?/ =~ line
+                  @nplurals = $1
+                  @plural = $2
+                end
+                break if @charset and @nplurals
+              }
+              @nplurals = "1" unless @nplurals
+              @plural = "0" unless @plural
+            end
+          else
+            if @output_charset
+              begin
+                iconv = Iconv || FastGettext::Iconv
+                str = iconv.conv(@output_charset, @charset, str) if @charset
+              rescue iconv::Failure
+                if $DEBUG
+                  warn "@charset = ", @charset
+                  warn"@output_charset = ", @output_charset
+                  warn "msgid = ", original_strings[i]
+                  warn "msgstr = ", str
+                end
+              end
+            end
+          end
+          self[original_strings[i]] = str.freeze
+        end
+        self
+      end
+
+      # Is this number a prime number ?
+      # http://apidock.com/ruby/Prime
+      def prime?(number)
+        ('1' * number) !~ /^1?$|^(11+?)\1+$/
+      end
+
+      def next_prime(seed)
+        require 'mathn'
+        prime = Prime.new
+        while current = prime.succ
+          return current if current > seed
+        end
+      end
+
+      # From gettext-0.12.1/gettext-runtime/intl/hash-string.h
+      # Defines the so called `hashpjw' function by P.J. Weinberger
+      # [see Aho/Sethi/Ullman, COMPILERS: Principles, Techniques and Tools,
+      # 1986, 1987 Bell Telephone Laboratories, Inc.]
+      HASHWORDBITS = 32
+      def hash_string(str)
+        hval = 0
+        i = 0
+        str.each_byte do |b|
+          break if b == '\0'
+          hval <<= 4
+          hval += b.to_i
+          g = hval & (0xf << (HASHWORDBITS - 4))
+          if (g != 0)
+            hval ^= g >> (HASHWORDBITS - 8)
+            hval ^= g
+          end
+        end
+        hval
+      end
+
+      def save_to_stream(io)
+        #Save data as little endian format.
+        header_size = 4 * 7
+        table_size  = 4 * 2 * size
+
+        hash_table_size = next_prime((size * 4) / 3)
+        hash_table_size = 3 if hash_table_size <= 2
+        header = Header.new(
+                            MAGIC_LITTLE_ENDIAN,          # magic
+                            0,                            # revision
+                            size,                         # nstrings
+                            header_size,                  # orig_table_offset
+                            header_size + table_size,     # translated_table_offset
+                            hash_table_size,              # hash_table_size
+                            header_size + table_size * 2  # hash_table_offset
+                            )
+        io.write(header.to_a.pack('a4V*'))
+
+        ary = to_a
+        ary.sort!{|a, b| a[0] <=> b[0]} # sort by original string
+
+        pos = header.hash_table_size * 4 + header.hash_table_offset
+
+        orig_table_data = Array.new()
+        ary.each{|item, _|
+          orig_table_data.push(item.size)
+          orig_table_data.push(pos)
+          pos += item.size + 1 # +1 is <NUL>
+        }
+        io.write(orig_table_data.pack('V*'))
+
+        trans_table_data = Array.new()
+        ary.each{|_, item|
+          trans_table_data.push(item.size)
+          trans_table_data.push(pos)
+          pos += item.size + 1 # +1 is <NUL>
+        }
+        io.write(trans_table_data.pack('V*'))
+
+        hash_tab = Array.new(hash_table_size)
+        j = 0
+        ary[0...size].each {|key, _|
+          hash_val = hash_string(key)
+          idx = hash_val % hash_table_size
+          if hash_tab[idx] != nil
+            incr = 1 + (hash_val % (hash_table_size - 2))
+            begin
+              if (idx >= hash_table_size - incr)
+                idx -= hash_table_size - incr
+              else
+                idx += incr
+              end
+            end until (hash_tab[idx] == nil)
+          end
+          hash_tab[idx] = j + 1
+          j += 1
+        }
+        hash_tab.collect!{|i| i ? i : 0}
+
+        io.write(hash_tab.pack('V*'))
+
+        ary.each{|item, _| io.write(item); io.write("\0") }
+        ary.each{|_, item| io.write(item); io.write("\0") }
+
+        self
+      end
+
+      def load_from_file(filename)
+        @filename = filename
+        begin
+          File.open(filename, 'rb'){|f| load_from_stream(f)}
+        rescue => e
+          e.set_backtrace("File: #{@filename}")
+          raise e
+        end
+      end
+
+      def save_to_file(filename)
+        File.open(filename, 'wb'){|f| save_to_stream(f)}
+      end
+
+      def set_comment(msgid_or_sym, comment)
+        #Do nothing
+      end
+
+
+      attr_accessor :little_endian, :path, :last_modified
+      attr_reader :charset, :nplurals, :plural
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,331 @@
+=begin
+  poparser.rb - Generate a .mo
+
+  Copyright (C) 2003-2009 Masao Mutoh <mutoh at highway.ne.jp>
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+=end
+
+#MODIFIED
+# removed include GetText etc
+# added stub translation method _(x)
+require 'racc/parser'
+
+module FastGettext
+module GetText
+
+  class PoParser < Racc::Parser
+
+    def _(x)
+      x
+    end
+
+module_eval <<'..end src/poparser.ry modeval..id7a99570e05', 'src/poparser.ry', 108
+  def unescape(orig)
+    ret = orig.gsub(/\\n/, "\n")
+    ret.gsub!(/\\t/, "\t")
+    ret.gsub!(/\\r/, "\r")
+    ret.gsub!(/\\"/, "\"")
+    ret
+  end
+  
+  def parse(str, data, ignore_fuzzy = true)
+    @comments = []
+    @data = data
+    @fuzzy = false
+    @msgctxt = ""
+    $ignore_fuzzy = ignore_fuzzy
+
+    str.strip!
+    @q = []
+    until str.empty? do
+      case str
+      when /\A\s+/
+	str = $'
+      when /\Amsgctxt/
+	@q.push [:MSGCTXT, $&]
+	str = $'
+      when /\Amsgid_plural/
+	@q.push [:MSGID_PLURAL, $&]
+	str = $'
+      when /\Amsgid/
+	@q.push [:MSGID, $&]
+	str = $'
+      when /\Amsgstr/
+	@q.push [:MSGSTR, $&]
+	str = $'
+      when /\A\[(\d+)\]/
+	@q.push [:PLURAL_NUM, $1]
+	str = $'
+      when /\A\#~(.*)/
+	$stderr.print _("Warning: obsolete msgid exists.\n")
+	$stderr.print "         #{$&}\n"
+	@q.push [:COMMENT, $&]
+	str = $'
+      when /\A\#(.*)/
+	@q.push [:COMMENT, $&]
+	str = $'      
+      when /\A\"(.*)\"/
+	@q.push [:STRING, $1]
+	str = $'
+      else
+	#c = str[0,1]
+	#@q.push [:STRING, c]
+	str = str[1..-1]
+      end
+    end 
+    @q.push [false, '$end']
+    if $DEBUG
+      @q.each do |a,b|
+      puts "[#{a}, #{b}]"
+      end
+    end
+    @yydebug = true if $DEBUG
+    do_parse
+
+    if @comments.size > 0
+      @data.set_comment(:last, @comments.join("\n"))
+    end
+    @data
+  end
+  
+  def next_token
+    @q.shift
+  end
+
+  def on_message(msgid, msgstr)
+    if msgstr.size > 0
+      @data[msgid] = msgstr
+      @data.set_comment(msgid, @comments.join("\n"))
+    end
+    @comments.clear
+    @msgctxt = ""
+  end
+      
+  def on_comment(comment)
+    @fuzzy = true if (/fuzzy/ =~ comment)
+    @comments << comment
+  end 
+
+
+..end src/poparser.ry modeval..id7a99570e05
+
+##### racc 1.4.5 generates ###
+
+racc_reduce_table = [
+ 0, 0, :racc_error,
+ 0, 10, :_reduce_none,
+ 2, 10, :_reduce_none,
+ 2, 10, :_reduce_none,
+ 2, 10, :_reduce_none,
+ 2, 12, :_reduce_5,
+ 1, 13, :_reduce_none,
+ 1, 13, :_reduce_none,
+ 4, 15, :_reduce_8,
+ 5, 16, :_reduce_9,
+ 2, 17, :_reduce_10,
+ 1, 17, :_reduce_none,
+ 3, 18, :_reduce_12,
+ 1, 11, :_reduce_13,
+ 2, 14, :_reduce_14,
+ 1, 14, :_reduce_15 ]
+
+racc_reduce_n = 16
+
+racc_shift_n = 26
+
+racc_action_table = [
+     3,    13,     5,     7,     9,    15,    16,    17,    20,    17,
+    13,    17,    13,    13,    11,    17,    23,    20,    13,    17 ]
+
+racc_action_check = [
+     1,    16,     1,     1,     1,    12,    12,    12,    18,    18,
+     7,    14,    15,     9,     3,    19,    20,    21,    23,    25 ]
+
+racc_action_pointer = [
+   nil,     0,   nil,    14,   nil,   nil,   nil,     3,   nil,     6,
+   nil,   nil,     0,   nil,     4,     5,    -6,   nil,     2,     8,
+     8,    11,   nil,    11,   nil,    12 ]
+
+racc_action_default = [
+    -1,   -16,    -2,   -16,    -3,   -13,    -4,   -16,    -6,   -16,
+    -7,    26,   -16,   -15,    -5,   -16,   -16,   -14,   -16,    -8,
+   -16,    -9,   -11,   -16,   -10,   -12 ]
+
+racc_goto_table = [
+    12,    22,    14,     4,    24,     6,     2,     8,    18,    19,
+    10,    21,     1,   nil,   nil,   nil,    25 ]
+
+racc_goto_check = [
+     5,     9,     5,     3,     9,     4,     2,     6,     5,     5,
+     7,     8,     1,   nil,   nil,   nil,     5 ]
+
+racc_goto_pointer = [
+   nil,    12,     5,     2,     4,    -7,     6,     9,    -7,   -17 ]
+
+racc_goto_default = [
+   nil,   nil,   nil,   nil,   nil,   nil,   nil,   nil,   nil,   nil ]
+
+racc_token_table = {
+ false => 0,
+ Object.new => 1,
+ :COMMENT => 2,
+ :MSGID => 3,
+ :MSGCTXT => 4,
+ :MSGID_PLURAL => 5,
+ :MSGSTR => 6,
+ :STRING => 7,
+ :PLURAL_NUM => 8 }
+
+racc_use_result_var = true
+
+racc_nt_base = 9
+
+Racc_arg = [
+ racc_action_table,
+ racc_action_check,
+ racc_action_default,
+ racc_action_pointer,
+ racc_goto_table,
+ racc_goto_check,
+ racc_goto_default,
+ racc_goto_pointer,
+ racc_nt_base,
+ racc_reduce_table,
+ racc_token_table,
+ racc_shift_n,
+ racc_reduce_n,
+ racc_use_result_var ]
+
+Racc_token_to_s_table = [
+'$end',
+'error',
+'COMMENT',
+'MSGID',
+'MSGCTXT',
+'MSGID_PLURAL',
+'MSGSTR',
+'STRING',
+'PLURAL_NUM',
+'$start',
+'msgfmt',
+'comment',
+'msgctxt',
+'message',
+'string_list',
+'single_message',
+'plural_message',
+'msgstr_plural',
+'msgstr_plural_line']
+
+Racc_debug_parser = true
+
+##### racc system variables end #####
+
+ # reduce 0 omitted
+
+ # reduce 1 omitted
+
+ # reduce 2 omitted
+
+ # reduce 3 omitted
+
+ # reduce 4 omitted
+
+module_eval <<'.,.,', 'src/poparser.ry', 25
+  def _reduce_5( val, _values, result )
+    @msgctxt = unescape(val[1]) + "\004"
+   result
+  end
+.,.,
+
+ # reduce 6 omitted
+
+ # reduce 7 omitted
+
+module_eval <<'.,.,', 'src/poparser.ry', 48
+  def _reduce_8( val, _values, result )
+    if @fuzzy and $ignore_fuzzy 
+      if val[1] != ""
+        $stderr.print _("Warning: fuzzy message was ignored.\n")
+        $stderr.print "         msgid '#{val[1]}'\n"
+      else
+        on_message('', unescape(val[3]))
+      end
+      @fuzzy = false
+    else
+      on_message(@msgctxt + unescape(val[1]), unescape(val[3]))
+    end
+    result = ""
+   result
+  end
+.,.,
+
+module_eval <<'.,.,', 'src/poparser.ry', 65
+  def _reduce_9( val, _values, result )
+    if @fuzzy and $ignore_fuzzy
+      if val[1] != ""
+        $stderr.print _("Warning: fuzzy message was ignored.\n")
+        $stderr.print "msgid = '#{val[1]}\n"
+      else
+        on_message('', unescape(val[3]))
+      end
+      @fuzzy = false
+    else
+      on_message(@msgctxt + unescape(val[1]) + "\000" + unescape(val[3]), unescape(val[4]))
+    end
+    result = ""
+   result
+  end
+.,.,
+
+module_eval <<'.,.,', 'src/poparser.ry', 76
+  def _reduce_10( val, _values, result )
+    if val[0].size > 0
+      result = val[0] + "\000" + val[1]
+    else
+      result = ""
+    end
+   result
+  end
+.,.,
+
+ # reduce 11 omitted
+
+module_eval <<'.,.,', 'src/poparser.ry', 84
+  def _reduce_12( val, _values, result )
+    result = val[2]
+   result
+  end
+.,.,
+
+module_eval <<'.,.,', 'src/poparser.ry', 91
+  def _reduce_13( val, _values, result )
+    on_comment(val[0])
+   result
+  end
+.,.,
+
+module_eval <<'.,.,', 'src/poparser.ry', 99
+  def _reduce_14( val, _values, result )
+    result = val.delete_if{|item| item == ""}.join
+   result
+  end
+.,.,
+
+module_eval <<'.,.,', 'src/poparser.ry', 103
+  def _reduce_15( val, _values, result )
+    result = val[0]
+   result
+  end
+.,.,
+
+ def _reduce_none( val, _values, result )
+  result
+ end
+
+  end   # class PoParser
+
+end   # module GetText
+end
 \ No newline at end of file
@@ -0,0 +1,74 @@
+#! /usr/bin/ruby
+=begin
+  string.rb - Extension for String.
+
+  Copyright (C) 2005,2006 Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+=end
+
+# Extension for String class. This feature is included in Ruby 1.9 or later.
+begin
+  raise unless ("a %{x}" % {:x=>'b'}) == 'a b'
+rescue ArgumentError
+  class String
+    alias :_fast_gettext_old_format_m :% # :nodoc:
+
+    PERCENT_MATCH_RE = Regexp.union(
+      /%%/,
+      /%\{([-\.\w]+)\}/,
+      /%<([-\.\w]+)>(.*?\d*\.?\d*[bBdiouxXeEfgGcps])/
+    )
+
+    # call-seq:
+    #  %(hash)
+    #
+    #  Default: "%s, %s" % ["Masao", "Mutoh"]
+    #  Extended:
+    #     "%{firstname}, %{lastname}" % {:firstname=>"Masao",:lastname=>"Mutoh"} == "Masao Mutoh"
+    #     with field type such as d(decimal), f(float), ...
+    #     "%<age>d, %<weight>.1f" % {:age => 10, :weight => 43.4} == "10 43.4"
+    # This is the recommanded way for Ruby-GetText
+    # because the translators can understand the meanings of the keys easily.
+    def %(args)
+      if args.kind_of? Hash
+        #stringify keys
+        replace = {}
+        args.each{|k,v|replace[k.to_s]=v}
+
+        #replace occurances
+        ret = dup
+        ret.gsub!(PERCENT_MATCH_RE) do |match|
+          if match == '%%'
+            '%'
+          elsif $1
+            replace.has_key?($1) ? replace[$1] : match
+          elsif $2
+            replace.has_key?($2) ? sprintf("%#{$3}", replace[$2]) : match
+          end
+        end
+        ret
+      else
+        ret = gsub(/%([{<])/, '%%\1')
+        ret._fast_gettext_old_format_m(args)
+      end
+    end
+  end
+end
+
+# 1.9.1 if you misspell a %{key} your whole page would blow up, no thanks...
+begin
+  ("%{b}" % {:a=>'b'})
+rescue KeyError
+  class String
+    alias :_fast_gettext_old_format_m :%
+    def %(*args)
+      begin
+        _fast_gettext_old_format_m(*args)
+      rescue KeyError
+        self
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,21 @@
+require File.join(File.dirname(__FILE__),'spec_helper')
+
+describe 'unconfigured' do
+  it "gives a useful error message when trying to just translate" do
+    FastGettext.text_domain = nil
+    begin
+      FastGettext._('x')
+      "".should == "success!?"
+    rescue FastGettext::Storage::NoTextDomainConfigured
+    end
+  end
+
+  it "gives a useful error message when only locale was set" do
+    FastGettext.locale = 'de'
+    begin
+      FastGettext._('x')
+      "".should == "success!?"
+    rescue FastGettext::Storage::NoTextDomainConfigured
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,35 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','spec_helper')
+
+de_file = File.join(current_folder,'..','locale','de','LC_MESSAGES','test.mo')
+de = FastGettext::MoFile.new(de_file)
+
+describe FastGettext::MoFile do
+  before :all do
+    File.exist?(de_file).should == true
+  end
+
+  it "parses a file" do
+    de['car'].should == 'Auto'
+  end
+
+  it "stores untranslated values as nil" do
+    de['Car|Model'].should == nil
+  end
+
+  it "finds pluralized values" do
+    de.plural('Axis','Axis').should == ['Achse','Achsen']
+  end
+
+  it "returns singular translations when pluralisation could not be found" do
+    de.plural('Axis','Axis','Axis').should == ['Achse','Achse','Achse']
+  end
+
+  it "returns ids when not plural and singular translations could not be found" do
+    de.plural('Axis','Axis','NOTFOUND').should == ['Achse','Achse','NOTFOUND']
+  end
+
+  it "can access plurals through []" do
+    de['Axis'].should == 'Achse' #singular
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,309 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','spec_helper')
+
+describe 'Storage' do
+  include FastGettext::Storage
+
+  before do
+    #reset everything to nil
+    self.available_locales = nil
+    self.default_text_domain = nil
+    self.default_locale = nil
+    send(:_locale=,nil)#nil is not allowed to be set...
+    default_locale.should be_nil
+    available_locales.should be_nil
+    locale.should == 'en'
+  end
+
+  def thread_save(method, value)
+    send("#{method}=",value)
+
+    # mess around with other threads
+    100.times do
+      Thread.new {FastGettext.send("#{method}=",'en')}
+    end
+    
+    send(method) == value
+  end
+
+  {:locale=>'de', :available_locales=>['de'], :text_domain=>'xx', :pluralisation_rule=>lambda{|x|x==4}}.each do |method, value|
+    it "stores #{method} thread-save" do
+      thread_save(method, value).should == true
+    end
+  end
+
+  it "stores translation_repositories non-thread-safe" do
+    self.translation_repositories[:x]=1
+    t = Thread.new{self.translation_repositories[:x]=2}
+    t.join
+    self.translation_repositories[:x].should == 2
+  end
+
+  describe :pluralisation_rule do
+    it "defaults to singular-if-1 when it is not set" do
+      stub!(:current_repository).and_return mock('',:pluralisation_rule=>nil)
+      self.pluralisation_rule = nil
+      pluralisation_rule.call(1).should == false
+      pluralisation_rule.call(0).should == true
+      pluralisation_rule.call(2).should == true
+    end
+  end
+
+  describe :default_locale do
+    it "stores default_locale non-thread-safe" do
+      thread_save(:default_locale, 'de').should == false
+    end
+
+    it "does not overwrite locale" do
+      self.locale = 'de'
+      self.default_locale = 'yy'
+      self.locale.should == 'de'
+    end
+
+    it "falls back to default if locale is missing" do
+      self.default_locale = 'yy'
+      self.locale.should == 'yy'
+    end
+
+    it "does not set non-available-locales as default" do
+      self.available_locales = ['xx']
+      self.default_locale = 'yy'
+      self.default_locale.should == nil
+    end
+
+    it "can set default_locale to nil" do
+      self.default_locale = 'xx'
+      self.default_locale = nil
+      default_locale.should be_nil
+    end
+  end
+
+  describe :default_text_domain do
+    it "stores default_text_domain non-thread-safe" do
+      thread_save(:default_text_domain, 'xx').should == false
+    end
+
+    it "uses default_text_domain when text_domain is not set" do
+      self.text_domain = nil
+      self.default_text_domain = 'x'
+      text_domain.should == 'x'
+    end
+
+    it "does not use default when domain is set" do
+      self.text_domain = 'x'
+      self.default_text_domain = 'y'
+      text_domain.should == 'x'
+    end
+  end
+
+  describe :default_available_locales do
+    after do
+      self.default_available_locales = nil
+    end
+
+    it "stores default_available_locales non-thread-safe" do
+      thread_save(:default_available_locales, 'xx').should == false
+    end
+
+    it "uses default_available_locales when available_locales is not set" do
+      self.available_locales = nil
+      self.default_available_locales = 'x'
+      available_locales.should == 'x'
+    end
+
+    it "does not use default when available_locales is set" do
+      self.available_locales = 'x'
+      self.default_available_locales = 'y'
+      available_locales.should == 'x'
+    end
+  end
+
+  describe :locale do
+    it "stores everything as long as available_locales is not set" do
+      self.available_locales = nil
+      self.locale = 'XXX'
+      locale.should == 'XXX'
+    end
+
+    it "is en if no locale and no available_locale were set" do
+      FastGettext.send(:_locale=,nil)
+      self.available_locales = nil
+      locale.should == 'en'
+    end
+
+    it "does not change the locale if locales was called with nil" do
+      self.locale = nil
+      locale.should == 'en'
+    end
+
+    it "is the first available_locale if one was set" do
+      self.available_locales = ['de']
+      locale.should == 'de'
+    end
+
+    it "does not store a locale if it is not available" do
+      self.available_locales = ['de']
+      self.locale = 'en'
+      locale.should == 'de'
+    end
+
+    it "set_locale returns the old locale if the new could not be set" do
+      self.locale = 'de'
+      self.available_locales = ['de']
+      self.set_locale('en').should == 'de'
+    end
+
+    {
+      'Opera' => "de-DE,de;q=0.9,en;q=0.8",
+      'Firefox' => "de-de,de;q=0.8,en-us;q=0.5,en;q=0.3",
+    }.each do |browser,accept_language|
+      it "sets the locale from #{browser} headers" do
+        FastGettext.available_locales = ['de_DE','de','xx']
+        FastGettext.locale = 'xx'
+        FastGettext.locale = accept_language
+        FastGettext.locale.should == 'de_DE'
+      end
+    end
+
+    it "sets a unimportant locale if it is the only available" do
+      FastGettext.available_locales = ['en','xx']
+      FastGettext.locale = "de-de,de;q=0.8,en-us;q=0.5,en;q=0.3"
+      FastGettext.locale.should == 'en'
+    end
+
+    it "sets the locale with the highest wheight" do
+      FastGettext.available_locales = ['en','de']
+      FastGettext.locale = "xx-us;q=0.5,de-de,de;q=0.8,en;q=0.9"
+      FastGettext.locale.should == 'en'
+    end
+
+    it "sets the locale from languages" do
+      FastGettext.available_locales = ['de']
+      FastGettext.locale = "xx-us;q=0.5,de-de;q=0.8,en-uk;q=0.9"
+      FastGettext.locale.should == 'de'
+    end
+
+    it "sets locale from comma seperated" do
+      FastGettext.available_locales = ['de_DE','en','xx']
+      FastGettext.locale = "de,de-de,en"
+      FastGettext.locale.should == 'de_DE'
+    end
+  end
+
+  describe :silence_errors do
+    before do
+      FastGettext.text_domain = 'xxx'
+    end
+
+    it "raises when a textdomain was empty" do
+      begin 
+        FastGettext._('x')
+        "".should == "success!?"
+      rescue FastGettext::Storage::NoTextDomainConfigured
+      end
+    end
+
+    it "can silence erros" do
+      FastGettext.silence_errors
+      FastGettext._('x').should == 'x'
+    end
+  end
+
+  describe :current_cache do
+    before do
+      FastGettext.text_domain = 'xxx'
+      FastGettext.available_locales = ['de','en']
+      FastGettext.locale = 'de'
+      FastGettext.current_repository.stub!(:"[]").with('abc').and_return 'old'
+      FastGettext.current_repository.stub!(:"[]").with('unfound').and_return nil
+      FastGettext._('abc')
+      FastGettext._('unfound')
+      FastGettext.locale = 'en'
+    end
+
+    it "stores a translation seperate by locale" do
+      FastGettext.current_cache['abc'].should == nil
+    end
+
+    it "stores a translation seperate by domain" do
+      FastGettext.locale = 'de'
+      FastGettext.text_domain = nil
+      FastGettext.current_cache['abc'].should == nil
+    end
+
+    it "cache is restored through setting of default_text_domain" do
+      FastGettext.locale = 'de'
+      FastGettext.text_domain = nil
+      FastGettext.default_text_domain = 'xxx'
+      FastGettext.current_cache['abc'].should == 'old'
+    end
+
+    it "cache is restored through setting of default_locale" do
+      FastGettext.send(:_locale=,nil)#reset locale to nil
+      FastGettext.default_locale = 'de'
+      FastGettext.locale.should == 'de'
+      FastGettext.current_cache['abc'].should == 'old'
+    end
+
+    it "stores a translation permanently" do
+      FastGettext.locale = 'de'
+      FastGettext.current_cache['abc'].should == 'old'
+    end
+
+    it "stores a unfound translation permanently" do
+      FastGettext.locale = 'de'
+      FastGettext.current_cache['unfound'].should == false
+    end
+  end
+
+  describe :key_exist? do
+    it "does not find default keys" do
+      FastGettext._('abcde')
+      key_exist?('abcde').should be_false
+    end
+
+    it "finds using the current repository" do
+      should_receive(:current_repository).and_return '1234'=>'1'
+      key_exist?('1234').should == true
+    end
+
+    it "sets the current cache with a found result" do
+      should_receive(:current_repository).and_return 'xxx'=>'1'
+      key_exist?('xxx')
+      current_cache['xxx'].should == '1'
+    end
+
+    it "does not overwrite an existing cache value" do
+      current_cache['xxx']='xxx'
+      stub!(:current_repository).and_return 'xxx'=>'1'
+      key_exist?('xxx')
+      current_cache['xxx'].should == 'xxx'
+    end
+
+    it "is false for gettext meta key" do
+      key_exist?("").should == false
+    end
+  end
+
+  describe :cached_find do
+    it "is nil for gettext meta key" do
+      cached_find("").should == false
+    end
+  end
+
+  describe FastGettext::Storage::NoTextDomainConfigured do
+    it "shows what to do" do
+      FastGettext::Storage::NoTextDomainConfigured.new.to_s.should =~ /FastGettext\.add_text_domain/
+    end
+
+    it "warns when text_domain is nil" do
+      FastGettext.text_domain = nil
+      FastGettext::Storage::NoTextDomainConfigured.new.to_s.should =~ /\(nil\)/
+    end
+
+    it "shows current text_domain" do
+      FastGettext.text_domain = 'xxx'
+      FastGettext::Storage::NoTextDomainConfigured.new('xxx').to_s.should =~ /xxx/
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,21 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+require 'fast_gettext/translation_repository/base'
+
+describe 'FastGettext::TranslationRepository::Base' do
+  before do
+    @rep = FastGettext::TranslationRepository::Base.new('x')
+  end
+
+  it "can be built" do
+    @rep.available_locales.should == []
+  end
+
+  it "cannot translate" do
+    @rep['car'].should == nil
+  end
+
+  it "cannot pluralize" do
+    @rep.plural('Axis','Axis').should == ['Axis','Axis']
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,82 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+class MockRepo
+  def [](key)#should_receive :[] does not work so well...
+    singular key
+  end
+end
+
+describe 'FastGettext::TranslationRepository::Chain' do
+  describe "empty chain" do
+    before do
+      @rep = FastGettext::TranslationRepository.build('chain', :chain=>[], :type=>:chain)
+    end
+
+    it "has no locales" do
+      @rep.available_locales.should == []
+    end
+
+    it "cannot translate" do
+      @rep['car'].should == nil
+    end
+
+    it "cannot pluralize" do
+      @rep.plural('Axis','Axis').should == []
+    end
+
+    it "has no pluralisation rule" do
+      @rep.pluralisation_rule.should == nil
+    end
+  end
+
+  describe "filled chain" do
+    before do
+      @one = MockRepo.new
+      @one.stub!(:singular).with('xx').and_return 'one'
+      @two = MockRepo.new
+      @two.stub!(:singular).with('xx').and_return 'two'
+      @rep = FastGettext::TranslationRepository.build('chain', :chain=>[@one, @two], :type=>:chain)
+    end
+
+    describe :singular do
+      it "uses the first repo in the chain if it responds" do
+        @rep['xx'].should == 'one'
+      end
+
+      it "uses the second repo in the chain if the first does not respond" do
+        @one.should_receive(:singular).and_return nil
+        @rep['xx'].should == 'two'
+      end
+    end
+
+    describe :plural do
+      it "uses the first repo in the chain if it responds" do
+        @one.should_receive(:plural).with('a','b').and_return ['A','B']
+        @rep.plural('a','b').should == ['A','B']
+      end
+
+      it "uses the second repo in the chain if the first does not respond" do
+        @one.should_receive(:plural).with('a','b').and_return [nil,nil]
+        @two.should_receive(:plural).with('a','b').and_return ['A','B']
+        @rep.plural('a','b').should == ['A','B']
+      end
+    end
+
+    describe :available_locales do
+      it "should be the sum of all added repositories" do
+        @one.should_receive(:available_locales).and_return ['de']
+        @two.should_receive(:available_locales).and_return ['de','en']
+        @rep.available_locales.should == ['de','en']
+      end
+    end
+
+    describe :pluralisation_rule do
+      it "chooses the first that exists" do
+        @one.should_receive(:pluralisation_rule).and_return nil
+        @two.should_receive(:pluralisation_rule).and_return 'x'
+        @rep.pluralisation_rule.should == 'x'
+      end
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,72 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+require 'active_record'
+require 'fast_gettext/translation_repository/db'
+
+include FastGettext::TranslationRepository::Db.require_models
+describe FastGettext::TranslationRepository::Db do
+
+  before :all do
+    ActiveRecord::Base.establish_connection({
+      :adapter => "sqlite3",
+      :database => ":memory:"
+    })
+
+    #create model table
+    #TODO surpress output ?
+    ActiveRecord::Schema.define(:version => 1) do
+      create_table :translation_keys do |t|
+        t.string :key, :unique=>true, :null=>false
+        t.timestamps
+      end
+      create_table :translation_texts do |t|
+        t.string :text, :locale
+        t.integer :translation_key_id, :null=>false
+        t.timestamps
+      end
+    end
+  end
+
+  before do
+    TranslationKey.delete_all
+    TranslationText.delete_all
+    FastGettext.locale = 'de'
+    @rep = FastGettext::TranslationRepository::Db.new('x', :model=>TranslationKey)
+  end
+
+  def create_translation(key, text)
+    translation_key = TranslationKey.create!(:key=>key)
+    TranslationText.create!(:translation_key_id=>translation_key.id, :text=>text, :locale=>'de')
+  end
+  
+  it "reads locales from the db" do
+    locales = ['de','en','es']
+    locales.reverse.each do |locale|
+      TranslationText.create!(:translation_key_id=>1, :text=>'asdasd', :locale=>locale)
+    end
+    @rep.available_locales.should == locales
+  end
+
+  it "has no pluralisation_rule by default" do
+    @rep.pluralisation_rule.should == nil
+  end
+
+  it "cannot translate when no models are present" do
+    @rep['car'].should == nil
+  end
+
+  it "can translate" do
+    create_translation 'car', 'Auto'
+    @rep['car'].should == 'Auto'
+  end
+
+  it "cannot pluralize when no model is present" do
+    @rep.plural('Axis','Axis').should == []
+  end
+
+  it "can pluralize" do
+    create_translation 'Axis||||Axis', 'Achse||||Achsen'
+    @rep.plural('Axis','Axis').should == ['Achse','Achsen']
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,41 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+describe 'FastGettext::TranslationRepository::Logger' do
+  before do
+    @callback = lambda{}
+    @rep = FastGettext::TranslationRepository.build('test', :type=>:logger, :callback=>@callback)
+    @rep.is_a?(FastGettext::TranslationRepository::Logger).should be_true
+  end
+  subject{@rep}
+
+  it{ should have(0).available_locales}
+
+  it "has no pluralisation_rule" do
+    @rep.pluralisation_rule.should == nil
+  end
+
+  describe :single do
+    it "logs every call" do
+      @callback.should_receive(:call).with('the_key')
+      @rep['the_key']
+    end
+
+    it "returns nil" do
+      @callback.should_receive(:call).with('the_key').and_return 'something'
+      @rep['the_key'].should == nil
+    end
+  end
+
+  describe :plural do
+    it "logs every call" do
+      @callback.should_receive(:call).with(['a','b'])
+      @rep.plural('a','b')
+    end
+
+    it "returns an empty array" do
+      @callback.should_receive(:call).with(['a','b']).and_return 'something'
+      @rep.plural('a','b').should == []
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,31 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+
+describe 'FastGettext::TranslationRepository::Mo' do
+  before do
+    @rep = FastGettext::TranslationRepository.build('test',:path=>File.join(current_folder,'..','..','locale'))
+    @rep.is_a?(FastGettext::TranslationRepository::Mo).should be_true
+  end
+
+  it "can be built" do
+    @rep.available_locales.sort.should == ['de','en']
+  end
+
+  it "can translate" do
+    FastGettext.locale = 'de'
+    @rep['car'].should == 'Auto'
+  end
+
+  it "can pluralize" do
+    FastGettext.locale = 'de'
+    @rep.plural('Axis','Axis').should == ['Achse','Achsen']
+  end
+
+  it "has access to the mo repositories pluralisation rule" do
+    FastGettext.locale = 'en'
+    rep = FastGettext::TranslationRepository.build('plural_test',:path=>File.join(current_folder,'..','..','locale'))
+    rep['car'].should == 'Test'#just check it is loaded correctly
+    rep.pluralisation_rule.call(2).should == 3
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,31 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+
+describe 'FastGettext::TranslationRepository::Po' do
+  before do
+    @rep = FastGettext::TranslationRepository.build('test',:path=>File.join(current_folder,'..','..','locale'),:type=>:po)
+    @rep.is_a?(FastGettext::TranslationRepository::Po).should be_true
+  end
+
+  it "can be built" do
+    @rep.available_locales.sort.should == ['de','en']
+  end
+
+  it "can translate" do
+    FastGettext.locale = 'de'
+    @rep['car'].should == 'Auto'
+  end
+
+  it "can pluralize" do
+    FastGettext.locale = 'de'
+    @rep.plural('Axis','Axis').should == ['Achse','Achsen']
+  end
+
+  it "has access to the mo repositories pluralisation rule" do
+    FastGettext.locale = 'en'
+    rep = FastGettext::TranslationRepository.build('plural_test',:path=>File.join(current_folder,'..','..','locale'),:type=>:po)
+    rep['car'].should == 'Test'#just check it is loaded correctly
+    rep.pluralisation_rule.call(2).should == 3
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,61 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','..','spec_helper')
+
+describe 'FastGettext::TranslationRepository::Yaml' do
+  before do
+    @rep = FastGettext::TranslationRepository.build('test', :path => File.join(current_folder,'..', '..', 'locale', 'yaml'), :type => :yaml)
+    @rep.is_a?(FastGettext::TranslationRepository::Yaml).should be_true
+    FastGettext.locale = 'de'
+  end
+
+  it "can be built" do
+    @rep.available_locales.sort.should == ['de', 'en']
+  end
+
+  it "translates nothing when locale is unsupported" do
+    FastGettext.locale = 'xx'
+    @rep['simple'].should == nil
+  end
+
+  it "does not translated categories" do
+    @rep['cars'].should == nil
+  end
+
+  it "can translate simple" do
+    @rep['simple'].should == 'einfach'
+  end
+
+  it "can translate nested" do
+    @rep['cars.car'].should == 'Auto'
+  end
+
+  it "can pluralize" do
+    @rep.plural('cars.axis').should == ['Achse', 'Achsen', nil, nil]
+  end
+
+  it "handles unfound plurals with nil" do
+    @rep.plural('cars.xxx').should == [nil, nil, nil, nil]
+  end
+
+  it "can be used to translate plural forms" do
+    FastGettext.stub!(:current_repository).and_return @rep
+    FastGettext.n_('cars.axis','cars.axis',2).should == 'Achsen'
+    FastGettext.n_('cars.axis',2).should == 'Achsen'
+    FastGettext.n_('cars.axis',1).should == 'Achse'
+  end
+
+  it "can be used to do wanky pluralisation rules" do
+    FastGettext.stub!(:current_repository).and_return @rep
+    4.times do |i|
+      @rep.stub!(:pluralisation_rule).and_return lambda{i}
+      FastGettext.n_('cars.silly',1).should == i.to_s
+    end
+  end
+
+  it "can use custom pluraliztion rules" do
+    FastGettext.locale = 'en'
+    {0 => 0, 1 => 1, 2 => 2, 3 => 0}.each do |input, expected|
+      @rep.pluralisation_rule.call(input).should == expected
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,34 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','spec_helper')
+
+module FastGettext
+  module TranslationRepository
+    class Dummy
+      attr_accessor :name, :options
+      def initialize(name, options)
+        @name = name
+        @options = options
+      end
+    end
+  end
+end
+
+describe FastGettext::TranslationRepository do
+  describe "build" do
+    it "auto requires class by default" do
+      lambda { FastGettext::TranslationRepository.build('xx', { :type => 'invalid'}) }.should raise_error(LoadError)
+    end
+
+    it "can have auto-require disabled" do
+      FastGettext::TranslationRepository.build('xx', { :type => 'dummy' })
+    end
+
+    it "makes a new repository" do
+      options = { :type => 'dummy', :external => true }
+      repo = FastGettext::TranslationRepository.build('xx', options)
+      repo.class.should == FastGettext::TranslationRepository::Dummy
+      repo.name.should == 'xx'
+      repo.options.should == options
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,152 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','spec_helper')
+
+describe FastGettext::Translation do
+  include FastGettext::Translation
+
+  before do
+    default_setup
+  end
+
+  describe "unknown locale" do
+    before do
+      FastGettext.available_locales = nil
+      FastGettext.locale = 'xx'
+    end
+
+    it "does not translate" do
+      _('car').should == 'car'
+    end
+
+    it "does not translate plurals" do
+      n_('car','cars',2).should == 'cars'
+    end
+  end
+
+  describe :_ do
+    it "translates simple text" do
+      _('car').should == 'Auto'
+    end
+
+    it "returns key if not translation was found" do
+      _('NOT|FOUND').should == 'NOT|FOUND'
+    end
+
+    it "does not return the gettext meta information" do
+      _('').should == ''
+    end
+  end
+
+  describe :n_ do
+    before do
+      FastGettext.pluralisation_rule = nil
+    end
+
+    it "translates pluralized" do
+      n_('Axis','Axis',1).should == 'Achse'
+      n_('Axis','Axis',2).should == 'Achsen'
+      n_('Axis','Axis',0).should == 'Achsen'
+    end
+
+    describe "pluralisations rules" do
+      it "supports abstract pluralisation rules" do
+        FastGettext.pluralisation_rule = lambda{|n|2}
+        n_('a','b','c','d',4).should == 'c'
+      end
+
+      it "supports false as singular" do
+        FastGettext.pluralisation_rule = lambda{|n|n!=2}
+        n_('singular','plural','c','d',2).should == 'singular'
+      end
+
+      it "supports true as plural" do
+        FastGettext.pluralisation_rule = lambda{|n|n==2}
+        n_('singular','plural','c','d',2).should == 'plural'
+      end
+    end
+    
+    it "returns the appropriate key if no translation was found" do
+      n_('NOTFOUND','NOTFOUNDs',1).should == 'NOTFOUND'
+      n_('NOTFOUND','NOTFOUNDs',2).should == 'NOTFOUNDs'
+    end
+
+    it "returns the last key when no translation was found and keys where to short" do
+      FastGettext.pluralisation_rule = lambda{|x|4}
+      n_('Apple','Apples',2).should == 'Apples'
+    end
+  end
+
+  describe :s_ do
+    it "translates simple text" do
+      s_('car').should == 'Auto'
+    end
+
+    it "returns cleaned key if a translation was not found" do
+      s_("XXX|not found").should == "not found"
+    end
+
+    it "can use a custom seperator" do
+      s_("XXX/not found",'/').should == "not found"
+    end
+  end
+
+  describe :N_ do
+    it "returns the key" do
+      N_('XXXXX').should == 'XXXXX'
+    end
+  end
+
+  describe :Nn_ do
+    it "returns the keys as array" do
+      Nn_('X','Y').should == ['X','Y']
+    end
+  end
+
+  describe :caching do
+    describe :cache_hit do
+      before do
+        FastGettext.translation_repositories.replace({})
+        #singular cache keys
+        FastGettext.current_cache['xxx'] = '1'
+
+        #plural cache keys
+        FastGettext.current_cache['||||xxx'] = ['1','2']
+        FastGettext.current_cache['||||xxx||||yyy'] = ['1','2']
+      end
+
+      it "uses the cache when translating with _" do
+        _('xxx').should == '1'
+      end
+
+      it "uses the cache when translating with s_" do
+        s_('xxx').should == '1'
+      end
+
+      it "uses the cache when translating with n_" do
+        n_('xxx','yyy',1).should == '1'
+      end
+
+      it "uses the cache when translating with n_ and single argument" do
+        n_('xxx',1).should == '1'
+      end
+    end
+
+    it "caches different locales seperatly" do
+      FastGettext.locale = 'en'
+      _('car').should == 'car'
+      FastGettext.locale = 'de'
+      _('car').should == 'Auto'
+    end
+
+    it "caches different textdomains seperatly" do
+      _('car').should == 'Auto'
+
+      FastGettext.translation_repositories['fake'] = {}
+      FastGettext.text_domain = 'fake'
+      _('car').should == 'car'
+
+      FastGettext.text_domain = 'test'
+      _('car').should == 'Auto'
+    end
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,43 @@
+require File.expand_path("spec_helper", File.dirname(__FILE__))
+
+default_setup
+class IncludeTest
+  include FastGettext::Translation
+  @@xx = _('car')
+  def self.ext
+    _('car')
+  end
+  def inc
+    _('car')
+  end
+  def self.xx
+    @@xx
+  end
+end
+
+describe FastGettext do
+  include FastGettext
+  before :all do
+    default_setup
+  end
+
+  it "provides access to FastGettext::Translations methods" do
+    FastGettext._('car').should == 'Auto'
+    _('car').should == 'Auto'
+    s_("XXX|not found").should == "not found"
+    n_('Axis','Axis',1).should == 'Achse'
+    N_('XXXXX').should == 'XXXXX'
+    Nn_('X','Y').should == ['X','Y']
+  end
+  
+  it "is extended to a class and included into a class" do
+    IncludeTest.ext.should == 'Auto'
+    IncludeTest.ext.should == 'Auto'
+    IncludeTest.new.inc.should == 'Auto'
+    IncludeTest.xx.should == 'Auto'
+  end
+
+  it "has a VERSION" do
+    FastGettext::VERSION.should =~ /^\d+\.\d+\.\d+$/
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,26 @@
+# ---- requirements
+require 'rubygems'
+$LOAD_PATH.unshift File.expand_path("../lib", File.dirname(__FILE__))
+require 'fast_gettext'
+
+# ---- revert to defaults
+Spec::Runner.configure do |config|
+  config.before :all do
+    FastGettext.locale = 'de'
+    FastGettext.available_locales = nil
+  end
+end
+
+# ---- Helpers
+def pending_it(text,&block)
+  it text do
+    pending(&block)
+  end
+end
+
+def default_setup
+  FastGettext.add_text_domain('test',:path=>File.join(File.dirname(__FILE__),'locale'))
+  FastGettext.text_domain = 'test'
+  FastGettext.available_locales = ['en','de']
+  FastGettext.locale = 'de'
+end
 \ No newline at end of file
@@ -0,0 +1,2 @@
+#simulate file not found
+raise LoadError
 \ No newline at end of file
@@ -0,0 +1,27 @@
+current_folder = File.dirname(__FILE__)
+$LOAD_PATH.unshift File.expand_path("../../lib", current_folder)
+
+describe 'Iconv' do
+  it "also works when Iconv was not found locally" do
+    #prepare load path
+    $LOAD_PATH.unshift File.join(current_folder,'fake_load_path')
+    test = 1
+    begin
+      require 'iconv'
+    rescue LoadError
+      test = 2
+    end
+    test.should == 2
+
+    #load fast_gettext
+    require 'fast_gettext'
+
+    FastGettext.add_text_domain('test',:path=>File.join(File.dirname(__FILE__),'..','locale'))
+    FastGettext.text_domain = 'test'
+    FastGettext.available_locales = ['en','de']
+    FastGettext.locale = 'de'
+
+    #translate
+    FastGettext._('car').should == 'Auto'
+  end
+end
 \ No newline at end of file
@@ -0,0 +1,77 @@
+current_folder = File.dirname(__FILE__)
+require File.join(current_folder,'..','spec_helper')
+
+#just to make sure we did not mess up while copying...
+describe String do
+  it "does not translate twice" do
+    ("%{a} %{b}" % {:a=>'%{b}',:b=>'c'}).should == '%{b} c'
+  end
+
+  describe "old % style replacement" do
+    it "substitudes using % + Hash" do
+      ("x%{name}y" %{:name=>'a'}).should == 'xay'
+    end
+
+    it "does not substitute after %%" do
+      ("%%{num} oops" % {:num => 1}).should == '%{num} oops'
+    end
+
+    it "does not substitute when nothing could be found" do
+      ("abc" % {:x=>1}).should == 'abc'
+    end
+
+    if RUBY_VERSION < '1.9' # this does not longer work in 1.9, use :"my weird string"
+      it "sustitutes strings" do
+        ("a%{b}c" % {'b'=>1}).should == 'a1c'
+      end
+
+      it "sustitutes strings with -" do
+        ("a%{b-a}c" % {'b-a'=>1}).should == 'a1c'
+      end
+
+      it "sustitutes string with ." do
+        ("a%{b.a}c" % {'b.a'=>1}).should == 'a1c'
+      end
+
+      it "sustitutes string with number" do
+        ("a%{1}c" % {'1'=>1}).should == 'a1c'
+      end
+    end
+  end
+
+  describe 'old sprintf style' do
+    it "substitudes using % + Array" do
+      ("x%sy%s" % ['a','b']).should == 'xayb'
+    end
+
+    if RUBY_VERSION < '1.9' # this does not longer work in 1.9, ArgumentError is raised
+      it "does not remove %{} style replacements" do
+        ("%{name} x%sy%s" % ['a','b']).should == '%{name} xayb'
+      end
+
+      it "does not remove %<> style replacement" do
+         ("%{name} %<num>f %s" % ['x']).should == "%{name} %<num>f x"
+      end
+    end
+  end
+
+  describe 'ruby 1.9 style %< replacement' do
+    it "does not substitute after %%" do
+      ("%%<num> oops" % {:num => 1}).should == '%<num> oops'
+    end
+
+    it "subsitutes %<something>d" do
+      ("x%<hello>dy" % {:hello=>1}).should == 'x1y'
+    end
+
+    it "substitutes #b" do
+      ("%<num>#b" % {:num => 1}).should == "0b1"
+    end
+  end
+
+  if RUBY_VERSION >= '1.9'
+    it "does not raise when key was not found" do
+      ("%{typo} xxx" % {:something=>1}).should == "%{typo} xxx"
+    end
+  end
+end
 \ No newline at end of file
...	...	@@ -0,0 +1 @@
	1	+../vendor/terceiro-fast_gettext-fe7bb09e30f7b1b5876a3b7a18fe8a254c6f59cb/lib/fast_gettext
0	2	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,6 @@
	1	+0.4.14 -- "" is translated as "", not as gettext meta information
	2	+0.4.0 -- pluralisation_rules is no longer stored in each repository, only retrived. Added Chain and Logger repository.
	3	+0.3.6 -- FastGettext.default_locale=
	4	+0.3.5 -- FastGettext.default_text_domain=
	5	+0.3.4 -- Exceptions are thrown, not returned when translating without text domain
	6	+0.3 -- pluralisation methods accept/return n plural forms, contrary to singular/plural before
0	7	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,196 @@
	1	+FastGettext
	2	+===========
	3	+GetText but 3.5 x faster, 560 x less memory, simple, clean namespace (7 vs 34) and threadsave!
	4	+
	5	+It supports multiple backends (.mo, .po, .yml files, Database(ActiveRecor + any other), Chain, Loggers) and can easily be extended.
	6	+
	7	+[Example Rails application](https://github.com/grosser/gettext_i18n_rails_example)
	8	+
	9	+Comparison
	10	+==========
	11	+<table>
	12	+ <tr>
	13	+ <td></td>
	14	+ <td width="100">Hash</td>
	15	+ <td width="150">FastGettext</td>
	16	+ <td width="100">GetText</td>
	17	+ <td width="100">ActiveSupport I18n::Simple</td>
	18	+ </tr>
	19	+ <tr>
	20	+ <td>Speed*</td>
	21	+ <td>0.82s</td>
	22	+ <td>1.36s</td>
	23	+ <td>4.88s</td>
	24	+ <td>21.77s</td>
	25	+ </tr>
	26	+ <tr>
	27	+ <td>RAM*</td>
	28	+ <td>4K</td>
	29	+ <td>8K</td>
	30	+ <td>4480K</td>
	31	+ <td>10100K</td>
	32	+ </tr>
	33	+ <tr>
	34	+ <td>Included backends</td>
	35	+ <td></td>
	36	+ <td>db, yml, mo, po, logger, chain</td>
	37	+ <td>mo</td>
	38	+ <td>yml</td>
	39	+ </tr>
	40	+</table>
	41	+<small>*50.000 translations with ruby enterprise 1.8.6 through `rake benchmark`</small>
	42	+
	43	+Setup
	44	+=====
	45	+### 1. Install
	46	+ sudo gem install fast_gettext
	47	+
	48	+### 2. Add a translation repository
	49	+
	50	+From mo files (traditional/default)
	51	+ FastGettext.add_text_domain('my_app',:path=>'locale')
	52	+
	53	+Or po files (less maintenance than mo)
	54	+ FastGettext.add_text_domain('my_app',:path=>'locale', :type=>:po)
	55	+
	56	+Or yaml files (use I18n syntax/indentation)
	57	+ FastGettext.add_text_domain('my_app',:path=>'config/locales', :type=>:yaml)
	58	+
	59	+Or database (scaleable, good for many locales/translators)
	60	+ # db access is cached <-> only first lookup hits the db
	61	+ require "fast_gettext/translation_repository/db"
	62	+ include FastGettext::TranslationRepository::Db.require_models #load and include default models
	63	+ FastGettext.add_text_domain('my_app', :type=>:db, :model=>TranslationKey)
	64	+
	65	+### 3. Choose text domain and locale for translation
	66	+Do this once in every Thread. (e.g. Rails -> ApplicationController)
	67	+ FastGettext.text_domain = 'my_app'
	68	+ FastGettext.available_locales = ['de','en','fr','en_US','en_UK'] # only allow these locales to be set (optional)
	69	+ FastGettext.locale = 'de'
	70	+
	71	+### 4. Start translating
	72	+ include FastGettext::Translation
	73	+ _('Car') == 'Auto'
	74	+ _('not-found') == 'not-found'
	75	+ s_('Namespace\|no-found') == 'not-found'
	76	+ n_('Axis','Axis',3) == 'Achsen' #German plural of Axis
	77	+
	78	+
	79	+Managing translations
	80	+============
	81	+### mo/po-files
	82	+Generate .po or .mo files using GetText parser (example tasks at [gettext_i18n_rails](http://github.com/grosser/gettext_i18n_rails))
	83	+
	84	+Tell Gettext where your .mo or .po files lie, e.g. for locale/de/my_app.po and locale/de/LC_MESSAGES/my_app.mo
	85	+ FastGettext.add_text_domain('my_app',:path=>'locale')
	86	+
	87	+Use the [original GetText](http://github.com/mutoh/gettext) to create and manage po/mo-files.
	88	+(Work on a po/mo parser & reader that is easier to use has started, contributions welcome @ [pomo](http://github.com/grosser/pomo) )
	89	+
	90	+###Database
	91	+[Example migration for ActiveRecord](http://github.com/grosser/fast_gettext/blob/master/examples/db/migration.rb)
	92	+The default plural seperator is `\|\|\|\|` but you may overwrite it (or suggest a better one..).
	93	+
	94	+This is usable with any model DataMapper/Sequel or any other(non-database) backend, the only thing you need to do is respond to the self.translation(key, locale) call.
	95	+If you want to use your own models, have a look at the [default models](http://github.com/grosser/fast_gettext/tree/master/lib/fast_gettext/translation_repository/db_models) to see what you want/need to implement.
	96	+
	97	+To manage translations via a Web GUI, use a [Rails application and the translation_db_engine](http://github.com/grosser/translation_db_engine)
	98	+
	99	+Rails
	100	+=======================
	101	+Try the [gettext_i18n_rails plugin](http://github.com/grosser/gettext_i18n_rails), it simplifies the setup.
	102	+Try the [translation_db_engine](http://github.com/grosser/translation_db_engine), to manage your translations in a db.
	103	+
	104	+Setting `available_locales`,`text_domain` or `locale` will not work inside the `evironment.rb`,
	105	+since it runs in a different thread then e.g. controllers, so set them inside your application_controller.
	106	+
	107	+ #environment.rb after initializers
	108	+ Object.send(:include,FastGettext::Translation)
	109	+ FastGettext.add_text_domain('accounting',:path=>'locale')
	110	+ FastGettext.add_text_domain('frontend',:path=>'locale')
	111	+ ...
	112	+
	113	+ #application_controller.rb
	114	+ class ApplicationController ...
	115	+ include FastGettext::Translation
	116	+ before_filter :set_locale
	117	+ def set_locale
	118	+ FastGettext.available_locales = ['de','en',...]
	119	+ FastGettext.text_domain = 'frontend'
	120	+ session[:locale] = I18n.locale = FastGettext.set_locale(params[:locale] \|\| session[:locale] \|\| request.env['HTTP_ACCEPT_LANGUAGE'] \|\| 'en')
	121	+ end
	122	+
	123	+
	124	+Advanced features
	125	+=================
	126	+###Abnormal pluralisation
	127	+Pluralisation rules can be set directly via a lambda (see specs/), or by using the Gettext
	128	+plural definition (see spec/locale/en/test_plural.po or [Plural expressions for all languages](http://translate.sourceforge.net/wiki/l10n/pluralforms).
	129	+
	130	+
	131	+###default_text_domain
	132	+If you only use one text domain, setting `FastGettext.default_text_domain = 'app'`
	133	+is sufficient and no more `text_domain=` is needed
	134	+
	135	+###default_locale
	136	+If the simple rule of "first `availble_locale` or 'en'" is not suficcient for you, set `FastGettext.default_locale = 'de'`.
	137	+
	138	+###default_available_locales
	139	+Fallback when no available_locales are set
	140	+
	141	+###Chains
	142	+You can use any number of repositories to find a translation. Simply add them to a chain and when
	143	+the first cannot translate a given key, the next is asked and so forth.
	144	+ repos = [
	145	+ FastGettext::TranslationRepository.build('new', :path=>'....'),
	146	+ FastGettext::TranslationRepository.build('old', :path=>'....')
	147	+ ]
	148	+ FastGettext.add_text_domain 'combined', :type=>:chain, :chain=>repos
	149	+
	150	+###Logger
	151	+When you want to know which keys could not be translated or were used, add a Logger to a Chain:
	152	+ repos = [
	153	+ FastGettext::TranslationRepository.build('app', :path=>'....')
	154	+ FastGettext::TranslationRepository.build('logger', :type=>:logger, :callback=>lamda{\|key_or_array_of_ids\| ... }),
	155	+ }
	156	+ FastGettext.add_text_domain 'combined', :type=>:chain, :chain=>repos
	157	+If the Logger is in position #1 it will see all translations, if it is in position #2 it will only see the unfound.
	158	+Unfound may not always mean missing, if you chose not to translate a word because the key is a good translation, it will appear nevertheless.
	159	+A lambda or anything that responds to `call` will do as callback. A good starting point may be `examples/missing_translations_logger.rb`.
	160	+
	161	+###Plugins
	162	+Want a xml version ?
	163	+Write your own TranslationRepository!
	164	+ #fast_gettext/translation_repository/xxx.rb
	165	+ module FastGettext
	166	+ module TranslationRepository
	167	+ class Wtf
	168	+ define initialize(name,options), [key], plural(*keys) and
	169	+ either inherit from TranslationRepository::Base or define available_locales and pluralisation_rule
	170	+ end
	171	+ end
	172	+ end
	173	+
	174	+
	175	+FAQ
	176	+===
	177	+ - [Problems with ActiveRecord messages?](http://wiki.github.com/grosser/fast_gettext/activerecord)
	178	+
	179	+
	180	+TODO
	181	+====
	182	+ - YML backend that reads ActiveSupport::I18n files
	183	+ - any ideas ? :D
	184	+
	185	+Author
	186	+======
	187	+Mo/Po-file parsing from Masao Mutoh, see vendor/README
	188	+
	189	+###Contributors
	190	+ - [geekq](http://www.innoq.com/blog/vd)
	191	+ - [Matt Sanford](http://blog.mzsanford.com)
	192	+ - Rudolf Gavlas
	193	+
	194	+[Michael Grosser](http://pragmatig.wordpress.com)
	195	+grosser.michael@gmail.com
	196	+Hereby placed under public domain, do what you want, just do not hold me accountable...
...	...
...	...	@@ -0,0 +1,32 @@
	1	+task :default => :spec
	2	+require 'spec/rake/spectask'
	3	+Spec::Rake::SpecTask.new {\|t\| t.spec_opts = ['--color']}
	4	+
	5	+task :benchmark do
	6	+ puts "Running on #{RUBY}"
	7	+ %w[baseline ideal fast_gettext original i18n_simple].each do \|bench\|
	8	+ puts `ruby benchmark/#{bench}.rb`
	9	+ puts ""
	10	+ end
	11	+end
	12	+
	13	+task :namespaces do
	14	+ puts `ruby benchmark/namespace/original.rb`
	15	+ puts `ruby benchmark/namespace/fast_gettext.rb`
	16	+end
	17	+
	18	+begin
	19	+ require 'jeweler'
	20	+ project_name = 'fast_gettext'
	21	+ Jeweler::Tasks.new do \|gem\|
	22	+ gem.name = project_name
	23	+ gem.summary = "A simple, fast and threadsafe implementation of GetText"
	24	+ gem.email = "grosser.michael@gmail.com"
	25	+ gem.homepage = "http://github.com/grosser/#{project_name}"
	26	+ gem.authors = ["Michael Grosser"]
	27	+ end
	28	+
	29	+ Jeweler::GemcutterTasks.new
	30	+rescue LoadError
	31	+ puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install jeweler"
	32	+end
0	33	\ No newline at end of file
...	...
...	...	@@ -0,0 +1 @@
	1	+lib/fast_gettext/VERSION
0	2	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,42 @@
	1	+require 'rubygems'
	2	+require 'benchmark'
	3	+
	4	+RUNS = 50_0000
	5	+DEFAULTS = {:memory=>0}
	6	+
	7	+def locale_folder(domain)
	8	+ path = case domain
	9	+ when 'test' then File.join(File.expand_path(File.dirname(__FILE__)),'..','spec','locale')
	10	+ when 'large' then File.join(File.expand_path(File.dirname(__FILE__)),'locale')
	11	+ end
	12	+
	13	+ mo = File.join(path,'de','LC_MESSAGES',"#{domain}.mo")
	14	+ raise unless File.exist?(mo)
	15	+ path
	16	+end
	17	+
	18	+def results_test(&block)
	19	+ print "#{(result(&block)).to_s.strip.split(' ').first}s / #{memory}K <-> "
	20	+end
	21	+
	22	+def results_large
	23	+ print "#{(result {_('login') == 'anmelden'}).to_s.strip.split(' ').first}s / #{memory}K"
	24	+ puts ""
	25	+end
	26	+
	27	+def result
	28	+ result =Benchmark.measure do
	29	+ RUNS.times do
	30	+ raise "not translated" unless yield
	31	+ end
	32	+ end
	33	+ result
	34	+end
	35	+
	36	+def memory
	37	+ pid = Process.pid
	38	+ map = `pmap -d #{pid}`
	39	+ map.split("\n").last.strip.squeeze(' ').split(' ')[3].to_i - DEFAULTS[:memory]
	40	+end
	41	+
	42	+DEFAULTS[:memory] = memory + 4 #4 => 0 for base calls
0	43	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,5 @@
	1	+require 'benchmark/base'
	2	+
	3	+puts "Baseline: (doing nothing in a loop)"
	4	+results_test{true}
	5	+puts ""
0	6	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,18 @@
	1	+require 'benchmark/base'
	2	+
	3	+$LOAD_PATH.unshift 'lib'
	4	+require 'fast_gettext'
	5	+include FastGettext::Translation
	6	+
	7	+FastGettext.available_locales = ['de','en']
	8	+FastGettext.locale = 'de'
	9	+
	10	+puts "FastGettext:"
	11	+FastGettext.add_text_domain('test',:path=>locale_folder('test'))
	12	+FastGettext.text_domain = 'test'
	13	+results_test{_('car') == 'Auto'}
	14	+
	15	+#i cannot add the large file, since its an internal applications mo file
	16	+FastGettext.add_text_domain('large',:path=>locale_folder('large'))
	17	+FastGettext.text_domain = 'large'
	18	+results_large
0	19	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,7 @@
	1	+require 'benchmark/base'
	2	+require 'activesupport'
	3	+I18n.backend = I18n::Backend::Simple.new
	4	+I18n.load_path = ['benchmark/locale/de.yml']
	5	+I18n.locale = :de
	6	+puts "ActiveSupport I18n::Backend::Simple :"
	7	+results_test{I18n.translate('activerecord.models.car')=='Auto'}
0	8	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,24 @@
	1	+require 'benchmark/base'
	2	+
	3	+$LOAD_PATH.unshift 'lib'
	4	+
	5	+module FastestGettext
	6	+ def set_domain(folder,domain,locale)
	7	+ @data = {}
	8	+ require 'fast_gettext/vendor/mofile'
	9	+ FastGettext::GetText::MOFile.open(File.join(folder,locale,'LC_MESSAGES',"#{domain}.mo"), "UTF-8").each{\|k,v\|@data[k]=v}
	10	+ end
	11	+ def _(word)
	12	+ @data[word]
	13	+ end
	14	+end
	15	+
	16	+
	17	+include FastestGettext
	18	+set_domain(locale_folder('test'),'test','de')
	19	+puts "Ideal: (primitive Hash lookup)"
	20	+results_test{_('car') == 'Auto'}
	21	+
	22	+#i cannot add the large file, since its an internal applications mo file
	23	+set_domain(locale_folder('large'),'large','de')
	24	+results_large
...	...