localization_generator 1.0.0

data/USAGE

@@ -0,0 +1,24 @@
+NAME
+     localization - rails localization generator
+
+SYNOPSIS
+     ruby script/generate localization
+     
+DESCRIPTION
+     This generator installs a module, as originally implemented in RForum,
+     for localization of strings.
+
+EXAMPLE
+
+     In order to display a localized string, you must do a few simple things.
+     First, instead of assigning your string as "var = str" do "var =
+     l(:str_label)." In your top level project directory, you will find
+     a subdirectory called lang. Popoulate this directory with a .yaml file
+     for each language you need intend to translate strings into.
+     The filename should be of the form [lang].yaml. Then, include
+     "config/environments/localization_environment" from your "config/
+     environment.rb" file. Finally, set the default language in this file
+     via the variable 'default_lang.' The value should be the prefix of the
+     .yaml file in the lang directory.
+
+     That's it! Thanks to Andreas Schwarz for the code.

data/localization_generator.rb

@@ -0,0 +1,17 @@
+class LocalizationGenerator < Rails::Generator::NamedBase
+  def manifest
+    record do |m|
+      # Check for collisions
+      #bm.class_collisions class_path, "#{class_name}"
+
+      # Languages directory
+      m.directory "lang"
+
+      # Library file
+      m.template "localization.rb", "lib/#{file_name}.rb"
+
+      # Configuration
+      m.template "localization_environment.rb", "config/environments/#{file_name}_environment.rb"
+    end
+  end
+end

data/templates/localization.rb

@@ -0,0 +1,70 @@
+require 'iconv'
+
+module <%= class_name %>
+  
+  LOCALIZED_STRINGS = {}
+
+  def l(symbol, *arguments)
+    language = CONFIG[:default_language]
+
+    symbol = symbol.to_sym if symbol.is_a? String
+
+    # translation of an LString is simply a call to to_s
+    return symbol.to_s if symbol.is_a? LString
+  
+    # translation of an array
+    if symbol.is_a? Array 
+      raise ArgumentError.new("Cannot translate an empty array") if symbol.empty?
+      raise ArgumentError.new("Symbol is an array, arguments must be empty") unless arguments.empty?
+      arguments = symbol
+      symbol = arguments.shift
+    end
+  
+    translation = (LOCALIZED_STRINGS[language][symbol] or
+      LOCALIZED_STRINGS['en'][symbol] or
+        symbol.to_s)
+    begin
+      return translation % arguments
+    rescue => e
+      raise ArgumentError.new("Translation value #{translation.inspect} " + 
+          "with arguments #{arguments.inspect} caused error '#{e.message}'")
+    end
+  end
+
+  def valid_language?(language)
+    LOCALIZED_STRINGS.has_key? language
+  end
+
+  def self.load_localized_strings
+    # Load language files
+    Dir[RAILS_ROOT + '/lang/*.yaml'].each do |filename|
+      filename =~ /([a-z]+)\.yaml$/
+      hash = YAML::load(File.read(filename))
+      file_charset = hash['file_charset'] || 'ascii'
+
+      # convert string keys to symbols
+      symbol_hash = Hash.new
+      Iconv.open(CONFIG[:web_charset], file_charset) do |i|
+        hash.each do |key, value|
+          symbol_hash[key.to_sym] = i.iconv(value)
+        end
+      end
+        
+      LOCALIZED_STRINGS[$1] = symbol_hash
+    end
+  end
+
+  class LString
+  
+    include <%= class_name %>
+    
+    def initialize(symbol, arguments)
+      @symbol, @arguments = symbol, arguments
+    end
+
+    def to_s
+      l(@symbol, @arguments)
+    end
+  end
+  
+end

data/templates/localization_environment.rb

@@ -0,0 +1,12 @@
+module <%= class_name %>
+  CONFIG = {
+    # Default language
+    :default_language => 'en',
+
+    :web_charset => 'utf-8'
+  }
+
+  if CONFIG[:web_charset] == 'utf-8'
+    $KCODE = 'u'
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.8
+specification_version: 1
+name: localization_generator
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2005-04-19
+summary: "[Rails] Localization generator."
+require_paths: 
+  - lib
+email: jhosteny@mac.com
+homepage: 
+rubyforge_project: 
+description: Localization utility for Rails apps
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+authors: 
+  - Andreas Schwarz
+  - Joe Hosteny
+files: 
+  - USAGE
+  - localization_generator.rb
+  - templates/localization.rb
+  - templates/localization_environment.rb
+test_files: []
+rdoc_options: []
+extra_rdoc_files: []
+executables: []
+extensions: []
+requirements: []
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: rails
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Version::Requirement 
+      requirements: 
+        - 
+          - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.10.0
+      version: