i18n-generators 1.1.1

data/.gitignore

@@ -0,0 +1,2 @@
+pkg
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/History.txt

@@ -0,0 +1,143 @@
+== 1.1.1
+
+* enchancements:
+  * Add scoped generator instead separate ones
+
+== 1.1.0
+
+* enhancements:
+  * New translation engine (see: http://googlecode.blogspot.com/2011/05/spring-cleaning-for-some-of-our-apis.html) (thanks to agilekawabata-san!)
+
+== 1.0.3
+
+* bugfixes:
+  * #4 Translation generator recursive loop in ruby 1.9 + MS-Windows (memarko)
+
+* enhancements:
+  * Some Rails-3-ish cleanups
+
+== 1.0.2
+
+* bugfixes:
+  * Use https to request GH
+
+== 1.0.1
+
+* major enhancements:
+  * Bundle yaml_waml.rb to avoid depending on yaml_waml gem (thanks to kakutani-san!)
+
+== 1.0.0
+
+* major enhancements:
+  * Rails 3
+* enhancements:
+  * Fixing deprectaed syntax {{error}} with %{error} for i18n_scaffold (moro)
+
+== 0.8.1
+
+* bugfixes:
+  * Fix for pluralized translations (scambra)
+
+== 0.8.0
+
+* major enhancements:
+  * Gemify
+
+== 0.7.0
+
+* major enhancements:
+  * Fix gettext dependency version
+* enhancements:
+  * Add more error checks when loading models
+  * Load gettext only when using it
+
+== 0.6.0
+
+* bugfixes:
+  * Could not load cldr data with short locale names
+* major enhancements:
+  * Include AR association names in model attributes translation
+  * Add 'generated' comment mark (#g) for generated lines in YAML (thanks to t-wada-senpai, Shimura-san, Toyofuku-san, Sezutsu-san and oukayuka-san!)
+  * Add --include-timestamps option and change default bahaviour not to include timestamp columns in translation YAML
+  * Add blank line between each blocks (thanks to Sawayanagi-san!)
+* enhancements:
+  * Avoid generating blank locale file
+  * Change GitHub fetch URL from blob/master/...?raw=true to raw/master
+
+== 0.5.0
+
+* bugfixes:
+  * Could not fetch the locale files via GitHub (GitHub changed the URL?)
+* major enhancements:
+  * Ruby 1.9 ready!
+  * Never connect to CLDR site when the locale file found in Sven's rails-i18n repository
+* enhancements:
+  * Use Ruby 1.9 built-in JSON parser if Ruby 1.9
+
+== 0.4.1
+
+* bugfixes:
+  * i18n_translation abnormally ends when loading a view containing "-%>" (thanks to babie-san!)
+
+== 0.4.0
+
+* major enhancements:
+  * translation generator now preserves any existing extra lines in the YAML file (thanks to Iain Hecker-san!)
+
+== 0.3.4
+
+* enhancements:
+  * Reduce unnecessary request to CLDR site
+
+== 0.3.3
+
+* bugfixes:
+  * Did not work on Ruby 1.8.6 (thanks to akm-san!)
+
+== 0.3.2
+
+* bugfixes:
+  * Trim mode in ERB didn't work on some platforms (thanks to valda-san!)
+
+== 0.3.1
+
+* enhancements:
+  * Translate all keys simultaneously using thread
+  * Translations with :scope is going to be yamlized with proper hierarchy
+
+== 0.3.0
+
+* major enhancements:
+  * Renamed the generators
+      i18n_locales -> i18n_locale (i18n --locale)
+      i18n_models -> i18n_translation (i18n --translation)
+  * Handle all translate keys which appear in view files (thanks to PanosJee-san!)
+
+== 0.2.0
+
+* major enhancements:
+  * Implemented i18n_scaffold generator (thanks to Iain Hecker-san!)
+
+* enhancements:
+  * i18n_models generator can now deal with non AR classes which has content_columns (thanks to Iain Hecker-san!)
+
+== 0.1.0
+
+* major enhancements:
+  * Fetch locale YAML file from rails-i18n project repository first
+
+* bugfixes:
+  * Could not recognize model names with multipie words (thanks to makoto-san!)
+
+== 0.0.8
+
+* major enhancements:
+  * Lots of changes for this commit by DHH http://github.com/rails/rails/commit/d9b92ee11b33fed5c7a94a91415fa846705f7dd3
+
+== 0.0.4
+
+* Gemified on GitHub
+
+== 0.0.1
+
+* Birthday!

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2011 Akira Matsuda
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,74 @@
+= I18n generators
+
+This gem plugin generates a set of locale files for Rails i18n feature.
+Supports Rails 3.1, 3.0.x, 2.3.x and 2.2.x.
+
+* http://github.com/amatsuda/i18n_generators
+* http://rubygems.org/gems/i18n_generators
+
+
+== FEATURES
+
+This gem/plugin provides following generate commands.
+
+=== 1. Generate Locale Files for ActiveRecord/ActiveSupport/ActionPack
+
+    rails g i18n:locale ja (de-AT, pt-BR, etc.)
+
+Downloads the .yml file for the specified locale from the official rails-i18n repository:
+    https://github.com/svenfuchs/rails-i18n/tree/master/rails/locale
+
+Then the generater sets the application default locale to the specified locale.
+
+This will generate following locale file.
+
+    config/locales/ja.yml
+
+=== 2. Generate Translation YAML File For All Models/Attributes
+
+    rails g i18n:translation ja (de-AT, pt-BR, etc.)
+
+This will generate following YAML file.
+
+    config/locales/translation.ja.yml
+
+The generator scans your app/models directory, and generates a YAML file
+with all the AR model names and attributes so that you don't have to write
+the YAML skeleton manually or by copy/paste. In addition, the generatortries
+to translate each of them into the specified language. The generator doesn't
+overwrite the existing value so that you can rerun the generator again and again.
+
+=== 3. Generate All
+
+    rails g i18n:all ja # (de-AT, pt-BR, etc.)
+
+Executes 1 and 2 at once.
+
+
+== REQUIREMENTS:
+
+* Ruby (>= 1.8.7)
+* Ruby on Rails (3.1 or 3.0 or 2.3 or 2.2)
+
+
+== INSTALL:
+
+* As a gem
+
+    gem install i18n_generators # install orginal version so far
+
+* With Bundler
+Add
+
+    gem 'i18n_generators' # as above
+
+to your Gemfile, then `bundle`. Restricting the group to :development would be
+a good idea, since the generator would probably be used only in development mode.
+
+* As a Rails plugin
+
+    rails plugin install git://github.com/hauleth/i18n-generators.git
+
+
+Copyright (c) 2008 - 2011 Akira Matsuda (fixed by Łukasz Niemier), released
+under the MIT license

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/generators/i18n/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Generates a config file and locale files and a model/attributes translation file for Rails 2.x i18n.
+
+Example:
+    ./script/generate i18n locale_name (ja, de-AT, etc.)
+
+    This will create:
+        config/locales/ja.yml
+        config/locales/translation_ja.yml
+    And update:
+        config/environment.rb

data/generators/i18n/i18n_generator.rb

@@ -0,0 +1,88 @@
+require 'net/https'
+require 'rubygems'
+require 'rails_generator'
+require 'rails_generator/commands'
+
+class I18nGenerator < Rails::Generator::NamedBase
+  attr_reader :locale_name, :cldr, :translator, :generate_translation_only, :generate_locale_only, :include_timestamps
+
+  def initialize(runtime_args, runtime_options = {})
+    if options[:scaffold]
+      #TODO invoke scaffold generator
+      puts 'please use generate i18n_scaffold command'
+      exit
+    end
+
+    super
+    unless name =~ /^[a-zA-Z]{2}([-_][a-zA-Z]{2})?$/
+      puts 'ERROR: Wrong locale format. Please input in ?? or ??-?? format.'
+      exit
+    end
+    @locale_name = name.length == 5 ? "#{name[0..1].downcase}-#{name[3..4].upcase}" : "#{name[0..1].downcase}"
+
+    unless options[:generate_translation_only]
+      gem 'gettext', '<2'
+      require 'gettext'
+      @cldr = CldrDocument.new @locale_name
+      GetText.bindtextdomain 'rails'
+      GetText.locale = @locale_name
+    end
+    unless options[:generate_locale_only]
+      lang = @locale_name.sub(/-.*$/, '')
+      @translator = Translator.new lang
+    end
+    @include_timestamps = true if options[:include_timestamps]
+  end
+
+  def manifest
+    record do |m|
+      m.directory 'config/locales'
+      unless options[:generate_translation_only]
+        logger.debug 'updating environment.rb ...'
+        m.generate_configuration
+        if defined_in_rails_i18n_repository?
+          logger.debug "fetching #{locale_name}.yml from rails-i18n repository..."
+          m.fetch_from_rails_i18n_repository
+        else
+          logger.debug "generating #{locale_name} YAML files for Rails..."
+          m.active_support_yaml
+          m.active_record_yaml
+          m.action_view_yaml
+        end
+      end
+      unless options[:generate_locale_only]
+        m.translation_yaml
+      end
+    end
+  end
+
+  protected
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on('--translation',
+           'Generate translations for all models with their attributes and all translation keys in the view files.') {|v| options[:generate_translation_only] = v}
+    opt.on('--locale', 'Generate locale files.') {|v| options[:generate_locale_only] = v}
+    opt.on('--include-timestamps', 'Include timestamp columns in the YAML translation.') {|v| options[:include_timestamps] = v}
+    opt.on('--include-timestamp', 'Include timestamp columns in the YAML translation.') {|v| options[:include_timestamps] = v}
+  end
+
+  private
+  def defined_in_rails_i18n_repository?
+    begin
+      uri = URI.parse "https://github.com/svenfuchs/rails-i18n/raw/master/rails/locale/#{locale_name}.yml"
+      http = Net::HTTP.new uri.host, uri.port
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      req = Net::HTTP::Get.new uri.request_uri
+      res = http.request req
+      res.code == '200'
+    rescue
+      false
+    end
+  end
+end
+
+require File.join(File.dirname(__FILE__), '../i18n_locale/i18n_locale_command')
+require File.join(File.dirname(__FILE__), '../i18n_translation/i18n_translation_command')
+Rails::Generator::Commands::Create.send :include, I18nGenerator::Generator::Commands::Create

data/generators/i18n/lib/yaml.rb

@@ -0,0 +1,187 @@
+require 'yaml'
+
+module I18nLocaleGeneratorModule
+  class Node
+    attr_reader :document, :indent_level
+    attr_accessor :line
+
+    def initialize(parent, line_index, text)
+      @document, @line, @text = parent.document, line_index, text.to_s
+      @text =~ /(^\s*)/
+      @indent_level = $1.nil? ? 0 : $1.size
+      @yaml = YAML.load(@text.to_s + ' ')
+    end
+
+    def parent
+      @parent ||= document.parent_of self
+    end
+
+    def children
+      @children ||= document.children_of(self)
+    end
+    alias :nodes :children
+
+    def [](node_name)
+      if node = nodes.detect {|n| n.key.to_s == node_name.to_s}
+        node
+      else
+        nodes.add "#{' ' * (@indent_level + 2)}#{node_name}: "
+        nodes.last
+      end
+    end
+
+    def key
+      @yaml.is_a?(Hash) ? @yaml.keys.first : nil
+    end
+
+    def value
+      @yaml.is_a?(Hash) ? @yaml.values.first : nil
+    end
+
+    def value=(val)
+      if @yaml[self.key] != val
+        @yaml[self.key] = val
+        @changed = true
+      end
+    end
+
+    def text
+      if @changed
+        v = if self.value.is_a?(Array)
+          "[#{self.value * ', '}]"
+        else
+          %Q["#{self.value}"]
+        end
+        "#{' ' * self.indent_level}#{self.key}: #{v}  #g"  # g is for 'generated'!
+      else
+        @text
+      end
+    end
+    alias :to_s :text
+
+    def changed?
+      @changed
+    end
+
+    def is_blank_or_comment?
+      @text.sub(/#.*$/, '').gsub(/\s/, '').empty?
+    end
+
+    def path
+      @path ||= "#{self.parent.path}/#{self.key}"
+    end
+
+    def descendant_nodes(&block)
+      yield self if self.value
+      self.children.each {|child| child.descendant_nodes(&block)} if self.children
+    end
+
+    def <=>(other)
+      self.line <=> other.line
+    end
+  end
+
+  class YamlDocument < Node
+    attr_accessor :lines
+    alias :nodes :lines
+
+    def initialize(yml_path, locale_name)
+      @locale_name, @lines, @current_line, @indent_level = locale_name, Nodes.new(self), -1, -2
+      if File.exists? yml_path
+        File.open(yml_path) do |file|
+          file.each_with_index do |line_text, i|
+            n = Node.new(self, i, line_text.chomp)
+            @lines << ((((n.key == 'en-US') || (n.key == 'en')) && n.value.blank?) ? Node.new(self, i, "#{locale_name}:") : n)
+          end
+          @lines.delete_at(-1) if @lines[-1].text.blank?
+        end
+      end
+    end
+
+    def next
+      return false if @lines.size == 0
+      @current_line += 1
+      return false if @current_line >= @lines.size
+      @lines[@current_line].is_blank_or_comment? ? self.next : @lines[@current_line]
+    end
+
+    def prev
+      return false if @current_line == 0
+      @current_line -= 1
+      @lines[@current_line].is_blank_or_comment? ? self.prev : @lines[@current_line]
+    end
+
+    def parent_of(child)
+      @current_line = child.line
+      while n = self.prev
+        return n if n.indent_level == child.indent_level - 2
+      end
+      self
+    end
+
+    def children_of(parent)
+      nodes = Nodes.new(parent)
+      @current_line = parent.line
+      while n = self.next
+        if n.indent_level < parent.indent_level + 2
+          break
+        elsif n.indent_level == parent.indent_level + 2
+          nodes << n
+        end
+      end
+      nodes
+    end
+
+    def document
+      self
+    end
+
+    def path
+      ''
+    end
+
+    def line
+      @current_line
+    end
+
+    def to_s(add_blank_line = false)
+      previous_indent_level = 0
+      @lines.inject('') do |ret, n|
+        ret << "\n" if add_blank_line && (n.indent_level < previous_indent_level) && !n.text.blank? && !ret.ends_with?("\n\n")
+        previous_indent_level = n.indent_level
+        ret << (n.text ? n.text.rstrip : '') + "\n"
+      end
+    end
+  end
+
+  class Nodes < Array
+    def initialize(parent)
+      super()
+      @parent = parent
+    end
+
+    def [](index)
+      if index.is_a?(String) || index.is_a?(Symbol)
+        return self.detect {|node| node.key == index} || add(index)
+      end
+      super
+    end
+
+    def last_leaf
+      c = @parent
+      loop do
+        return c if c.children.blank?
+        c = c.children.last
+      end
+    end
+
+    def add(node_name)
+      target_line = self.last_leaf.line + 1
+      @parent.document.nodes.each {|n| n.line += 1 if n.line >= target_line}
+      node = Node.new(@parent, target_line, node_name)
+      @parent.document.lines << node
+      @parent.document.lines.sort!
+      self << node unless @parent.is_a? YamlDocument
+    end
+  end
+end

data/generators/i18n/templates/i18n_config.rb

@@ -0,0 +1,4 @@
+I18n.load_path += Dir.glob("#{RAILS_ROOT}/lib/locale/*.yml")
+
+I18n.default_locale = '<%= locale_name %>'
+I18n.locale         = '<%= locale_name %>'

data/generators/i18n/templates/translation.yml

@@ -0,0 +1 @@
+<%= translations %>

data/generators/i18n_locale/USAGE

@@ -0,0 +1,10 @@
+Description:
+    Generates a config file and locale files for Rails 2.x i18n.
+
+Example:
+    ./script/generate i18n locale_name (ja, de-AT, etc.)
+
+    This will create:
+        config/locales/ja.yml
+    And update:
+        config/environment.rb