gettext_i18n_rails 0.1.0

data/README.markdown

@@ -0,0 +1,139 @@
+Simple [FastGettext](http://github.com/grosser/fast_gettext) / Rails integration.
+
+Do all translations you want with FastGettext, use any other I18n backend as extension/fallback.
+
+Rails does: `I18n.t('weir.rails.syntax.i.hate')`  
+We do: `_('Just translate my damn text!')`  
+To use I18n calls define a `weir.rails.syntax.i.hate` translation.  
+
+[See it working in the example application.](https://github.com/grosser/gettext_i18n_rails_example)
+
+Setup
+=====
+###Installation
+As plugin: `  script/plugin install git://github.com/grosser/gettext_i18n_rails.git  `
+Or Gem: ` sudo gem install gettext_i18n_rails `
+
+[FastGettext](http://github.com/grosser/fast_gettext): `  sudo gem install fast_gettext  `
+
+### Want to find used messages in your ruby files ?
+GetText 1.93 or GetText 2.0: `  sudo gem install gettext  `  
+GetText 2.0 will render 1.93 unusable, so only install if you do not have apps that use 1.93!
+
+`  sudo gem install ruby_parser  `
+
+### Locales & initialisation
+Copy default locales with dates/sentence-connectors/AR-errors you want from e.g.
+[rails i18n](http://github.com/svenfuchs/rails-i18n/tree/master/rails/locale/) into 'config/locales'
+
+    #environment.rb
+    Rails::Initializer.run do |config|
+      ...
+      config.gem "fast_gettext", :version => '~>0.4.17'
+      #only used for mo/po file generation in development, !do not load(:lib=>false), will needlessly eat ram!
+      config.gem "gettext", :lib => false, :version => '>=1.9.3'
+    end
+
+    #config/initialisers/fast_gettext.rb
+    FastGettext.add_text_domain 'app', :path => 'locale'
+    FastGettext.default_available_locales = ['en','de'] #all you want to allow
+    FastGettext.default_text_domain = 'app'
+
+    #application_controller
+    class ApplicationController < ...
+      before_filter :set_gettext_locale
+
+Translating
+===========
+###Getting started
+####Option A: Traditional mo/po files
+ - use some _('translations')
+ - run `rake gettext:find`, to let GetText find all translations used
+ - (optional) run `rake gettext:store_model_attributes`, to parse the database for columns that can be translated
+ - if this is your first translation: `cp locale/app.pot locale/de/app.po` for every locale you want to use
+ - translate messages in 'locale/de/app.po' (leave msgstr blank and msgstr == msgid)  
+new translations will be marked "fuzzy", search for this and remove it, so that they will be used.
+Obsolete translations are marked with ~#, they usually can be removed since they are no longer needed
+ - run `rake gettext:pack` to write GetText format translation files
+
+####Option B: Database
+This is the most scalable method, since all translators can work simultanousely and online.
+
+Most easy to use with the [translation database Rails engine](http://github.com/grosser/translation_db_engine).
+FastGettext setup would look like:
+    include FastGettext::TranslationRepository::Db.require_models #load and include default models
+    FastGettext.add_text_domain 'app', :type=>:db, :model=>TranslationKey
+Translations can be edited under `/translation_keys`
+
+###I18n
+
+    I18n.locale <==> FastGettext.locale.to_sym
+    I18n.locale = :de <==> FastGettext.locale = 'de'
+
+Any call to I18n that matches a gettext key will be translated through FastGettext.
+
+Namespaces
+==========
+Car|Model means Model in namespace Car.  
+You do not have to translate this into english "Model", if you use the
+namespace-aware translation
+    s_('Car|Model') == 'Model' #when no translation was found
+
+ActiveRecord - error messages
+=============================
+ActiveRecord error messages are translated through Rails::I18n, but
+model names and model attributes are translated through FastGettext.
+Therefore a validation error on a BigCar's wheels_size needs `_('big car')` and `_('BigCar|Wheels size')`
+to display localized.
+
+The model/attribute translations can be found through `rake gettext:store_model_attributes`,
+(which ignores some commonly untranslated columns like id,type,xxx_count,...).
+
+Error messages can be translated through FastGettext, if the ':message' is a translation-id or the matching Rails I18n key is translated.
+In any other case they go through the SimpleBackend.
+
+####Option A:
+Define a translation for "I need my rating!" and use it as message.
+    validates_inclusion_of :rating, :in=>1..5, :message=>N_('I need my rating!')
+
+####Option B:
+Do not use :message
+    validates_inclusion_of :rating, :in=>1..5
+and make a translation for the I18n key: `activerecord.errors.models.rating.attributes.rating.inclusion`
+
+####Option C:
+Add a translation to each config/locales/*.yml files
+    en:
+      activerecord:
+        errors:
+          models:
+            rating:
+              attributes:
+                rating:
+                  inclusion: " -- please choose!"
+The [rails I18n guide](http://guides.rubyonrails.org/i18n.html) can help with Option B and C.
+
+Plurals
+=======
+FastGettext supports pluralization
+    n_('Apple','Apples',3) == 'Apples'
+
+Unfound translations
+====================
+Sometimes translations like `_("x"+"u")` cannot be fond. You have 4 options:
+
+ - add `N_('xu')` somewhere else in the code, so the parser sees it
+ - add `N_('xu')` in a totally seperate file like `locale/unfound_translations.rb`, so the parser sees it
+ - use the [gettext_test_log rails plugin ](http://github.com/grosser/gettext_test_log) to find all translations that where used while testing
+ - add a Logger to a translation Chain, so every unfound translations is logged ([example]((http://github.com/grosser/fast_gettext)))
+
+
+Contributors
+======
+ - [ruby gettext extractor](http://github.com/retoo/ruby_gettext_extractor/tree/master) from [retoo](http://github.com/retoo)
+ - [Paul McMahon](http://github.com/pwim)
+ - [Duncan Mac-Vicar P](http://duncan.mac-vicar.com/blog/)
+
+[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...  

data/Rakefile

@@ -0,0 +1,32 @@
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+task :default do
+  # test with 2.x
+  puts `VERSION='~>2' rake spec RSPEC_COLOR=1`
+
+  # gem 'activerecord', '>=3' did not work for me, but just require gets the right version...
+  require 'active_record'
+  if ActiveRecord::VERSION::MAJOR >= 3
+    puts `rake spec RSPEC_COLOR=1`
+  else
+    'install rails 3 to get full test coverage...'
+  end
+end
+
+begin
+  require 'jeweler'
+  project_name = 'gettext_i18n_rails'
+  Jeweler::Tasks.new do |gem|
+    gem.name = project_name
+    gem.summary = "Simple FastGettext Rails integration."
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+    gem.add_dependency 'fast_gettext'
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/gettext_i18n_rails.gemspec

@@ -0,0 +1,64 @@
+# 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{gettext_i18n_rails}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2010-05-23}
+  s.email = %q{grosser.michael@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "gettext_i18n_rails.gemspec",
+     "lib/gettext_i18n_rails.rb",
+     "lib/gettext_i18n_rails/action_controller.rb",
+     "lib/gettext_i18n_rails/active_record.rb",
+     "lib/gettext_i18n_rails/backend.rb",
+     "lib/gettext_i18n_rails/haml_parser.rb",
+     "lib/gettext_i18n_rails/i18n_hacks.rb",
+     "lib/gettext_i18n_rails/model_attributes_finder.rb",
+     "lib/gettext_i18n_rails/ruby_gettext_extractor.rb",
+     "lib/tasks/gettext_rails_i18n.rake",
+     "rails/init.rb",
+     "spec/gettext_i18n_rails/action_controller_spec.rb",
+     "spec/gettext_i18n_rails/active_record_spec.rb",
+     "spec/gettext_i18n_rails/backend_spec.rb",
+     "spec/gettext_i18n_rails_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/grosser/gettext_i18n_rails}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Simple FastGettext Rails integration.}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/gettext_i18n_rails/active_record_spec.rb",
+     "spec/gettext_i18n_rails/backend_spec.rb",
+     "spec/gettext_i18n_rails/action_controller_spec.rb",
+     "spec/gettext_i18n_rails_spec.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
+      s.add_runtime_dependency(%q<fast_gettext>, [">= 0"])
+    else
+      s.add_dependency(%q<fast_gettext>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<fast_gettext>, [">= 0"])
+  end
+end
+

data/lib/gettext_i18n_rails.rb

@@ -0,0 +1,21 @@
+module GettextI18nRails
+  VERSION = File.read( File.join(File.dirname(__FILE__),'..','VERSION') ).strip
+  
+  extend self
+end
+
+begin
+  gem 'fast_gettext', '>=0.4.8'
+rescue LoadError
+  gem 'grosser-fast_gettext', '>=0.4.8'
+end
+
+# include translations into all the places it needs to go...
+Object.send(:include,FastGettext::Translation)
+
+require 'gettext_i18n_rails/backend'
+I18n.backend = GettextI18nRails::Backend.new
+
+require 'gettext_i18n_rails/i18n_hacks'
+require 'gettext_i18n_rails/active_record'
+require 'gettext_i18n_rails/action_controller'

data/lib/gettext_i18n_rails/action_controller.rb

@@ -0,0 +1,6 @@
+class ActionController::Base
+  def set_gettext_locale
+    requested_locale = params[:locale] || session[:locale] || cookies[:locale] ||  request.env['HTTP_ACCEPT_LANGUAGE']
+    session[:locale] = FastGettext.set_locale(requested_locale)
+  end
+end

data/lib/gettext_i18n_rails/active_record.rb

@@ -0,0 +1,17 @@
+class ActiveRecord::Base
+  # CarDealer.sales_count -> s_('CarDealer|Sales count') -> 'Sales count' if no translation was found
+  def self.human_attribute_name(attribute, *args)
+    s_(gettext_translation_for_attribute_name(attribute))
+  end
+
+  # CarDealer -> _('car dealer')
+  def self.human_name(*args)
+    _(self.to_s.underscore.gsub('_',' '))
+  end
+
+  private
+
+  def self.gettext_translation_for_attribute_name(attribute)
+    "#{self}|#{attribute.to_s.gsub('_',' ').capitalize}"
+  end
+end

data/lib/gettext_i18n_rails/backend.rb

@@ -0,0 +1,47 @@
+module GettextI18nRails
+  #translates i18n calls to gettext calls
+  class Backend
+    @@translate_defaults = true
+    cattr_accessor :translate_defaults
+    attr_accessor :backend
+
+    def initialize(*args)
+      self.backend = I18n::Backend::Simple.new(*args)
+    end
+
+    def available_locales
+      FastGettext.available_locales || []
+    end
+
+    def translate(locale, key, options)
+      flat_key = flatten_key key, options
+      if FastGettext.key_exist?(flat_key)
+        raise "no yet build..." if options[:locale]
+        _(flat_key)
+      else
+        if self.class.translate_defaults
+          [*options[:default]].each do |default|
+            #try the more specific key first e.g. 'activerecord.errors.my custom message'
+            flat_key = flatten_key default, options
+            return FastGettext._(flat_key) if FastGettext.key_exist?(flat_key)
+
+            #try the short key thereafter e.g. 'my custom message'
+            return FastGettext._(default) if FastGettext.key_exist?(default)
+          end
+        end
+        backend.translate locale, key, options
+      end
+    end
+
+    def method_missing(method, *args)
+      backend.send(method, *args)
+    end
+
+    protected
+
+    def flatten_key key, options
+      scope = [*(options[:scope] || [])]
+      scope.empty? ? key.to_s : "#{scope*'.'}.#{key}"
+    end
+  end
+end

data/lib/gettext_i18n_rails/haml_parser.rb

@@ -0,0 +1,43 @@
+require 'gettext/utils'
+begin
+  require 'gettext/tools/rgettext'
+rescue LoadError #version prior to 2.0
+  require 'gettext/rgettext'
+end
+
+module GettextI18nRails
+  module HamlParser
+    module_function
+
+    def target?(file)
+      File.extname(file) == '.haml'
+    end
+
+    def parse(file, msgids = [])
+      return msgids unless load_haml
+      require 'gettext_i18n_rails/ruby_gettext_extractor'
+
+      text = IO.readlines(file).join
+
+      haml = Haml::Engine.new(text)
+      code = haml.precompiled
+      return RubyGettextExtractor.parse_string(code, file, msgids)
+    end
+
+    def load_haml
+      return true if @haml_loaded
+      begin
+        require "#{RAILS_ROOT}/vendor/plugins/haml/lib/haml"
+      rescue LoadError
+        begin
+          require 'haml'  # From gem
+        rescue LoadError
+          puts "A haml file was found, but haml library could not be found, so nothing will be parsed..."
+          return false
+        end
+      end
+      @haml_loaded = true
+    end
+  end
+end
+GetText::RGetText.add_parser(GettextI18nRails::HamlParser)

data/lib/gettext_i18n_rails/i18n_hacks.rb

@@ -0,0 +1,10 @@
+module I18n
+  module_function
+  # this is not chainable, since FastGettext may reject this locale!
+  def locale=(new_locale)
+    FastGettext.locale = new_locale
+  end
+  def locale
+    FastGettext.locale.to_sym
+  end
+end

data/lib/gettext_i18n_rails/model_attributes_finder.rb

@@ -0,0 +1,46 @@
+module GettextI18nRails
+  #write all found models/columns to a file where GetTexts ruby parser can find them
+  def store_model_attributes(options)
+    file = options[:to] || 'locale/model_attributes.rb'
+    File.open(file,'w') do |f|
+      f.puts "#DO NOT MODIFY! AUTOMATICALLY GENERATED FILE!"
+      ModelAttributesFinder.new.find(options).each do |table_name,column_names|
+        #model name
+        model = table_name.singularize.camelcase.constantize
+        f.puts("_('#{model.to_s.underscore.gsub('_',' ')}')") #!Keep in sync with ActiveRecord::Base.human_name
+        
+        #all columns namespaced under the model
+        column_names.each do |attribute|
+          translation = model.gettext_translation_for_attribute_name(attribute)
+          f.puts("_('#{translation}')")
+        end
+      end
+      f.puts "#DO NOT MODIFY! AUTOMATICALLY GENERATED FILE!"
+    end
+  end
+
+  class ModelAttributesFinder
+    # options:
+    #   :ignore_tables => ['cars',/_settings$/,...]
+    #   :ignore_columns => ['id',/_id$/,...]
+    # current connection ---> {'cars'=>['model_name','type'],...}
+    def find(options)
+      found = Hash.new([])
+
+      connection = ActiveRecord::Base.connection
+      connection.tables.each do |table_name|
+        next if ignored?(table_name,options[:ignore_tables])
+        connection.columns(table_name).each do |column|
+          found[table_name] += [column.name] unless ignored?(column.name,options[:ignore_columns])
+        end
+      end
+
+      found
+    end
+
+    def ignored?(name,patterns)
+      return false unless patterns
+      patterns.detect{|p|p.to_s==name.to_s or (p.is_a?(Regexp) and name=~p)}
+    end
+  end
+end

data/lib/gettext_i18n_rails/ruby_gettext_extractor.rb

@@ -0,0 +1,136 @@
+# new ruby parser from retoo, that should help extracting "#{_('xxx')}", which is needed especially when parsing haml files
+#
+#!/usr/bin/ruby
+# parser/ruby.rb - look for gettext msg strings in ruby files
+# Copyright (C) 2009 Reto Schüttel <reto (ät) schuettel (dot) ch>
+# You may redistribute it and/or modify it under the same license terms as Ruby.
+
+require 'rubygems'
+require 'ruby_parser'
+
+module RubyGettextExtractor
+  extend self
+
+  def parse(file, targets = [])  # :nodoc:
+    content = File.read(file)
+    parse_string(content, file, targets)
+  end
+
+  def parse_string(content, file, targets=[])
+    # file is just for information in error messages
+    parser = Extractor.new(file, targets)
+    parser.run(content)
+  end
+
+  def target?(file)  # :nodoc:
+    return file =~ /\.rb$/
+  end
+
+  class Extractor < RubyParser
+    def initialize(filename, targets)
+      @filename = filename
+      @targets = Hash.new
+      @results = []
+
+      targets.each do |a|
+        k, v = a
+        # things go wrong if k already exists, but this
+        # should not happen (according to the gettext doc)
+        @targets[k] = a
+        @results << a
+      end
+
+      super()
+    end
+
+    def run(content)
+      self.parse(content)
+      return @results
+    end
+
+    def extract_string(node)
+      if node.first == :str
+        return node.last
+      elsif node.first == :call
+        type, recv, meth, args = node
+
+        # node has to be in form of "string"+("other_string")
+        return nil unless recv && meth == :+
+
+        # descent recurrsivly to determine the 'receiver' of the string concatination
+        # "foo" + "bar" + baz" is
+        # ("foo".+("bar")).+("baz")
+        first_part = extract_string(recv)
+
+        if args.first == :arglist && args.size == 2
+          second_part = extract_string(args.last)
+
+          return nil if second_part.nil?
+
+          return first_part.to_s + second_part.to_s
+        else
+          raise "uuh?"
+        end
+      else
+        return nil
+      end
+    end
+
+    def extract_key(args, seperator)
+      key = nil
+      if args.size == 2
+        key = extract_string(args.value)
+      else
+        # this could be n_("aaa","aaa2",1)
+        # all strings arguemnts are extracted and joined with \004 or \000
+
+        arguments = args[1..(-1)]
+
+        res = []
+        arguments.each do |a|
+          str = extract_string(a)
+          # only add strings
+          res << str if str
+        end
+
+        return nil if res.empty?
+        key = res.join(seperator)
+      end
+
+      return nil unless key
+
+      key.gsub!("\n", '\n')
+      key.gsub!("\t", '\t')
+      key.gsub!("\0", '\0')
+
+      return key
+    end
+
+    def new_call recv, meth, args = nil
+      # we dont care if the method is called on a a object
+      if recv.nil?
+        if (meth == :_ || meth == :p_ || meth == :N_ || meth == :pgettext)
+          key = extract_key(args, "\004")
+        elsif meth == :n_
+          key = extract_key(args, "\000")
+        else
+          # skip
+        end
+
+        if key
+          res = @targets[key]
+
+          unless res
+            res = [key]
+            @results << res
+            @targets[key] = res
+          end
+
+          res << "#{@filename}:#{lexer.lineno}"
+        end
+      end
+
+      super recv, meth, args
+    end
+  end
+end

data/lib/tasks/gettext_rails_i18n.rake

@@ -0,0 +1,74 @@
+namespace :gettext do
+  def load_gettext
+    require 'gettext'
+    require 'gettext/utils'
+  end
+
+  desc "Create mo-files for L10n"
+  task :pack do
+    load_gettext
+    GetText.create_mofiles(true, "locale", "locale")
+  end
+
+  desc "Update pot/po files."
+  task :find do
+    load_gettext
+    $LOAD_PATH << File.join(File.dirname(__FILE__),'..','..','lib')
+    require 'gettext_i18n_rails/haml_parser'
+
+    if GetText.respond_to? :update_pofiles_org
+      GetText.update_pofiles_org(
+        "app",
+        Dir.glob("{app,lib,config,locale}/**/*.{rb,erb,haml}"),
+        "version 0.0.1",
+        :po_root => 'locale',
+        :msgmerge=>['--sort-output']
+      )
+    else #we are on a version < 2.0
+      puts "install new GetText with gettext:install to gain more features..."
+      #kill ar parser...
+      require 'gettext/parser/active_record'
+      module GetText
+        module ActiveRecordParser
+          module_function
+          def init(x);end
+        end
+      end
+
+      #parse files.. (models are simply parsed as ruby files)
+      GetText.update_pofiles(
+        "app",
+        Dir.glob("{app,lib,config,locale}/**/*.{rb,erb,haml}"),
+        "version 0.0.1",
+        'locale'
+      )
+    end
+  end
+
+  # This is more of an example, ignoring
+  # the columns/tables that mostly do not need translation.
+  # This can also be done with GetText::ActiveRecord
+  # but this crashed too often for me, and
+  # IMO which column should/should-not be translated does not
+  # belong into the model
+  #
+  # You can get your translations from GetText::ActiveRecord
+  # by adding this to you gettext:find task
+  #
+  # require 'active_record'
+  # gem "gettext_activerecord", '>=0.1.0' #download and install from github
+  # require 'gettext_activerecord/parser'
+  desc "write the locale/model_attributes.rb"
+  task :store_model_attributes => :environment do
+    FastGettext.silence_errors
+    require 'gettext_i18n_rails/model_attributes_finder'
+    storage_file = 'locale/model_attributes.rb'
+    puts "writing model translations to: #{storage_file}"
+    ignore_tables = [/^sitemap_/, /_versions$/, 'schema_migrations', 'sessions']
+    GettextI18nRails.store_model_attributes(
+      :to => storage_file,
+      :ignore_columns => [/_id$/, 'id', 'type', 'created_at', 'updated_at'],
+      :ignore_tables => ignore_tables
+    )
+  end
+end

data/rails/init.rb

@@ -0,0 +1,10 @@
+begin
+  require 'config/initializers/session_store'
+rescue LoadError
+  # weird bug, when run with rake rails reports error that session
+  # store is not configured, this fixes it somewhat...
+end
+
+#requires fast_gettext to be present.
+#We give rails a chance to install it using rake gems:install, by loading it later.
+config.after_initialize { require 'gettext_i18n_rails' }

data/spec/gettext_i18n_rails/action_controller_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path("../spec_helper", File.dirname(__FILE__))
+
+FastGettext.silence_errors
+
+describe ActionController::Base do
+  before do
+    #controller
+    @c = ActionController::Base.new
+    fake_session = {}
+    @c.stub!(:session).and_return fake_session
+    fake_cookies = {}
+    @c.stub!(:cookies).and_return fake_cookies
+    @c.params = {}
+    @c.request = stub(:env => {})
+
+    #locale
+    FastGettext.available_locales = nil
+    FastGettext.locale = 'fr'
+    FastGettext.available_locales = ['fr','en']
+  end
+
+  it "changes the locale" do
+    @c.params = {:locale=>'en'}
+    @c.set_gettext_locale
+    @c.session[:locale].should == 'en'
+    FastGettext.locale.should == 'en'
+  end
+
+  it "stays with default locale when none was found" do
+    @c.set_gettext_locale
+    @c.session[:locale].should == 'fr'
+    FastGettext.locale.should == 'fr'
+  end
+
+  it "reads the locale from the HTTP_ACCEPT_LANGUAGE" do
+    @c.request.stub!(:env).and_return 'HTTP_ACCEPT_LANGUAGE'=>'de-de,de;q=0.8,en-us;q=0.5,en;q=0.3'
+    @c.set_gettext_locale
+    FastGettext.locale.should == 'en'
+  end
+end

data/spec/gettext_i18n_rails/active_record_spec.rb

@@ -0,0 +1,52 @@
+# coding: utf-8
+require File.expand_path("../spec_helper", File.dirname(__FILE__))
+
+FastGettext.silence_errors
+
+ActiveRecord::Base.establish_connection({
+  :adapter => "sqlite3",
+  :database => ":memory:",
+})
+
+ActiveRecord::Schema.define(:version => 1) do
+  create_table :car_seats, :force=>true do |t|
+    t.string :seat_color
+  end
+end
+
+class CarSeat < ActiveRecord::Base
+  validates_presence_of :seat_color, :message=>"translate me"
+end
+
+describe ActiveRecord::Base do
+  before do
+    FastGettext.current_cache = {}
+  end
+
+  it "has a human name that is translated through FastGettext" do
+    CarSeat.should_receive(:_).with('car seat').and_return('Autositz')
+    CarSeat.human_name.should == 'Autositz'
+  end
+
+  it "translates attributes through FastGettext" do
+    CarSeat.should_receive(:s_).with('CarSeat|Seat color').and_return('Sitz farbe')
+    CarSeat.human_attribute_name(:seat_color).should == 'Sitz farbe'
+  end
+
+  it "translates error messages" do
+    FastGettext.stub!(:current_repository).and_return('translate me'=>"Übersetz mich!")
+    FastGettext._('translate me').should == "Übersetz mich!"
+    c = CarSeat.new
+    c.valid?
+    c.errors.on(:seat_color).should == "Übersetz mich!"
+  end
+
+  it "translates scoped error messages" do
+    pending 'scope is no longer added in 3.x' if ActiveRecord::VERSION::MAJOR >= 3 
+    FastGettext.stub!(:current_repository).and_return('activerecord.errors.translate me'=>"Übersetz mich!")
+    FastGettext._('activerecord.errors.translate me').should == "Übersetz mich!"
+    c = CarSeat.new
+    c.valid?
+    c.errors.on(:seat_color).should == "Übersetz mich!"
+  end
+end

data/spec/gettext_i18n_rails/backend_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path("../spec_helper", File.dirname(__FILE__))
+
+describe GettextI18nRails::Backend do
+  it "redirects calls to another I18n backend" do
+    subject.backend.should_receive(:xxx).with(1,2)
+    subject.xxx(1,2)
+  end
+
+  describe :available_locales do
+    it "maps them to FastGettext" do
+      FastGettext.should_receive(:available_locales).and_return [:xxx]
+      subject.available_locales.should == [:xxx]
+    end
+
+    it "and_return an epmty array when FastGettext.available_locales is nil" do
+      FastGettext.should_receive(:available_locales)
+      subject.available_locales.should == []
+    end
+  end
+
+  describe :translate do
+    it "uses gettext when the key is translateable" do
+      FastGettext.should_receive(:current_repository).and_return 'xy.z.u'=>'a'
+      subject.translate('xx','u',:scope=>['xy','z']).should == 'a'
+    end
+
+    it "can translate with gettext using symbols" do
+      FastGettext.should_receive(:current_repository).and_return 'xy.z.v'=>'a'
+      subject.translate('xx',:v ,:scope=>['xy','z']).should == 'a'
+    end
+
+    it "can translate with gettext using a flat scope" do
+      FastGettext.should_receive(:current_repository).and_return 'xy.z.x'=>'a'
+      subject.translate('xx',:x ,:scope=>'xy.z').should == 'a'
+    end
+
+    it "uses the super when the key is not translateable" do
+      lambda{subject.translate('xx','y',:scope=>['xy','z'])}.should raise_error(I18n::MissingTranslationData)
+    end
+  end
+end

data/spec/gettext_i18n_rails_spec.rb

@@ -0,0 +1,47 @@
+require File.expand_path("spec_helper", File.dirname(__FILE__))
+
+FastGettext.silence_errors
+
+describe GettextI18nRails do
+  it "extends all classes with fast_gettext" do
+    _('test')
+  end
+
+  it "sets up out backend" do
+    I18n.backend.is_a?(GettextI18nRails::Backend).should be_true
+  end
+
+  it "has a VERSION" do
+    GettextI18nRails::VERSION.should =~ /^\d+\.\d+\.\d+$/
+  end
+
+  describe 'FastGettext I18n interaction' do
+    before do
+      FastGettext.available_locales = nil
+      FastGettext.locale = 'de'
+    end
+
+    it "links FastGettext with I18n locale" do
+      FastGettext.locale = 'xx'
+      I18n.locale.should == :xx
+    end
+
+    it "does not set an not-accepted locale to I18n.locale" do
+      FastGettext.available_locales = ['de']
+      FastGettext.locale = 'xx'
+      I18n.locale.should == :de
+    end
+
+    it "links I18n.locale and FastGettext.locale" do
+      I18n.locale = :yy
+      FastGettext.locale.should == 'yy'
+    end
+
+    it "does not set a non-available locale thorugh I18n.locale" do
+      FastGettext.available_locales = ['de']
+      I18n.locale = :xx
+      FastGettext.locale.should == 'de'
+      I18n.locale.should == :de
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'rubygems'
+if ENV['VERSION']
+  puts "running VERSION #{ENV['VERSION']}"
+  gem 'activerecord', ENV['VERSION']
+  gem 'activesupport', ENV['VERSION']
+  gem 'actionpack', ENV['VERSION']
+  gem 'actionmailer', ENV['VERSION']
+end
+
+$LOAD_PATH << File.expand_path("../lib", File.dirname(__FILE__))
+
+require 'active_support'
+require 'active_record'
+require 'action_controller'
+require 'action_mailer'
+require 'fast_gettext'
+require 'gettext_i18n_rails'

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: gettext_i18n_rails
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-23 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fast_gettext
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: grosser.michael@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- VERSION
+- gettext_i18n_rails.gemspec
+- lib/gettext_i18n_rails.rb
+- lib/gettext_i18n_rails/action_controller.rb
+- lib/gettext_i18n_rails/active_record.rb
+- lib/gettext_i18n_rails/backend.rb
+- lib/gettext_i18n_rails/haml_parser.rb
+- lib/gettext_i18n_rails/i18n_hacks.rb
+- lib/gettext_i18n_rails/model_attributes_finder.rb
+- lib/gettext_i18n_rails/ruby_gettext_extractor.rb
+- lib/tasks/gettext_rails_i18n.rake
+- rails/init.rb
+- spec/gettext_i18n_rails/action_controller_spec.rb
+- spec/gettext_i18n_rails/active_record_spec.rb
+- spec/gettext_i18n_rails/backend_spec.rb
+- spec/gettext_i18n_rails_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/grosser/gettext_i18n_rails
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Simple FastGettext Rails integration.
+test_files: 
+- spec/spec_helper.rb
+- spec/gettext_i18n_rails/active_record_spec.rb
+- spec/gettext_i18n_rails/backend_spec.rb
+- spec/gettext_i18n_rails/action_controller_spec.rb
+- spec/gettext_i18n_rails_spec.rb