papla 0.0.2 → 0.0.3

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+### 0.0.3 (2012-02-16)
+
+* provide localization using I18n
+
 ### 0.0.2 (2011-01-09)
 
 * display decimal part of floats as cents/100

data/README.md

@@ -46,7 +46,13 @@ Papla[2.999] # => "Trzy 00/100"
 
 This feature is planned for future releases.
 
-### Integration with Money, I18n and Rails
+## Integration with Money, I18n and Rails
+
+### I18n
+
+Localization is provided by I18n. See `lib/papla/backend.rb` for details of keys used.
+
+### Money, Rails
 
 This feature is planned for future releases.
 

data/lib/papla.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-require "papla/version"
+require 'papla/backend'
+require 'papla/version'
 
 module Papla
   # Converts a number to Polish words, capitalizing
@@ -49,31 +49,6 @@ module Papla
   end
 
   private
-  ZERO = 'zero'
-
-  ONES = [nil] + %w[
-    jeden dwa trzy cztery pięć
-    sześć siedem osiem dziewięć dziesięć
-    jedenaście dwanaście trzynaście czternaście piętnaście
-    szesnaście siedemnaście osiemnaście dziewiętnaście
-  ].freeze
-
-  TENS = [nil, nil] + %w[
-    dwadzieścia trzydzieści czterdzieści pięćdziesiąt
-    sześćdziesiąt siedemdziesiąt osiemdziesiąt dziewięćdziesiąt
-  ].freeze
-
-  HUNDREDS = [nil] + %w[
-    sto dwieście trzysta czterysta pięćset
-    sześćset siedemset osiemset dziewięćset
-  ].freeze
-
-  RANKS = [
-    [],
-    ['tysięcy', 'tysiąc', 'tysiące'].freeze,
-    ['milionów', 'milion', 'miliony'].freeze,
-    ['miliardów', 'miliard', 'miliardy'].freeze
-  ].freeze
 
   def self.prepare(number)
     case number
@@ -84,7 +59,7 @@ module Papla
 
   def self.build_basic_phrase(basic_number)
     if basic_number.zero?
-      ZERO
+      spell_zero
     else
       groups = group(basic_number)
       groups_as_words = convert_groups(groups)
@@ -110,7 +85,7 @@ module Papla
     groups.each_with_index do |group, i|
       if group > 0
         result << convert_small_number(group)
-        result << rank(bound - i, group) if i < bound
+        result << spell_rank(bound - i, group) if i < bound
       end
     end
 
@@ -121,34 +96,13 @@ module Papla
     if number.zero?
       []
     elsif number < 20
-      [ONES[number]]
+      [spell_ones(number)]
     elsif number < 100
       tens, remainder = number.divmod(10)
-      [TENS[tens], convert_small_number(remainder)]
+      [spell_tens(tens), convert_small_number(remainder)]
     else
       hundreds, remainder = number.divmod(100)
-      [HUNDREDS[hundreds], convert_small_number(remainder)]
-    end
-  end
-
-  def self.rank(rank, number)
-    RANKS[rank][declination_index(number)]
-  end
-
-  def self.declination_index(number)
-    return 1 if number == 1
-
-    remainder = number - number / 100 * 100
-
-    case remainder
-    when 12..14 then 0
-    else
-      ones = number - number / 10 * 10
-
-      case ones
-      when 2..4 then 2
-      else 0
-      end
+      [spell_hundreds(hundreds), convert_small_number(remainder)]
     end
   end
 
@@ -159,6 +113,23 @@ module Papla
 
   def self.append_cents(basic_phrase, number)
     cents = 100 * (number - number.to_i)
-    "%s %02d/100" % [basic_phrase, cents]
+    spell_cents(basic_phrase, cents)
+  end
+
+  @backends = {}
+
+  def self.backend
+    @backends[locale] ||= Backend.new(locale)
+  end
+
+  def self.locale
+    :pl
   end
+
+  def self.spell_zero;                       backend.zero;                       end
+  def self.spell_ones(index);                backend.ones(index);                end
+  def self.spell_tens(index);                backend.tens(index);                end
+  def self.spell_hundreds(index);            backend.hundreds(index);            end
+  def self.spell_rank(index, number);        backend.rank(index, number);        end
+  def self.spell_cents(basic_phrase, cents); backend.cents(basic_phrase, cents); end
 end

data/lib/papla/backend.rb

@@ -0,0 +1,51 @@
+require 'i18n'
+
+I18n.load_path << File.expand_path('../locale/pl.yml', __FILE__)
+I18n.load_path << File.expand_path('../locale/pl.rb', __FILE__)
+
+module Papla
+  class Backend
+    def initialize(locale)
+      @locale = locale
+    end
+
+    def zero
+      translate(:zero)
+    end
+
+    def ones(index)
+      translate(:ones)[index]
+    end
+
+    def tens(index)
+      translate(:tens)[index]
+    end
+
+    def hundreds(index)
+      translate(:hundreds)[index]
+    end
+
+    def rank(index, number)
+      rule = pluralization_rule(number)
+      rules = translate(:ranks)[index]
+      rules[rule.to_s]
+    end
+
+    def cents(basic_phrase, cents)
+      cents = "%02d" % cents
+      translate(:cents, basic_phrase: basic_phrase, cents: cents)
+    end
+
+    private
+
+    def translate(message, options = {})
+      options[:locale] = @locale
+      options[:scope] = :papla
+      I18n.translate(message, options)
+    end
+
+    def pluralization_rule(number)
+      I18n.translate(:papla, locale: @locale)[:pluralization][number]
+    end
+  end
+end

data/lib/papla/locale/pl.rb

@@ -0,0 +1,18 @@
+{
+  pl: {
+    papla: {
+      pluralization: lambda do |n|
+        return :one if n == 1
+
+        case n % 100
+        when 12..14 then :other
+        else
+          case n % 10
+          when 2..4 then :few
+          else :other
+          end
+        end
+      end
+    }
+  }
+}

data/lib/papla/locale/pl.yml

@@ -0,0 +1,61 @@
+pl:
+  papla:
+    zero: zero
+    ones:
+      - ~
+      - jeden
+      - dwa
+      - trzy
+      - cztery
+      - pięć
+      - sześć
+      - siedem
+      - osiem
+      - dziewięć
+      - dziesięć
+      - jedenaście
+      - dwanaście
+      - trzynaście
+      - czternaście
+      - piętnaście
+      - szesnaście
+      - siedemnaście
+      - osiemnaście
+      - dziewiętnaście
+    tens:
+      - ~
+      - ~
+      - dwadzieścia
+      - trzydzieści
+      - czterdzieści
+      - pięćdziesiąt
+      - sześćdziesiąt
+      - siedemdziesiąt
+      - osiemdziesiąt
+      - dziewięćdziesiąt
+    hundreds:
+      - ~
+      - sto
+      - dwieście
+      - trzysta
+      - czterysta
+      - pięćset
+      - sześćset
+      - siedemset
+      - osiemset
+      - dziewięćset
+    ranks:
+      - ~
+      -
+        one: tysiąc
+        few: tysiące
+        other: tysięcy
+      -
+        one: milion
+        few: miliony
+        other: milionów
+      -
+        one: miliard
+        few: miliardy
+        other: miliardów
+    cents: "%{basic_phrase} %{cents}/100"

data/lib/papla/version.rb

@@ -1,3 +1,3 @@
 module Papla
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

data/papla.gemspec

@@ -18,6 +18,8 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
+  s.add_dependency 'i18n'
+
   s.add_development_dependency 'rspec', '>= 2.8.0'
   s.add_development_dependency 'rake'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: papla
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,22 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-09 00:00:00.000000000 Z
+date: 2012-01-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: &6025320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *6025320
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &9069800 !ruby/object:Gem::Requirement
+  requirement: &6023880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +32,10 @@ dependencies:
         version: 2.8.0
   type: :development
   prerelease: false
-  version_requirements: *9069800
+  version_requirements: *6023880
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &9069220 !ruby/object:Gem::Requirement
+  requirement: &6021540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *9069220
+  version_requirements: *6021540
 description: Papla is a Ruby gem that allows you to convert numbers into Polish words
   (e.g. 153 into "sto pięćdziesiąt trzy"), including the decimal part as cents and
   currency symbol. Its primary use case are invoices, where the total amount has to
@@ -52,6 +63,9 @@ files:
 - README.md
 - Rakefile
 - lib/papla.rb
+- lib/papla/backend.rb
+- lib/papla/locale/pl.rb
+- lib/papla/locale/pl.yml
 - lib/papla/version.rb
 - papla.gemspec
 - spec/papla_spec.rb