lazier 2.6.4 → 2.6.5

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 23:34:10 2013 by
+  Generated on Sat Feb  9 10:45:50 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4 (ruby-1.9.3).
 </div>

data/lib/lazier.rb

@@ -13,6 +13,7 @@ require "r18n-desktop"
 require "lazier/version" if !defined?(Lazier::Version)
 require "lazier/exceptions"
 require "lazier/i18n"
+require "lazier/localizer"
 require "lazier/settings"
 require "lazier/object"
 require "lazier/boolean"

data/lib/lazier/i18n.rb

@@ -6,11 +6,22 @@
 
 module Lazier
   # Provides an easy way to localized messages in a class.
+  #
+  # @attribute [r] i18n_locale
+  #   @return [String|Symbol|nil] The current locale.
+  # @attribute [r] i18n_root
+  #   @return [Symbol] The root level of the translation.
+  # @attribute [r] i18n_locales_path
+  #   @return [String] The path where the translations are stored.
   module I18n
+    attr_reader :i18n_locale
+    attr_reader :i18_root
+    attr_reader :i18n_locales_path
+
     # Setup all I18n translations.
     #
-    # @param root [Symbol] The root level of translation.
-    # @param path [String] The path where the translation are stored.
+    # @param root [Symbol] The root level of the translation.
+    # @param path [String] The path where the translations are stored.
     def i18n_setup(root, path)
       @i18n_root = root.to_sym
       @i18n_locales_path = path
@@ -25,9 +36,10 @@ module Lazier
 
     # Set the current locale for messages.
     #
-    # @param locale [String] The new locale. Default is the current system locale.
+    # @param locale [String|Symbol|nil] The new locale. Default is the current system locale.
     # @return [R18n::Translation] The new translation object.
     def i18n=(locale)
+      @i18n_locale = locale
       @i18n = i18n_load_locale(locale)
     end
 

data/lib/lazier/localizer.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+
+module Lazier
+# A utility class to localize messages
+  class Localizer
+    include Lazier::I18n
+
+    # Initialize a new localizer.
+    #
+    # @param root [Symbol] The root level of the translation.
+    # @param path [String] The path where the translations are stored.
+    # @param locale [String|Symbol] The locale to use for localization.
+    def initialize(root = nil, path = nil, locale = nil)
+      root ||= :lazier
+      path ||= ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../locales/")
+      self.i18n_setup(root, path)
+      self.i18n = locale
+    end
+
+    # Localize a message.
+    #
+    # @param message [String|Symbol] The message to localize.
+    # @param args [Array] Optional arguments to localize the message.
+    # @return [String|R18n::Untranslated] The localized message.
+    def self.localize(message, *args)
+      self.new.i18n.send(message, *args)
+    end
+
+    # Localize a message in a specified locale.
+    #
+    # @param locale [String|Symbol] The locale to use for localization.
+    # @param message [String|Symbol] The message to localize.
+    # @param args [Array] Optional arguments to localize the message.
+    # @return [String|R18n::Untranslated] The localized message.
+    def self.localize_on_locale(locale, message, *args)
+      self.new(nil, nil, locale).i18n.send(message, *args)
+    end
+  end
+end

data/lib/lazier/version.rb

@@ -16,7 +16,7 @@ module Lazier
     MINOR = 6
 
     # The patch version.
-    PATCH = 4
+    PATCH = 5
 
     # The current version of lazier.
     STRING = [MAJOR, MINOR, PATCH].compact.join(".")

data/spec/lazier/localizer_spec.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+
+require "spec_helper"
+
+describe Lazier::Localizer do
+  describe "#initialize" do
+    it "should call i18n_setup and then i18n=" do
+      ::Lazier::Localizer.any_instance.should_receive(:i18n_setup).with("ROOT", "PATH")
+      ::Lazier::Localizer.any_instance.should_receive(:i18n=).with(:it)
+      Lazier::Localizer.new("ROOT", "PATH", :it)
+    end
+
+    it "should setup default arguments" do
+      ::Lazier::Localizer.any_instance.should_receive(:i18n_setup).with(:lazier, ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../locales/"))
+      ::Lazier::Localizer.any_instance.should_receive(:i18n=).with(nil)
+      Lazier::Localizer.new
+    end
+  end
+
+  describe ".localize" do
+    it "should create a new localizer and forward the message" do
+      obj = Object.new
+      obj.should_receive(:string).with("ARGUMENT")
+      ::Lazier::Localizer.should_receive(:new).and_call_original
+      ::Lazier::Localizer.any_instance.should_receive(:i18n).and_return(obj)
+      ::Lazier::Localizer.localize(:string, "ARGUMENT")
+    end
+  end
+
+  describe ".localize" do
+    it "should create a new localizer and forward the message" do
+      obj = Object.new
+      obj.should_receive(:string).with("ARGUMENT")
+      ::Lazier::Localizer.should_receive(:new).with(nil, nil, :it).and_call_original
+      ::Lazier::Localizer.any_instance.should_receive(:i18n).and_return(obj)
+      ::Lazier::Localizer.localize_on_locale(:it, :string, "ARGUMENT")
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lazier
 version: !ruby/object:Gem::Version
-  version: 2.6.4
+  version: 2.6.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-08 00:00:00.000000000 Z
+date: 2013-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -128,6 +128,7 @@ files:
 - lib/lazier/exceptions.rb
 - lib/lazier/hash.rb
 - lib/lazier/i18n.rb
+- lib/lazier/localizer.rb
 - lib/lazier/math.rb
 - lib/lazier/object.rb
 - lib/lazier/pathname.rb
@@ -141,6 +142,7 @@ files:
 - spec/lazier/datetime_spec.rb
 - spec/lazier/hash_spec.rb
 - spec/lazier/i18n_spec.rb
+- spec/lazier/localizer_spec.rb
 - spec/lazier/math_spec.rb
 - spec/lazier/object_spec.rb
 - spec/lazier/pathname_spec.rb
@@ -168,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1673408804754958952
+      hash: 4371094391757405950
 requirements: []
 rubyforge_project: lazier
 rubygems_version: 1.8.25
@@ -181,6 +183,7 @@ test_files:
 - spec/lazier/datetime_spec.rb
 - spec/lazier/hash_spec.rb
 - spec/lazier/i18n_spec.rb
+- spec/lazier/localizer_spec.rb
 - spec/lazier/math_spec.rb
 - spec/lazier/object_spec.rb
 - spec/lazier/pathname_spec.rb