teamon-merb-simple-translation 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Tymon <teamon> Tobolski (http://teamon.eu)
+
+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.textile

@@ -0,0 +1,63 @@
+h2. merb-simple-translation
+
+A plugin for the Merb framework that provides simple UI translation
+
+h3. Installation
+
+
+h4. Gem
+
+@gem sources -a http://gems.github.com@
+@sudo gem install teamon-merb-simple-translation@
+
+h4. Configuration
+
+_config/dependencies.rb_
+<pre></code>dependency "teamon-merb-simple-translation", :require_as => "merb-simple-translation"
+</code></pre>
+
+_config/init.rb_
+<pre></code>Merb::BootLoader.after_app_loads do
+  Translation.load
+end</code></pre>
+
+h3. Other options
+
+h4. Reload translation files on every request
+
+_config/environments/development.rb_
+<pre><code>
+Merb::Config.use { |c|
+  c[:translation_debug] = true
+}
+</code></pre>
+
+h4. Change translations dir (default PROJECT_ROOT/translations) or default language
+
+_config/init.rb_
+<pre><code>Merb::BootLoader.after_app_loads do
+  Translation.translations_dir = Merb.root / 'i18n' 
+  Translation.default_language = 'pl'
+end</code></pre>
+
+h3. Translation files
+
+Plugin lets you write translations in two ways
+
+h4. Ruby files
+
+_translations/pl.rb_
+<pre><code>Translation.add_translations('pl', {
+  "Log in" => "Zaloguj"
+})</code></pre>
+
+h4. YAML files
+
+_translations/pl.yml_
+<pre><code>pl:
+  Homepage: Strona domowa</code></pre>
+
+h3. Copy default translation files to app directory
+@rake merb-simple-translation:copy-defaults@
+
+

data/Rakefile

@@ -0,0 +1,51 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+require 'merb-core'
+require 'merb-core/tasks/merb'
+
+GEM_NAME = "merb-simple-translation"
+GEM_VERSION = "0.1.0"
+AUTHOR = "Tymon <teamon> Tobolski"
+EMAIL = "i@teamon.eu"
+HOMEPAGE = "http://teamon.eu/"
+SUMMARY = "Merb plugin that provides simple UI translation"
+
+spec = Gem::Specification.new do |s|
+  s.rubyforge_project = 'merb'
+  s.name = GEM_NAME
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.textile", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency('merb', '>= 1.0')
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README.textile Rakefile TODO) + Dir.glob("{lib,spec}/**/*")
+  
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "install the plugin as a gem"
+task :install do
+  Merb::RakeHelper.install(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Uninstall the gem"
+task :uninstall do
+  Merb::RakeHelper.uninstall(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Create a gemspec file"
+task :gemspec do
+  File.open("#{GEM_NAME}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end

data/TODO

@@ -0,0 +1 @@
+TODO:

data/lib/merb-simple-translation.rb

@@ -0,0 +1,20 @@
+# make sure we're running inside Merb
+if defined?(Merb::Plugins)
+
+  # Merb gives you a Merb::Plugins.config hash...feel free to put your stuff in your piece of it
+  Merb::Plugins.config[:merb_simple_translation] = {
+    :chickens => false
+  }
+  
+  Merb::BootLoader.before_app_loads do
+    require "merb-simple-translation" / "translation.rb"
+    require "merb-simple-translation" / "string.rb"
+    require "merb-simple-translation" / "controller.rb"
+  end
+  
+  Merb::BootLoader.after_app_loads do
+    # code that can be required after the application loads
+  end
+  
+  Merb::Plugins.add_rakefiles "merb-simple-translation/merbtasks"
+end

data/lib/merb-simple-translation/controller.rb

@@ -0,0 +1,16 @@
+class Merb::Controller
+  before :set_language
+  
+  def set_language
+    Translation.language = session['language'] || begin
+      request.env['HTTP_ACCEPT_LANGUAGE'].split(',')[0].split(';')[0].split('-')[0]
+    rescue
+      Translation.default_language
+    end
+    
+    if Translation.debug?
+      Translation.reload 
+      Translation.save_not_found
+    end
+  end
+end

data/lib/merb-simple-translation/merbtasks.rb

@@ -0,0 +1,10 @@
+namespace "merb-simple-translation" do
+  desc "Copy default translation files do Translation.translations_dir"
+  task "copy-defaults" => :merb_env do    
+    Dir.mkdir(Translation.translations_dir) unless File.exists?(Translation.translations_dir)
+    Dir[File.dirname(__FILE__) / :translations / '*.{rb,yml}'].each do |path|
+      FileUtils.cp(path, Translation.translations_dir / File.basename(path))
+    end
+
+  end
+end

data/lib/merb-simple-translation/string.rb

@@ -0,0 +1,5 @@
+class String
+  def self.translate(value)
+    Translation.translate(value)
+  end
+end

data/lib/merb-simple-translation/translation.rb

@@ -0,0 +1,67 @@
+class Translation
+  @@languages = {}
+  @@debug_mark = "[T]%s[/T]"
+  @@default_language = 'en'
+  @@translations_dir = Merb.root / :translations
+  @@not_found = {}
+
+  cattr_accessor :debug_mark, :default_language, :translations_dir
+
+  class << self
+    def add_translations(lang, translations)
+      @@languages[lang] ||= {}
+      @@languages[lang].merge!(translations)
+    end
+
+    def language
+      Thread.current[:language] ||= default_language
+    end
+
+    def language=(lang)
+      Thread.current[:language] = @@languages[lang] ? lang : default_language
+    end
+    
+    def self.languages
+      @@languages
+    end
+
+    def translate(phrase)
+      if dict[phrase]
+        dict[phrase]
+      elsif debug?
+        @@not_found[phrase] = ""
+        @@debug_mark % phrase
+      else
+        phrase
+      end
+    end
+    
+    def save_not_found
+      File.open(translations_dir / 'not_found.yml', 'w') {|f| f.puts @@not_found.to_yaml }
+    end
+    
+    def reload
+      @@languages = {}
+      load
+    end
+    
+    def load
+      [File.dirname(__FILE__) / :translations, translations_dir].each do |dir|
+        Dir[dir / '*.rb'].each {|f| Kernel.load f}
+        Dir[dir / '*.yml'].reject{|e| e =~ /not_found.yml/}.each do |f|
+          YAML.load(File.read(f)).each_pair do |lang, translations|
+            add_translations(lang, translations)
+          end
+        end
+      end
+    end
+
+    def dict
+      @@languages[language] || @@languages[default_language] || {}
+    end
+    
+    def debug?
+      Merb::Config[:translation_debug]
+    end
+  end
+end

data/lib/merb-simple-translation/translations/pl.rb

@@ -0,0 +1 @@
+Translation.add_translations('pl', {})

data/lib/merb-simple-translation/translations/pl.yml

@@ -0,0 +1,33 @@
+pl:  
+  %s is not accepted: %s nie jest zaakceptowane
+  %s does not match the confirmation: %s nie pasuje do potwierdzenia
+  %s is invalid: %s jest niepoprawne
+  %s has an invalid format: %s ma niepoprawny format
+  %s must be between %s and %s characters long: %s musi mieć od %s do %s znaków
+  %s must be more than %s characters long: %s musi mieć więcej niż %s znaków
+  %s must be less than %s characters long: %s musi mieć mniej niż %s znaków
+  %s must be %s characters long: %s musi mieć %s znaków
+  %s must be an integer: %s musi być liczbą całkowitą
+  %s must be a number: %s musi być liczbą
+  %s must not be %s: %s nie moze być %s
+  
+  blank: puste
+  Oops! There are some errors: Wystąpiły błędy...
+  Login: Login
+  Password: Hasło
+  Password confirmation: Powtórz hasło
+  Create: Dodaj
+  Back: Powrót
+  Save: Zapisz
+  Log in: Zaloguj
+  Log out: Wyloguj
+  Sign in: Zarejestruj
+  Forgot password: Zapomniałem hasła
+  Not found: 404 Nie znaleziono
+  Name: Imię i nazwisko
+  Please login: Proszę się zalogować
+  Sign up: Zarejestruj się
+  Profile: Profil
+  Logged in as %s: Zalogowany jako %s
+  Email: Email
+  Your profile: Twój profil

data/spec/merb-simple-translation_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper'
+require "merb-core"
+require "merb-simple-translation/translation.rb"
+require "merb-simple-translation/string.rb"
+
+describe "merb-simple-translation" do
+  before do
+    Translation.add_translations('pl', {
+      'simple string' => 'prosty ciąg',
+      'i like %s' => 'lubie %s',
+      'apples' => 'jabłka'
+    })
+    
+    Translation.language = 'pl'
+  end
+  
+  
+  it "should translate simple string" do
+    "simple string".t.should == "prosty ciąg"
+  end
+  
+  it "should not translate missing phrase" do
+    "i do not exist!".t.should == "i do not exist!"
+  end
+  
+  it "should mark untranslated phrase in debug mode" do
+    Merb::Config[:translation_debug] = true
+    "i do not exist!".t.should == "[T]i do not exist![/T]"
+  end
+  
+  it "should allow to change debug marking string" do
+    Merb::Config[:translation_debug] = true
+    Translation.debug_mark = "{TRANS}%s{/TRANS}"
+    "i do not exist!".t.should == "{TRANS}i do not exist!{/TRANS}"
+  end
+  
+  it "should translate like sprintf" do
+    "i like %s".t("apples").should == "lubie jabłka"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+$:.push File.join(File.dirname(__FILE__), '..', 'lib')

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: teamon-merb-simple-translation
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tymon <teamon> Tobolski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-10 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: merb
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+description: Merb plugin that provides simple UI translation
+email: i@teamon.eu
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+- LICENSE
+- TODO
+files: 
+- LICENSE
+- README.textile
+- Rakefile
+- TODO
+- lib/merb-simple-translation
+- lib/merb-simple-translation/controller.rb
+- lib/merb-simple-translation/merbtasks.rb
+- lib/merb-simple-translation/string.rb
+- lib/merb-simple-translation/translation.rb
+- lib/merb-simple-translation/translations
+- lib/merb-simple-translation/translations/pl.rb
+- lib/merb-simple-translation/translations/pl.yml
+- lib/merb-simple-translation.rb
+- spec/merb-simple-translation_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://teamon.eu/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: merb
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Merb plugin that provides simple UI translation
+test_files: []
+