numbers_and_words 0.3.0

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011-2012 Kirill Lazarev
+
+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,68 @@
+== numbers_and_words {<img src="https://secure.travis-ci.org/kslazarev/numbers_and_words.png" />}[http://travis-ci.org/kslazarev/numbers_and_words]
+
+Convert numbers to words using the I18n library.
+
+Перевод чисел в слова при помощи библиотеки I18n.
+
+== Supported Languages / Языки
+
+* English
+* Русский
+
+== Examples / Примеры
+
+    I18n.with_locale(:en) { 42.to_words }
+    => "forty-two"
+
+    I18n.with_locale(:ru) { 42.to_words }
+    => "сорок два"
+
+    21.to_words
+    => "twenty-one"
+    => "двадцать один"
+
+    231.to_words
+    => "two hundred thirty-one"
+    => "двести тридцать один"
+
+    4030.to_words
+    => "four thousand thirty"
+    => "четыре тысячи тридцать"
+
+    1000100.to_words
+    => "one million one hundred"
+    => "один миллион сто"
+
+    1000000000000000000000000000000000.to_words
+    => "one decillion"
+    => "один дециллион"
+
+    [1, 2, 3].to_words
+    => ["one", "two", "three"]
+    => ["один", "два", "три"]
+
+    [11, 22, 133].to_words
+    => ["eleven", "twenty-two", "one hundred thirty-three"] 
+    => ["одиннадцать", "двадцать два", "сто тридцать три"]
+ 
+== Requirements / Требования
+
+* 1.8.7 <= Ruby (compatible with/совместимость с Ruby 1.9, JRuby and/и Rubinius);
+* 0.5.0 <= I18n (earlier versions not tested/ранние версии не тестировались);
+
+== Installation / Установка
+
+    gem install numbers_and_words
+
+== License / Лицензия
+
+MIT License
+
+== Bugs and Language Support / Поправки и Новые Языки
+
+Fork the project. Make your feature addition or bug fix with tests. Send a pull request. Bonus points for topic branches.
+
+== Contacts / Контакты
+
+* Kirill Lazarev (mailto:k.s.lazarev@gmail.com)
+* Daniel Doubrovkine (link:http://github.com/dblock)

data/lib/initializers/i18n.rb

@@ -0,0 +1,2 @@
+require "i18n/backend/pluralization"
+I18n::Backend::Simple.send(:include, I18n::Backend::Pluralization)

data/lib/locales/numbers.en.yml

@@ -0,0 +1,7 @@
+en:
+  numbers:
+    ones: [zero, one, two, three, four, five, six, seven, eight, nine]
+    teens: [ten, eleven, twelve, thirteen, fourteen, fifteen, sixteen, seventeen, eighteen, nineteen]
+    tens: [zero, ten, twenty, thirty, forty, fifty, sixty, seventy, nought, ninety]
+    hundreds: hundred
+    mega: [ones, thousand, million, billion, trillion, quadrillion, quintillion, sextillion, septillion, octillion, nonillion, decillion]

data/lib/locales/numbers.ru.yml

@@ -0,0 +1,52 @@
+ru:
+  numbers:
+    ones_male: [ноль, один, два, три, четыре, пять, шесть, семь, восемь, девять]
+    ones_female: [ноль, однa, двe, три, четыре, пять, шесть, семь, восемь, девять]
+    teens: [десять, одиннадцать, двенадцать, тринадцать, четырнадцать, пятнадцать, шестнадцать, семнадцать, восемнадцать, девятнадцать]
+    tens: [ноль, десять, двадцать, тридцать, сорок, пятьдесят, шестьдесят, семьдесят, восемьдесят, девяносто]
+    hundreds: [ноль, сто, двести, триста, четыреста, пятьсот, шестьсот, семьсот, восемьсот, девятьсот]
+    thousands:
+      one: тысяча
+      few: тысячи
+      many: тысяч
+    millions:
+      one: миллион
+      few: миллиона
+      many: миллионов
+    billions:
+      one: миллиард
+      few: миллиарда
+      many: миллиардов
+    trillions:
+      one: триллион
+      few: триллионa
+      many: триллионов
+    quadrillions:
+      one: квадриллион
+      few: квадриллиона
+      many: квадриллионов
+    quintillions:
+      one: квинтиллион
+      few: квинтиллиона
+      many: квинтиллионов
+    sextillions:
+      one: секстиллион
+      few: секстиллиона
+      many: секстиллионов
+    septillions:
+      one: септиллион
+      few: секстиллиона
+      many: секстиллионов
+    octillions:
+      one: октиллион
+      few: октиллиона
+      many: октиллионов
+    nonillions:
+      one: нониллион
+      few: нониллиона
+      many: нониллионов
+    decillions:
+      one: дециллион
+      few: дециллиона
+      many: дециллионов
+    mega: [ones, thousands, millions, billions, trillions, quadrillions, quintillion, sextillions, septillions, octillions, nonillions, decillions]

data/lib/locales/plurals.rb

@@ -0,0 +1,30 @@
+module NumbersAndWords
+  module Locales
+    module Plurals
+
+      RU = lambda do |count|
+        case count
+        when Integer
+          case
+          when 1 == count
+            :one
+          when (2..4).include?(count)
+            :few
+          else
+            :many
+          end
+        else
+          :other
+        end
+      end
+
+      EN = lambda { |count| 1 == count ? :one : :other }
+
+    end
+  end
+end
+
+{
+  :ru => {:i18n => {:plural => {:rule => NumbersAndWords::Locales::Plurals::RU}}},
+  :en => {:i18n => {:plural => {:rule => NumbersAndWords::Locales::Plurals::EN}}}
+}

data/lib/numbers_and_words.rb

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'i18n'
+require 'initializers/i18n'
+require 'active_support/inflector'
+
+require 'numbers_and_words/version'
+
+require 'numbers_and_words/translations_helpers'
+require 'numbers_and_words/strategies'
+require 'numbers_and_words/array_additions'
+require 'numbers_and_words/figures_array'
+
+require 'numbers_and_words/core_ext/integer'
+require 'numbers_and_words/core_ext/array'
+
+module NumbersAndWords
+  module I18nInitialization
+    extend self
+
+    def init
+      locale_files.each { |locale_file| I18n.load_path << locale_file }
+    end
+
+    def locale_files
+      Dir[File.join(File.dirname(__FILE__), 'locales', '**/*')]
+    end
+  end
+end
+
+NumbersAndWords::I18nInitialization.init

data/lib/numbers_and_words/array_additions.rb

@@ -0,0 +1,2 @@
+require 'numbers_and_words/array_additions/helpers'
+require 'numbers_and_words/array_additions/validations'

data/lib/numbers_and_words/array_additions/helpers.rb

@@ -0,0 +1,50 @@
+module NumbersAndWords
+  module ArrayAdditions
+    module Helpers
+      THOUSAND_CAPACITY = 1
+
+      def capacity_count
+        count = (self.length.to_f / 3).ceil
+        1 == count ? nil : count
+      end
+
+      def figures_array_in_capacity capacity
+        self[capacity * 3, 3]
+      end
+
+      def number_in_capacity capacity
+        figures_array_in_capacity(capacity).reverse.join.to_i
+      end
+
+      def number_for_gender capacity
+        figures = figures_array_in_capacity(capacity)
+        teens = figures.teens
+        teens ? teens.join.to_i : figures.first
+      end
+
+      def is_a_thousand_capacity? capacity
+        THOUSAND_CAPACITY == capacity
+      end
+
+      def ones
+        self[0] if 0 < self[0].to_i
+      end
+
+      def teens
+        tens_with_ones if 1 == tens
+      end
+
+      def tens
+        self[1] if self[1] and 0 < self[1].to_i
+      end
+
+      def tens_with_ones
+        [ones, tens] if ones and tens
+      end
+
+      def hundreds
+        self[2] if 0 < self[2].to_i
+      end
+    end
+  end
+end

data/lib/numbers_and_words/array_additions/validations.rb

@@ -0,0 +1,9 @@
+module NumbersAndWords
+  module ArrayAdditions
+    module Validations
+      def validate_figure_array!
+
+      end
+    end
+  end
+end

data/lib/numbers_and_words/core_ext/array.rb

@@ -0,0 +1,9 @@
+class Array
+  def to_words
+    map &:to_words
+  end
+
+  def to_figures
+    NumbersAndWords::FiguresArray.new self
+  end
+end

data/lib/numbers_and_words/core_ext/integer.rb

@@ -0,0 +1,12 @@
+class Integer
+
+  def to_words
+    to_figures_array.to_words NumbersAndWords::Strategies::Base.factory
+  end
+
+  private
+
+  def to_figures_array
+    to_s.split(//).map(&:to_i).to_figures
+  end
+end

data/lib/numbers_and_words/figures_array.rb

@@ -0,0 +1,15 @@
+module NumbersAndWords
+  class FiguresArray < Array
+    include NumbersAndWords::ArrayAdditions::Helpers
+    include NumbersAndWords::ArrayAdditions::Validations
+
+    def to_words strategy, options = nil
+      validate_figure_array!
+      strategy.convert self
+    end
+
+    def reverse
+      super.to_figures
+    end
+  end
+end

data/lib/numbers_and_words/pluralization.rb

@@ -0,0 +1,2 @@
+require "i18n/backend/pluralization"
+I18n::Backend::Simple.send(:include, I18n::Backend::Pluralization)

data/lib/numbers_and_words/strategies.rb

@@ -0,0 +1,3 @@
+require 'numbers_and_words/strategies/base'
+require 'numbers_and_words/strategies/ru'
+require 'numbers_and_words/strategies/en'

data/lib/numbers_and_words/strategies/base.rb

@@ -0,0 +1,11 @@
+module NumbersAndWords
+  module Strategies
+    class Base
+      attr_accessor :figures, :words
+
+      def self.factory
+        "NumbersAndWords::Strategies::#{I18n.locale.to_s.titleize}".constantize.new
+      end
+    end
+  end
+end

data/lib/numbers_and_words/strategies/en.rb

@@ -0,0 +1,71 @@
+module NumbersAndWords
+  module Strategies
+    class En < Base
+      include NumbersAndWords::TranslationsHelpers::En
+  
+      attr_accessor :figures_in_previous_capacity
+  
+      def convert figures
+        @figures = figures.reverse
+  
+        @words = strings
+        @words.empty? ? zero : @words.reverse.join(' ')
+      end
+  
+      private
+  
+      def strings
+        if figures.capacity_count
+          complex_to_words
+        elsif figures.hundreds
+          simple_hundreds_to_words
+        elsif figures.tens or figures.ones
+          simple_to_words
+        else
+          []
+        end
+      end
+  
+      def complex_to_words
+        words = []
+        figures.capacity_count.times do |capacity|
+          number_in_capacity_by_words = save_parent_figures do |parent_figures|
+            @figures = parent_figures.figures_array_in_capacity(capacity)
+            strings
+          end
+  
+          unless number_in_capacity_by_words.empty?
+            words.push translation_megs(capacity) if 0 < capacity
+            words += number_in_capacity_by_words
+          end
+        end
+        words
+      end
+  
+      def simple_hundreds_to_words
+        simple_to_words + [translation_hundreds(figures.hundreds)]
+      end
+  
+      def simple_to_words
+        if figures.teens
+          [translation_teens(figures.ones)]
+        elsif figures.tens
+          figures.ones ?
+            [translation_tens_with_ones(figures.tens_with_ones)] :
+            [translation_tens(figures.tens)]
+        elsif figures.ones
+          [translation_ones(figures.ones)]
+        else
+          []
+        end
+      end
+  
+      def save_parent_figures
+        parent_figures = @figures
+        result = yield(parent_figures)
+        @figures = parent_figures
+        result
+      end
+    end
+  end
+end

data/lib/numbers_and_words/strategies/ru.rb

@@ -0,0 +1,71 @@
+module NumbersAndWords
+  module Strategies
+    class Ru < Base
+      include NumbersAndWords::TranslationsHelpers::Ru
+
+      def convert figures
+        @figures = figures.reverse
+        @words = strings
+
+        @words.empty? ? zero : @words.reverse.join(' ')
+      end
+
+      private
+
+      def strings gender = :male
+        if figures.capacity_count
+          complex_to_words
+        elsif figures.hundreds
+          simple_hundreds_to_words gender
+        elsif figures.tens or figures.ones
+          simple_to_words gender
+        else
+          []
+        end
+      end
+
+      def complex_to_words
+        words = []
+        figures.capacity_count.times do |capacity|
+          number_in_capacity_by_words = save_parent_figures do
+            @figures = figures.figures_array_in_capacity(capacity)
+            strings figures.is_a_thousand_capacity?(capacity) ? :female : :male
+          end
+
+          unless number_in_capacity_by_words.empty?
+            if 0 < capacity
+              words.push translation_megs(capacity, figures.number_for_gender(capacity))
+            end
+            words += number_in_capacity_by_words
+          end
+        end
+        words
+      end
+
+      def simple_hundreds_to_words gender
+        simple_to_words(gender) + [translation_hundreds(figures.hundreds)]
+      end
+
+      def simple_to_words gender
+        if figures.teens
+          [translation_teens(figures.ones)]
+        elsif figures.tens
+          figures.ones ?
+            [translation_tens_with_ones(figures.tens_with_ones, gender)] :
+            [translation_tens(figures.tens)]
+        elsif figures.ones
+          [translation_ones(figures.ones, gender)]
+        else
+          []
+        end
+      end
+
+      def save_parent_figures
+        parent_figures = @figures
+        result = yield
+        @figures = parent_figures
+        result
+      end
+    end
+  end
+end

data/lib/numbers_and_words/translations_helpers.rb

@@ -0,0 +1,3 @@
+require 'numbers_and_words/translations_helpers/base'
+require 'numbers_and_words/translations_helpers/ru'
+require 'numbers_and_words/translations_helpers/en'

data/lib/numbers_and_words/translations_helpers/base.rb

@@ -0,0 +1,11 @@
+module NumbersAndWords
+  module TranslationsHelpers
+    module Base
+      I18N_NAMESPACE = :numbers
+
+      def t attribute, options = {}
+        I18n.t attribute, options.merge(:scope => I18N_NAMESPACE)
+      end
+    end
+  end
+end

data/lib/numbers_and_words/translations_helpers/en.rb

@@ -0,0 +1,41 @@
+module NumbersAndWords
+  module TranslationsHelpers
+    module En
+      include NumbersAndWords::TranslationsHelpers::Base
+
+      private
+
+      def translation_teens number
+        t(:teens)[number]
+      end
+
+      def translation_tens number
+        t(:tens)[number]
+      end
+
+      def translation_ones number
+        t(:ones)[number]
+      end
+
+      def translation_tens_with_ones numbers
+        [translation_tens(numbers[1]), translation_ones(numbers[0])].join '-'
+      end
+
+      def translation_union
+        t :union
+      end
+
+      def translation_hundreds number
+        [t(:ones)[number], t(:hundreds)].join ' '
+      end
+
+      def translation_megs capacity
+        t(:mega)[capacity]
+      end
+      
+      def zero
+        t(:ones)[0]
+      end
+    end
+  end
+end

data/lib/numbers_and_words/translations_helpers/ru.rb

@@ -0,0 +1,41 @@
+module NumbersAndWords
+  module TranslationsHelpers
+    module Ru
+      include NumbersAndWords::TranslationsHelpers::Base
+
+      private
+
+      def translation_megs capacity, number
+        t translation_mega(capacity), :count => number
+      end
+
+      def translation_teens number
+        t(:teens)[number]
+      end
+
+      def translation_tens number
+        t(:tens)[number]
+      end
+
+      def translation_ones number, gender
+        t([:ones, gender].join('_'))[number]
+      end
+
+      def translation_tens_with_ones numbers, gender
+        [translation_tens(numbers[1]), translation_ones(numbers[0], gender)].join ' '
+      end
+
+      def translation_hundreds number
+        t(:hundreds)[number]
+      end
+
+      def translation_mega capacity
+        t(:mega)[capacity]
+      end
+
+      def zero
+        t(:ones_male)[0]
+      end
+    end
+  end
+end

data/lib/numbers_and_words/version.rb

@@ -0,0 +1,3 @@
+module NumbersAndWords
+  VERSION = '0.3.0'
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: numbers_and_words
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+  prerelease: 
+platform: ruby
+authors:
+- Kirill Lazarev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Convert numbers to words using I18N.
+email: k.s.lazarev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- lib/initializers/i18n.rb
+- lib/locales/numbers.en.yml
+- lib/locales/numbers.ru.yml
+- lib/locales/plurals.rb
+- lib/numbers_and_words.rb
+- lib/numbers_and_words/array_additions.rb
+- lib/numbers_and_words/array_additions/helpers.rb
+- lib/numbers_and_words/array_additions/validations.rb
+- lib/numbers_and_words/core_ext/array.rb
+- lib/numbers_and_words/core_ext/integer.rb
+- lib/numbers_and_words/figures_array.rb
+- lib/numbers_and_words/pluralization.rb
+- lib/numbers_and_words/strategies.rb
+- lib/numbers_and_words/strategies/base.rb
+- lib/numbers_and_words/strategies/en.rb
+- lib/numbers_and_words/strategies/ru.rb
+- lib/numbers_and_words/translations_helpers.rb
+- lib/numbers_and_words/translations_helpers/base.rb
+- lib/numbers_and_words/translations_helpers/en.rb
+- lib/numbers_and_words/translations_helpers/ru.rb
+- lib/numbers_and_words/version.rb
+- LICENSE.txt
+- README.rdoc
+homepage: http://github.com/kslazarev/numbers_and_words
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Convert numbers to words using I18N.
+test_files: []