trange_frange 0.1.0

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+README.rdoc
+ChangeLog.rdoc
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/ChangeLog.md

@@ -0,0 +1,3 @@
+### 0.1.0 / 2013-02-03 ###
+
+* Initial release:

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Ninoslav Milenovic
+
+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.md

@@ -0,0 +1,49 @@
+# trange_frange #
+The tool spells out numbers (amounts) in words. It supports serbian language.
+> 12345.67 => 'dvanaest hiljada tri stotine četrdeset pet i 67/100'
+
+## Install ##
+```bash
+$ gem install trange_frange
+```
+
+## Examples ##
+```ruby
+require 'trange_frange'
+amount = TrangeFrange::Amount.new(16345.67)
+amount.spell!
+=> "šesnaest hiljada tri stotine četrdeset pet"
+```
+to include a fraction
+```ruby
+require 'trange_frange'
+amount = TrangeFrange::Amount.new(16345.67)
+amount.spell! show_fraction: true
+=> 'šesnaest hiljada tri stotine četrdeset pet i 67/100'
+```
+to disable spacing between words
+```ruby
+require 'trange_frange'
+amount = TrangeFrange::Amount.new(16345.67)
+amount.spell! squeeze: true
+=> 'šesnaesthiljadatristotinečetrdesetpet'
+```
+to avoid using accented lating characters
+```ruby
+require 'trange_frange'
+amount = TrangeFrange::Amount.new(16345.67)
+amount.spell! bald: true
+=> 'sesnaest hiljada tri stotine cetrdeset pet'
+```
+or combine the options
+```ruby
+require 'trange_frange'
+amount = TrangeFrange::Amount.new(16345.67)
+amount.spell! show_fraction: true, squeeze: true, bald: true
+=> 'sesnaesthiljadatristotinecetrdesetpet i 67/100'
+```
+
+### Copyright ###
+Copyright (c) 2013 Ninoslav Milenovic
+
+See LICENSE.txt for details.

data/Rakefile

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'rake'
+
+begin
+  gem 'rubygems-tasks', '~> 0.2'
+  require 'rubygems/tasks'
+
+  Gem::Tasks.new
+rescue LoadError => e
+  warn e.message
+  warn 'Run `gem install rubygems-tasks` to install Gem::Tasks.'
+end
+
+begin
+  gem 'rdoc', '~> 3.0'
+  require 'rdoc/task'
+
+  RDoc::Task.new do |rdoc|
+    rdoc.title = 'trange_frange'
+  end
+rescue LoadError => e
+  warn e.message
+  warn "Run `gem install rdoc` to install 'rdoc/task'."
+end
+task :doc => :rdoc
+
+begin
+  gem 'rspec', '~> 2.4'
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new
+rescue LoadError => e
+  task :spec do
+    abort 'Please run `gem install rspec` to install RSpec.'
+  end
+end
+
+task :test    => :spec
+task :default => :spec

data/lib/trange_frange.rb

@@ -0,0 +1,333 @@
+# -*- coding: utf-8 -*-
+
+require 'trange_frange/version'
+
+module TrangeFrange
+  class Member < Struct.new :base
+    def one
+      base[-1]
+    end
+
+    def ten
+      base.size >= 2 ? base[-2] : '0'
+    end
+
+    def hundred
+      base.size == 3 ? base[-3] : '0'
+    end
+  end
+
+  class OrderCondition
+    def initialize
+      @conditions = []
+    end
+
+    def add
+      @conditions << Proc.new
+    end
+
+    def match!
+      @conditions.map(&:call).map do |condition| 
+        return condition if condition
+      end
+    end
+
+    private
+      attr_reader :conditions
+  end
+
+  class Base < Struct.new :base
+    # range [10-19]
+    def teen?
+      member.ten == '1'
+    end
+
+    def gender?
+      %w[1 2].include? member.one
+    end
+
+    def member
+      @member ||= TrangeFrange::Member.new base
+    end
+  end
+
+  class Suffix < Struct.new :base
+    def gender?
+      ('2'..'4').include? suffix_base.member.one
+    end
+
+    def one?
+      suffix_base.member.one == '1'
+    end
+
+    def suffix_base
+      @suffix_base ||= TrangeFrange::Base.new base
+    end
+  end
+
+  class One < Struct.new :base, :magnitude
+    ONES = {
+      '0' => '',        # not printed
+      '1' => {
+        :m => 'jedan',  # male gender
+        :f => 'jedna'   # female gender
+      },
+      '2' => {
+        :m => 'dva',
+        :f => 'dve'
+      },
+      '3' => 'tri',
+      '4' => 'četiri',
+      '5' => 'pet',
+      '6' => 'šest',
+      '7' => 'sedam',
+      '8' => 'osam',
+      '9' => 'devet'
+    }
+
+    def word
+      order_condition.add { String.new if one_base.teen? }
+      order_condition.add { ONES[one_base.member.one][gender] if one_base.gender? }
+      order_condition.add { ONES[one_base.member.one] }
+      order_condition.match!
+    end
+
+    private
+
+      def one_base
+        @one_base ||= TrangeFrange::Base.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+
+      def gender
+        magnitude.odd? ? :f : :m
+      end
+ end
+
+  class Ten < Struct.new :base
+    TENS = {
+      '0' => '',
+      '10' => 'deset',
+      '11' => 'jedanaest',
+      '12' => 'dvanaest',
+      '13' => 'trinaest',
+      '14' => 'četrnaest',
+      '15' => 'petnaest',
+      '16' => 'šesnaest',
+      '17' => 'sedamnaest',
+      '18' => 'osamnaest',
+      '19' => 'devetnaest',
+      '2' => 'dvadeset',
+      '3' => 'trideset',
+      '4' => 'četrdeset',
+      '5' => 'pedeset',
+      '6' => 'šezdeset',
+      '7' => 'sedamdeset',
+      '8' => 'osamdeset',
+      '9' => 'devedeset'
+    }
+
+    def word
+      order_condition.add { TENS[teen_base_member] if ten_base.teen? }
+      order_condition.add { TENS[ten_base.member.ten] }
+      order_condition.match!
+    end
+
+    private
+
+      def ten_base
+        @ten_base ||= TrangeFrange::Base.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+
+      def teen_base_member
+        ten_base.member.ten + ten_base.member.one
+      end
+  end
+
+  class Hundred < Struct.new :base
+    HUNDREDS = {
+      '0' => '',
+      '1' => 'jedna stotina',
+      '2' => 'dve stotine',
+      '3' => 'tri stotine',
+      '4' => 'četiri stotine',
+      '5' => 'pet stotina',
+      '6' => 'šest stotina',
+      '7' => 'sedam stotina',
+      '8' => 'osam stotina',
+      '9' => 'devet stotina'
+    }
+
+    def word
+      order_condition.add { HUNDREDS[hundred_base.member.hundred] }
+      order_condition.match!
+    end
+
+    private
+
+      def hundred_base
+        @hundred_base ||= TrangeFrange::Base.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+  end
+
+  class Thousand < Struct.new :base
+    THOUSANDS = %w[hiljada hiljade]
+
+    def word
+      order_condition.add { THOUSANDS[1] if suffix.gender? and !suffix.suffix_base.teen? }
+      order_condition.add { THOUSANDS[0] }
+      order_condition.match!
+    end
+
+    private
+
+      def suffix
+        @suffix ||= TrangeFrange::Suffix.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+  end
+
+  class Milion < Struct.new :base
+    MILIONS = %w[milion miliona]
+
+    def word
+      order_condition.add { MILIONS[0] if suffix.one? and !suffix.suffix_base.teen? }
+      order_condition.add { MILIONS[1] }
+      order_condition.match!
+    end
+
+    private
+
+      def suffix
+        @suffix ||= TrangeFrange::Suffix.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+  end
+
+  class Bilion < Struct.new :base
+    BILIONS = %w[milijarda milijarde milijardi]
+
+    def word
+      order_condition.add { BILIONS[0] if suffix.one? and !suffix.suffix_base.teen? }
+      order_condition.add { BILIONS[1] if suffix.gender? and !suffix.suffix_base.teen? }
+      order_condition.add { BILIONS[2] }
+      order_condition.match!
+    end
+
+    private
+
+      def suffix
+        @suffix ||= TrangeFrange::Suffix.new base
+      end
+
+      def order_condition
+        @order_condition ||= TrangeFrange::OrderCondition.new
+      end
+  end
+
+  class Shaper < Struct.new :words, :fraction, :options
+    OPTIONS = [:bald, :squeeze, :show_fraction]
+
+    def shape!
+      OPTIONS.each { |option| send(option) if options[option] } and return words
+    end
+
+    private
+
+      def show_fraction
+        words << " i #{fraction}/100"
+      end
+
+      def squeeze
+        words.delete!(' ')
+      end
+
+      def bald
+        words.tr!('čćšđž', 'ccsdz')
+      end
+  end
+
+  class Amount
+    attr_reader :amount
+
+    MAX_AMOUNT_SIZE = 12
+    BASES     = [Hundred, Ten, One]
+    SUFFIXES  = [Thousand, Milion, Bilion]
+
+    def initialize(amount)
+      unless amount.is_a?(Fixnum) || amount.is_a?(Float)
+        raise TypeError, 'Amount must be of type Fixnum or Float.'
+      end
+
+      if max_amount_size?(amount)
+        raise NotImplementedError, 'I can only work with amounts up to 999 bilions.'
+      end
+
+      @amount = amount
+    end
+
+    def spell!(options={})
+      TrangeFrange::Shaper.new(generate_words!, fraction, options).shape!
+    end
+
+    private
+
+      def max_amount_size?(amount)
+        amount.to_s.split('.')[0].size > MAX_AMOUNT_SIZE
+      end
+
+      def split!
+        @splitted ||= ('%.2f' % amount).split('.')
+      end
+
+      def whole_number
+        @whole_number ||= split![0]
+      end
+
+      def fraction
+        @fraction ||= split![1]
+      end
+
+      def members
+        @members ||= whole_number.reverse.scan(/.{1,3}/).reverse.map(&:reverse)
+      end
+
+      def generate_base!(member, magnitude)
+        BASES.map do |base|
+          base == One ? base.new(member, magnitude).word : base.new(member).word
+        end.join(' ').strip.squeeze
+      end
+
+      def generate_suffix!(member, magnitude)
+        magnitude > 0 ? SUFFIXES[magnitude.pred].new(member).word : String.new
+      end
+
+      def generate_words!
+        magnitude = members.size.pred
+        Array.new.tap do |words|
+          members.map do |member|
+            words << generate_base!(member, magnitude)
+            words << generate_suffix!(member, magnitude) unless words.last.empty?
+            magnitude -= 1
+          end
+        end.join(' ').strip.squeeze
+      end
+  end
+end

data/lib/trange_frange/version.rb

@@ -0,0 +1,3 @@
+module TrangeFrange
+  VERSION = '0.1.0'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+gem 'rspec', '~> 2.4'
+require 'rspec'
+require 'trange_frange/version'
+
+include TrangeFrange

data/spec/trange_frange_spec.rb

@@ -0,0 +1,541 @@
+# -*- coding: utf-8 -*-
+
+require 'spec_helper'
+require 'trange_frange'
+
+describe TrangeFrange do
+  it 'should have a VERSION constant' do
+    subject.const_get('VERSION').should_not be_empty
+  end
+
+  describe TrangeFrange::Member do
+    let(:base) { TrangeFrange::Member.new '123' }
+
+    describe '#one' do
+      context 'when 123' do
+        specify { base.one.should eq('3') }
+      end
+    end
+
+    describe '#ten' do
+      context 'when 123' do
+        specify { base.ten.should eq('2') }
+      end
+    end
+
+    describe '#hundred' do
+      context 'when 123' do
+        specify { base.hundred.should eq('1') }
+      end
+    end
+  end
+
+  describe TrangeFrange::OrderCondition do
+    let(:order_condition) { OrderCondition.new }
+    before do
+      order_condition.add { nil }
+      order_condition.add { 'content' }
+      order_condition.add { nil }
+    end
+
+    describe '#add' do  
+      specify { order_condition.send(:conditions).class.should eq(Array) }
+      specify do
+        order_condition.send(:conditions).map do |condition| 
+          condition.instance_of?(Proc)
+        end.uniq.should eq([true])
+      end
+      specify do 
+        order_condition.send(:conditions).map(&:call).should match_array([nil, 'content', nil])
+      end
+    end
+
+    describe '#match!' do
+      specify { order_condition.match!.should eq('content') }
+    end
+  end
+
+  describe TrangeFrange::Base do
+    describe '#teen?' do
+      context 'when 123' do
+        let(:base) { TrangeFrange::Base.new '123' }
+        specify { base.teen?.should be_false }
+      end
+
+      context 'when 113' do
+        let(:base) { TrangeFrange::Base.new '113' }
+        specify { base.teen?.should be_true }
+      end
+    end
+
+    describe '#gender?' do
+      context 'when not gender' do
+        let(:non_gender) { Array 3..9 }
+        let(:bases) do 
+          non_gender.map { |non_gender| TrangeFrange::Base.new "12#{non_gender}" }
+        end
+        specify do 
+          bases.each { |base| base.gender?.should be_false }
+        end
+      end
+
+      context 'when gender' do
+        let(:gender) { Array 1..2 }
+        let(:bases) do 
+          gender.map { |gender| TrangeFrange::Base.new "12#{gender}" }
+        end
+        specify do
+          bases.each { |base| base.gender?.should be_true }
+        end
+      end
+    end
+  end
+
+  describe TrangeFrange::Suffix do
+    describe '#gender?' do
+      context 'when gender' do
+        let(:gender) { Array(2..4) }
+        let(:suffixes) do 
+          gender.map { |gender| TrangeFrange::Suffix.new "12#{gender}" }
+        end
+        specify do 
+          suffixes.each { |suffix| suffix.gender?.should be_true }
+        end
+      end
+
+      context 'when not gender' do
+        let(:non_gender) { Array(5..9) << 1 }
+        let(:suffixes) do 
+          non_gender.map { |non_gender| TrangeFrange::Suffix.new "12#{non_gender}" }
+        end
+        specify do 
+          suffixes.each { |suffix| suffix.gender?.should be_false }
+        end
+      end
+    end
+
+    describe '#one?' do
+      context 'when one' do
+        let(:suffix) { TrangeFrange::Suffix.new '121' }
+        specify { suffix.one?.should be_true }
+      end
+
+      context 'when not one' do
+        let(:suffixes) { TrangeFrange::Suffix.new '123' }
+        specify { suffixes.one?.should be_false }
+      end
+    end
+  end
+
+  describe TrangeFrange::One do
+    describe '#gender' do
+      context 'when magnitude is odd' do
+        let(:one) { TrangeFrange::One.new '123', 0 }
+        specify { one.send(:gender).should eq(:m) }
+      end
+
+      context 'when magnitude is even' do
+        let(:one) { TrangeFrange::One.new '123', 1 }
+        specify { one.send(:gender).should eq(:f) }
+      end
+    end
+
+    describe '#word' do
+      context 'when simple' do
+        specify { TrangeFrange::One.new('120', 0).word.should eq(String.new) }
+        specify { TrangeFrange::One.new('123', 1).word.should eq('tri') }
+        specify { TrangeFrange::One.new('124', 2).word.should eq('četiri') }
+        specify { TrangeFrange::One.new('125', 3).word.should eq('pet') }
+        specify { TrangeFrange::One.new('126', 4).word.should eq('šest') }
+        specify { TrangeFrange::One.new('127', 5).word.should eq('sedam') }
+        specify { TrangeFrange::One.new('128', 6).word.should eq('osam') }
+        specify { TrangeFrange::One.new('129', 7).word.should eq('devet') }
+      end
+
+      context 'when gender' do
+        context 'when magnitude is odd' do
+          Array(0..9).select(&:odd?).each do |odd_number|
+            specify { TrangeFrange::One.new('121', odd_number).word.should eq('jedna') }
+            specify { TrangeFrange::One.new('122', odd_number).word.should eq('dve') }
+          end
+        end
+
+        context 'when magnitude is even' do
+          Array(0..9).select(&:even?).each do |even_number|
+            specify { TrangeFrange::One.new('121', even_number).word.should eq('jedan') }
+            specify { TrangeFrange::One.new('122', even_number).word.should eq('dva') }
+          end
+        end
+      end
+
+      context 'when teen' do
+        specify { TrangeFrange::One.new('110', 0).word.should be_empty }
+        specify { TrangeFrange::One.new('111', 0).word.should be_empty }
+        specify { TrangeFrange::One.new('112', 1).word.should be_empty }
+        specify { TrangeFrange::One.new('113', 2).word.should be_empty }
+        specify { TrangeFrange::One.new('114', 3).word.should be_empty }
+        specify { TrangeFrange::One.new('115', 4).word.should be_empty }
+        specify { TrangeFrange::One.new('116', 5).word.should be_empty }
+        specify { TrangeFrange::One.new('117', 6).word.should be_empty }
+        specify { TrangeFrange::One.new('118', 7).word.should be_empty }
+        specify { TrangeFrange::One.new('119', 2).word.should be_empty }
+      end
+    end
+  end
+
+  describe TrangeFrange::Ten do
+    describe 'private #teen_base_member' do
+      specify do
+        TrangeFrange::Ten.new('103').send(:teen_base_member).should eq('03')
+      end
+      specify do 
+        TrangeFrange::Ten.new('113').send(:teen_base_member).should eq('13')
+      end
+      specify do 
+        TrangeFrange::Ten.new('123').send(:teen_base_member).should eq('23')
+      end
+    end
+
+    describe '#word' do
+      context 'when simple' do
+        specify { TrangeFrange::Ten.new('103').word.should eq(String.new) }
+        specify { TrangeFrange::Ten.new('123').word.should eq('dvadeset') }
+        specify { TrangeFrange::Ten.new('134').word.should eq('trideset') }
+        specify { TrangeFrange::Ten.new('145').word.should eq('četrdeset') }
+        specify { TrangeFrange::Ten.new('156').word.should eq('pedeset') }
+        specify { TrangeFrange::Ten.new('167').word.should eq('šezdeset') }
+        specify { TrangeFrange::Ten.new('178').word.should eq('sedamdeset') }
+        specify { TrangeFrange::Ten.new('189').word.should eq('osamdeset') }
+        specify { TrangeFrange::Ten.new('199').word.should eq('devedeset') }
+      end
+
+      context 'when teen' do
+        specify { TrangeFrange::Ten.new('111').word.should eq('jedanaest') }
+        specify { TrangeFrange::Ten.new('112').word.should eq('dvanaest') }
+        specify { TrangeFrange::Ten.new('113').word.should eq('trinaest') }
+        specify { TrangeFrange::Ten.new('114').word.should eq('četrnaest') }
+        specify { TrangeFrange::Ten.new('115').word.should eq('petnaest') }
+        specify { TrangeFrange::Ten.new('116').word.should eq('šesnaest') }
+        specify { TrangeFrange::Ten.new('117').word.should eq('sedamnaest') }
+        specify { TrangeFrange::Ten.new('118').word.should eq('osamnaest') }
+        specify { TrangeFrange::Ten.new('119').word.should eq('devetnaest') }
+      end
+    end
+  end
+
+  describe TrangeFrange::Hundred do
+    describe '#word' do
+      specify { TrangeFrange::Hundred.new('013').word.should eq(String.new) }
+      specify { TrangeFrange::Hundred.new('113').word.should eq('jedna stotina') }
+      specify { TrangeFrange::Hundred.new('223').word.should eq('dve stotine') }
+      specify { TrangeFrange::Hundred.new('334').word.should eq('tri stotine') }
+      specify { TrangeFrange::Hundred.new('445').word.should eq('četiri stotine') }
+      specify { TrangeFrange::Hundred.new('556').word.should eq('pet stotina') }
+      specify { TrangeFrange::Hundred.new('667').word.should eq('šest stotina') }
+      specify { TrangeFrange::Hundred.new('778').word.should eq('sedam stotina') }
+      specify { TrangeFrange::Hundred.new('889').word.should eq('osam stotina') }
+      specify { TrangeFrange::Hundred.new('999').word.should eq('devet stotina') }
+    end
+  end
+
+  describe TrangeFrange::Thousand do
+    describe '#word' do
+      context 'when gender' do
+        context 'when teen' do
+          specify { TrangeFrange::Thousand.new('112').word.should eq('hiljada') }
+          specify { TrangeFrange::Thousand.new('113').word.should eq('hiljada') }
+          specify { TrangeFrange::Thousand.new('114').word.should eq('hiljada') }
+        end
+
+        context 'when not teen' do
+          specify { TrangeFrange::Thousand.new('122').word.should eq('hiljade') }
+          specify { TrangeFrange::Thousand.new('123').word.should eq('hiljade') }
+          specify { TrangeFrange::Thousand.new('124').word.should eq('hiljade') }
+        end
+      end
+
+      context 'when simple non gender teen' do
+        specify { TrangeFrange::Thousand.new('110').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('111').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('115').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('116').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('117').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('118').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('119').word.should eq('hiljada') }
+      end
+
+      context 'when simple non gender not teen' do
+        specify { TrangeFrange::Thousand.new('120').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('231').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('345').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('456').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('567').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('678').word.should eq('hiljada') }
+        specify { TrangeFrange::Thousand.new('789').word.should eq('hiljada') }
+      end
+    end
+  end
+
+  describe TrangeFrange::Milion do
+    describe '#word' do
+      context 'when one' do
+        context 'when not teen' do
+          specify { TrangeFrange::Milion.new('101').word.should eq('milion') }
+          specify { TrangeFrange::Milion.new('121').word.should eq('milion') }
+        end
+      end
+
+      context 'when other' do
+        specify { TrangeFrange::Milion.new('110').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('111').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('112').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('123').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('134').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('145').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('156').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('167').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('178').word.should eq('miliona') }
+        specify { TrangeFrange::Milion.new('189').word.should eq('miliona') }
+      end
+    end
+  end
+
+  describe TrangeFrange::Bilion do
+    describe '#word' do
+      context 'when one' do
+        context 'when not teen' do
+          specify { TrangeFrange::Bilion.new('101').word.should eq('milijarda') }
+          specify { TrangeFrange::Bilion.new('121').word.should eq('milijarda') }
+        end
+      end
+
+      context 'when gender' do
+        context 'when not teen' do
+          specify { TrangeFrange::Bilion.new('102').word.should eq('milijarde') }
+          specify { TrangeFrange::Bilion.new('123').word.should eq('milijarde') }
+          specify { TrangeFrange::Bilion.new('134').word.should eq('milijarde') }
+        end
+      end
+
+      context 'when other' do
+        specify { TrangeFrange::Bilion.new('110').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('111').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('112').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('145').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('156').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('167').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('178').word.should eq('milijardi') }
+        specify { TrangeFrange::Bilion.new('189').word.should eq('milijardi') }
+      end
+    end
+  end
+
+  describe TrangeFrange::Shaper do
+    let!(:words) { 'jedna stotina dvadeset tri hiljade četiri stotine pedeset šest' }
+
+    specify do 
+      TrangeFrange::Shaper.new(words, 75, {}).shape!.should \
+        eq('jedna stotina dvadeset tri hiljade četiri stotine pedeset šest')
+    end
+    specify do 
+      TrangeFrange::Shaper.new(words, 75, show_fraction: true).shape!.should \
+        eq("jedna stotina dvadeset tri hiljade četiri stotine pedeset šest i 75/100")
+    end
+    specify do 
+      TrangeFrange::Shaper.new(words, 75, show_fraction: true, squeeze: true).shape!.should \
+        eq("jednastotinadvadesettrihiljadečetiristotinepedesetšest i 75/100")
+    end
+    specify do 
+      TrangeFrange::Shaper.new(words, 75, show_fraction: true, squeeze: true, bald: true).shape!.should \
+        eq("jednastotinadvadesettrihiljadecetiristotinepedesetsest i 75/100")
+    end
+  end
+
+  describe TrangeFrange::Amount do
+    describe '#amount' do
+      context 'when valid amount' do
+        specify do
+          amount = TrangeFrange::Amount.new 123
+          amount.amount.should eq(123)
+        end
+
+        specify do
+          amount = TrangeFrange::Amount.new 123.45
+          amount.amount.should eq(123.45)
+        end
+      end
+
+      context 'when invalid amount' do
+        specify 'raise an exception' do
+          expect { TrangeFrange::Amount.new('123') }.to \
+            raise_error(TypeError, 'Amount must be of type Fixnum or Float.')
+        end
+        specify 'raise an exception' do
+          expect { TrangeFrange::Amount.new(1234657981234) }.to \
+            raise_error(NotImplementedError, 'I can only work with amounts up to 999 bilions.')
+        end
+      end
+    end
+
+    describe '#spell!' do
+      context 'when valid amount' do
+        context 'when options are ommited' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!.should eq('jedna stotina dvadeset tri hiljade četiri stotine pedeset šest')
+          end
+        end
+
+        context 'when `show_fraction` option is true' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!(show_fraction: true).should eq('jedna stotina dvadeset tri hiljade četiri stotine pedeset šest i 78/100')
+          end
+        end
+
+        context 'when `show_fraction` option is false' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!(show_fraction: false).should eq('jedna stotina dvadeset tri hiljade četiri stotine pedeset šest')
+          end
+        end
+
+        context 'when `squeeze` option is true' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!(squeeze: true).should eq('jednastotinadvadesettrihiljadečetiristotinepedesetšest')
+          end
+        end
+
+        context 'when `bald` option is true' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!(bald: true).should eq('jedna stotina dvadeset tri hiljade cetiri stotine pedeset sest')
+          end
+        end
+
+        context 'when options are combined' do
+          specify do
+            amount = TrangeFrange::Amount.new 123456.78
+            amount.spell!(show_fraction: true, squeeze: true, bald: true).should \
+              eq('jednastotinadvadesettrihiljadecetiristotinepedesetsest i 78/100')
+          end
+        end
+
+        specify do
+          amount = TrangeFrange::Amount.new 1
+          amount.spell!(show_fraction: true).should eq('jedan i 00/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 12.34
+          amount.spell!(show_fraction: true).should eq('dvanaest i 34/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 123.45
+          amount.spell!(show_fraction: true).should eq('jedna stotina dvadeset tri i 45/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 1234.56
+          amount.spell!(show_fraction: true).should eq('jedna hiljada dve stotine trideset četiri i 56/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 12345.67
+          amount.spell!(show_fraction: true).should eq('dvanaest hiljada tri stotine četrdeset pet i 67/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 123456.78
+          amount.spell!(show_fraction: true).should eq('jedna stotina dvadeset tri hiljade četiri stotine pedeset šest i 78/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 1234567.89
+          amount.spell!(show_fraction: true).should eq('jedan milion dve stotine trideset četiri hiljade pet stotina šezdeset sedam i 89/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 12345678
+          amount.spell!(show_fraction: true).should eq('dvanaest miliona tri stotine četrdeset pet hiljada šest stotina sedamdeset osam i 00/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 123456789
+          amount.spell!(show_fraction: true).should eq('jedna stotina dvadeset tri miliona četiri stotine pedeset šest hiljada sedam stotina osamdeset devet i 00/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 1234567890
+          amount.spell!(show_fraction: true).should eq('jedna milijarda dve stotine trideset četiri miliona pet stotina šezdeset sedam hiljada osam stotina devedeset i 00/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 12345678901
+          amount.spell!(show_fraction: true).should eq('dvanaest milijardi tri stotine četrdeset pet miliona šest stotina sedamdeset osam hiljada devet stotina jedan i 00/100')
+        end
+        specify do
+          amount = TrangeFrange::Amount.new 123456789012
+          amount.spell!(show_fraction: true).should eq('jedna stotina dvadeset tri milijarde četiri stotine pedeset šest miliona sedam stotina osamdeset devet hiljada dvanaest i 00/100')
+        end
+      end
+    end
+
+    describe 'PRIVATE' do
+      describe '#split!' do
+        specify do
+          amount = TrangeFrange::Amount.new 12345
+          amount.send(:split!).should eq(['12345', '00'])
+        end
+
+        specify do
+          amount = TrangeFrange::Amount.new 12345.67
+          amount.send(:split!).should eq(['12345', '67'])
+        end
+
+        specify do
+          amount = TrangeFrange::Amount.new 12345.678
+          amount.send(:split!).should eq(['12345', '68'])
+        end
+      end
+
+      describe '#whole_number' do
+        specify { TrangeFrange::Amount.new(12345.67).send(:whole_number).should eq('12345') }
+      end
+
+      describe '#fraction' do
+        specify { TrangeFrange::Amount.new(12345.678).send(:fraction).should eq('68') }
+      end
+
+      describe '#generate_base!' do
+        specify do
+          amount = TrangeFrange::Amount.new 123
+          amount.send(:generate_base!, '123', 0).should \
+            eq('jedna stotina dvadeset tri')
+        end
+      end
+
+      describe '#generate_suffix!' do
+        context 'when magnitude is greater than zero' do
+          specify do
+            amount = TrangeFrange::Amount.new 123000
+            amount.send(:generate_suffix!, '123', 1).should eq('hiljade')
+          end
+        end
+
+        context 'when magnitude is zero' do
+          specify do
+            amount = TrangeFrange::Amount.new 123
+            amount.send(:generate_suffix!, '123', 0).should eq(String.new)
+          end
+        end
+      end
+
+      describe '#members' do
+        specify do
+          amount = TrangeFrange::Amount.new 1234567.89
+          amount.send(:members).should match_array(['1', '234', '567'])
+        end
+      end
+
+      describe '#generate_words' do
+        specify do
+          amount = TrangeFrange::Amount.new 12345.67
+          amount.send(:generate_words!).should eq('dvanaest hiljada tri stotine četrdeset pet')
+        end
+      end
+    end
+  end
+end

data/trange_frange.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path('../lib/trange_frange/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name          = 'trange_frange'
+  gem.version       = TrangeFrange::VERSION
+  gem.summary       = %q{Tool for spelling amounts}
+  gem.description   = %q{The tool spells out numbers (amounts) in words. It supports serbian language.}
+  gem.license       = 'MIT'
+  gem.authors       = ['Ninoslav Milenovic']
+  gem.email         = 'nino.mil@gmail.com'
+  gem.homepage      = 'https://github.com/pythogorian/trange_frange#readme'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_development_dependency 'rdoc', '~> 3.0'
+  gem.add_development_dependency 'rspec', '~> 2.4'
+  gem.add_development_dependency 'rubygems-tasks', '~> 0.2'
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: trange_frange
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Ninoslav Milenovic
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: The tool spells out numbers (amounts) in words. It supports serbian language.
+email: nino.mil@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .document
+- .gitignore
+- .rspec
+- ChangeLog.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/trange_frange.rb
+- lib/trange_frange/version.rb
+- spec/spec_helper.rb
+- spec/trange_frange_spec.rb
+- trange_frange.gemspec
+homepage: https://github.com/pythogorian/trange_frange#readme
+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.24
+signing_key: 
+specification_version: 3
+summary: Tool for spelling amounts
+test_files:
+- spec/spec_helper.rb
+- spec/trange_frange_spec.rb