ru_propisju 1.0.0

data/History.txt

@@ -0,0 +1,4 @@
+=== 1.0.0 / 2011-03-18
+
+* Модуль вынут из RuTils
+

data/Manifest.txt

@@ -0,0 +1,6 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+lib/ru_propisju.rb
+test/test_ru_propisju.rb

data/README.rdoc

@@ -0,0 +1,48 @@
+= ru_propisju
+
+* http://github.com/julik/ru_propisju
+
+== DESCRIPTION:
+
+Выводит сумму прописью и суммы копеек, рублей и гривен. Помогает в выборе правильного числительного.
+
+== FEATURES/PROBLEMS:
+
+Прекрасность.
+
+== SYNOPSIS:
+
+  RuPropisju.propisju_shtuk(212.40, 2, "сволочь", "сволочи", "сволочей") #=> "двести двенадцать целых четыре десятых сволочи"
+
+== REQUIREMENTS:
+
+* Прямые руки
+
+== INSTALL:
+
+sudo gem install ru_propisju
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 me@julik.nl
+
+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/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'ru_propisju' do | p |
+  p.readme_file = 'README.rdoc'
+  p.extra_rdoc_files  = FileList['*.rdoc'] + FileList['*.txt']
+  
+  p.developer('Julik Tarkhanov', 'me@julik.nl')
+end
+
+# vim: syntax=ruby

data/lib/ru_propisju.rb

@@ -0,0 +1,269 @@
+# -*- encoding: utf-8 -*- 
+$KCODE = 'u' if RUBY_VERSION < '1.9.0'
+
+# Самый лучший, прекрасный, кривой и неотразимый суперпечататель суммы прописью для Ruby.
+#
+#   RuPropisju.rublej(123) # "сто двадцать три рубля"
+module RuPropisju
+  
+  VERSION = '1.0.0'
+  
+  # Выбирает нужный падеж существительного в зависимости от числа
+  #
+  #   choose_plural(3, "штука", "штуки", "штук") #=> "штуки"
+  def choose_plural(amount, *variants)
+    mod_ten = amount % 10
+    mod_hundred = amount % 100
+    variant = if (mod_ten == 1 && mod_hundred != 11) 
+        1
+    else
+      if mod_ten >= 2 && mod_ten <= 4 && (mod_hundred <10 || mod_hundred % 100>=20)
+        2
+      else
+        3
+      end
+    end
+    variants[variant-1]
+  end
+  
+  
+  # Выводит целое или дробное число как сумму в рублях прописью
+  #
+  #   rublej(345.2) #=> "триста сорок пять рублей двадцать копеек"
+  def rublej(amount)
+    pts = []
+    
+    pts << propisju_shtuk(amount.to_i, 1, "рубль", "рубля", "рублей") unless amount.to_i == 0
+    
+    if amount.kind_of?(Float)
+      remainder = (amount.divmod(1)[1]*100).round
+      if (remainder == 100)
+        pts = [propisju_shtuk(amount.to_i+1, 1, 'рубль', 'рубля', 'рублей')]
+      else
+        pts << propisju_shtuk(remainder.to_i, 2, 'копейка', 'копейки', 'копеек') unless remainder.to_i.zero?
+      end
+    end
+    
+    pts.join(' ')
+  end
+  
+  # Выбирает корректный вариант числительного в зависимости от рода и числа и оформляет сумму прописью
+  #
+  #   propisju(243) => "двести сорок три"
+  #   propisju(221, 2) => "двести двадцать одна"
+  def propisju(amount, gender = 1)
+    if amount.is_a?(Integer) || amount.is_a?(Bignum)
+      propisju_int(amount, gender)
+    else # также сработает для Decimal, дробные десятичные числительные в долях поэтому женского рода
+      propisju_float(amount)
+    end
+  end
+  
+  # Выводит целое или дробное число как сумму в гривнах прописью
+  #
+  #  griven(32) #=> "тридцать две гривны"
+  def griven(amount)
+    pts = []
+
+    pts << propisju_int(amount.to_i, 2, "гривна", "гривны", "гривен") unless amount.to_i == 0
+    if amount.kind_of?(Float)
+      remainder = (amount.divmod(1)[1]*100).round
+      if (remainder == 100)
+        pts = [propisju_int(amount.to_i + 1, 2, 'гривна', 'гривны', 'гривен')]
+      else
+        pts << propisju_int(remainder.to_i, 2, 'копейка', 'копейки', 'копеек')
+      end
+    end
+    
+    pts.join(' ')
+  end
+  
+  # Выводит сумму прописью в рублях по количеству копеек
+  #
+  #  kopeek(343) #=> "три рубля сорок три копейки"
+  def kopeek(amount)
+    rublej(amount / 100.0)
+  end
+
+  # Выводит сумму данного существительного прописью и выбирает правильное число и падеж
+  #
+  #    RuPropisju.propisju_shtuk(21, 3, "колесо", "колеса", "колес") #=> "двадцать одно колесо"
+  #    RuPropisju.propisju_shtuk(21, 1, "мужик", "мужика", "мужиков") #=> "двадцать один мужик"
+  def propisju_shtuk(items, gender = 1, *forms)
+    r = if items == items.to_i
+      [propisju(items, gender), choose_plural(items, *forms)]
+    else
+      [propisju(items, gender), forms[1]]
+    end
+    
+    r.join(" ")
+  end
+  
+  private
+  
+  def compose_ordinal(into, remaining_amount, gender, one_item='', two_items='', five_items='')
+    rest, rest1, chosen_ordinal, ones, tens, hundreds = [nil]*6
+    #
+    rest = remaining_amount % 1000
+    remaining_amount = remaining_amount / 1000
+    if rest == 0 
+      # последние три знака нулевые 
+      into = five_items + " " if into == ""
+      return [into, remaining_amount]
+    end
+    #
+    # начинаем подсчет с Rest
+    chosen_ordinal = five_items
+    
+    # сотни
+    hundreds = case rest / 100
+      when 0 then ""
+      when 1 then "сто "
+      when 2 then "двести "
+      when 3 then "триста "
+      when 4 then "четыреста "
+      when 5 then "пятьсот "
+      when 6 then "шестьсот "
+      when 7 then "семьсот "
+      when 8 then "восемьсот "
+      when 9 then "девятьсот "
+    end
+
+    # десятки
+    rest = rest % 100
+    rest1 = rest / 10
+    ones = ""
+    tens = case rest1
+      when 0 then ""
+      when 1 # особый случай
+        case rest
+          when 10 then "десять "
+          when 11 then "одиннадцать "
+          when 12 then "двенадцать "
+          when 13 then "тринадцать "
+          when 14 then "четырнадцать "
+          when 15 then "пятнадцать "
+          when 16 then "шестнадцать "
+          when 17 then "семнадцать "
+          when 18 then "восемнадцать "
+          when 19 then "девятнадцать "
+        end
+      when 2 then "двадцать "
+      when 3 then "тридцать "
+      when 4 then "сорок "
+      when 5 then "пятьдесят "
+      when 6 then "шестьдесят "
+      when 7 then "семьдесят "
+      when 8 then "восемьдесят "
+      when 9 then "девяносто "
+    end
+    #
+    if rest1 < 1 or rest1 > 1 # единицы
+      case rest % 10
+        when 1
+          ones = case gender
+            when 1 then "один "
+            when 2 then "одна "
+            when 3 then "одно "
+          end
+          chosen_ordinal = one_item
+        when 2
+          if gender == 2
+            ones = "две "
+          else
+            ones = "два " 
+          end       
+          chosen_ordinal = two_items
+        when 3
+          ones = "три "
+          chosen_ordinal = two_items
+        when 4
+          ones = "четыре "
+          chosen_ordinal = two_items
+        when 5
+          ones = "пять "
+        when 6
+          ones = "шесть "
+        when 7
+          ones = "семь "
+        when 8
+          ones = "восемь "
+        when 9
+          ones = "девять "
+      end
+    end
+    
+    plural = [hundreds, tens, ones, chosen_ordinal,  " ",  into].join.strip 
+    return [plural, remaining_amount] 
+  end
+  
+  DECIMALS = %w( целая десятая сотая тысячная десятитысячная стотысячная
+      миллионная десятимиллионная стомиллионная миллиардная десятимиллиардная 
+      стомиллиардная триллионная
+  ).map{|e| [e, e.gsub(/ая$/, "ых"), e.gsub(/ая$/, "ых"), ] }.freeze
+  
+  # Выдает сумму прописью с учетом дробной доли. Дробная доля округляется до миллионной, или (если
+  # дробная доля оканчивается на нули) до ближайшей доли ( 500 тысячных округляется до 5 десятых).
+  # Дополнительный аргумент - род существительного (1 - мужской, 2- женский, 3-средний)
+  def propisju_float(num)
+    
+    # Укорачиваем до триллионной доли
+    formatted = ("%0.#{DECIMALS.length}f" % num).gsub(/0+$/, '')
+    wholes, decimals = formatted.split(/\./)
+    
+    return propisju_int(wholes.to_i) if decimals.to_i.zero?
+    
+    whole_st = propisju_shtuk(wholes.to_i, 2, *DECIMALS[0])
+    
+    rem_st = propisju_shtuk(decimals.to_i, 2, *DECIMALS[decimals.length])
+    [whole_st, rem_st].compact.join(" ")
+  end
+  
+  # Выполняет преобразование числа из цифрого вида в символьное
+  #
+  #   amount - числительное
+  #   gender   = 1 - мужской, = 2 - женский, = 3 - средний
+  #   one_item - именительный падеж единственного числа (= 1)
+  #   two_items - родительный падеж единственного числа (= 2-4)
+  #   five_items - родительный падеж множественного числа ( = 5-10)
+  # 
+  # Примерно так:
+  #   propisju(42, 1, "сволочь", "сволочи", "сволочей") # => "сорок две сволочи"
+  def propisju_int(amount, gender = 1, one_item = '', two_items = '', five_items = '')
+    
+    return "ноль " + five_items if amount.zero?
+    
+    # единицы
+    into, remaining_amount = compose_ordinal('', amount, gender, one_item, two_items, five_items)
+    
+    return into if remaining_amount == 0
+    
+    # тысячи
+    into, remaining_amount = compose_ordinal(into, remaining_amount, 2, "тысяча", "тысячи", "тысяч") 
+    
+    return into if remaining_amount == 0
+    
+    # миллионы
+    into, remaining_amount = compose_ordinal(into, remaining_amount, 1, "миллион", "миллиона", "миллионов")
+    
+    return into if remaining_amount == 0
+    
+    # миллиарды
+    into, remaining_amount = compose_ordinal(into, remaining_amount, 1, "миллиард", "миллиарда", "миллиардов")
+    return into
+  end
+  
+  alias_method :rublja, :rublej
+  alias_method :rubl, :rublej
+  
+  alias_method :kopeika, :kopeek
+  alias_method :kopeiki, :kopeek
+  
+  alias_method :grivna, :griven
+  alias_method :grivny, :griven
+  
+  
+  public_instance_methods(true).map{|m| module_function(m) }
+  
+  module_function :propisju_int, :propisju_float, :compose_ordinal
+end

data/test/test_ru_propisju.rb

@@ -0,0 +1,69 @@
+# -*- encoding: utf-8 -*- 
+$KCODE = 'u' if RUBY_VERSION < '1.9.0'
+
+require "test/unit"
+require "ru_propisju"
+
+class TestRuPropisju < Test::Unit::TestCase
+
+  def test_propisju_for_ints
+    assert_equal "пятьсот двадцать три", RuPropisju.propisju(523)
+    assert_equal "шесть тысяч семьсот двадцать семь", RuPropisju.propisju(6727)
+    assert_equal "восемь миллионов шестьсот пятьдесят два", RuPropisju.propisju(8000652, 1)
+    assert_equal "восемь миллионов шестьсот пятьдесят две", RuPropisju.propisju(8000652, 2)
+    assert_equal "восемь миллионов шестьсот пятьдесят два", RuPropisju.propisju(8000652, 3)
+    assert_equal "сорок пять", RuPropisju.propisju(45)
+    assert_equal "пять", RuPropisju.propisju(5)
+    assert_equal "шестьсот двенадцать", RuPropisju.propisju(612)
+  end
+  
+  def test_propisju_shtuk
+    assert_equal "шесть целых", RuPropisju.propisju_shtuk(6, 2, "целая", "целых", "целых")
+    assert_equal "двадцать пять колес", RuPropisju.propisju_shtuk(25, 3, "колесо", "колеса", "колес")
+    assert_equal "двадцать одна подстава", RuPropisju.propisju_shtuk(21, 2, "подстава", "подставы", "подстав")    
+    assert_equal "двести двенадцать сволочей", RuPropisju.propisju_shtuk(212.00, 2, "сволочь", "сволочи", "сволочей")
+    assert_equal "двести двенадцать целых четыре десятых куска", RuPropisju.propisju_shtuk(212.40, 2, "кусок", "куска", "кусков")
+  end
+  
+  def test_propisju_for_floats
+    assert_equal "шесть целых пять десятых", RuPropisju.propisju(6.50)
+    assert_equal "триста сорок одна целая девять десятых", RuPropisju.propisju(341.9)
+    assert_equal "триста сорок одна целая двести сорок пять тысячных", RuPropisju.propisju(341.245)
+    assert_equal "двести три целых сорок одна сотая", RuPropisju.propisju(203.41)
+    assert_equal "четыреста сорок две целых пять десятых", RuPropisju.propisju(442.50000)
+  end
+  
+  def test_choose_plural
+    assert_equal "чемодана", RuPropisju.choose_plural(523, "чемодан", "чемодана", "чемоданов")
+    assert_equal "партий", RuPropisju.choose_plural(6727, "партия", "партии", "партий")
+    assert_equal "козлов", RuPropisju.choose_plural(45, "козел", "козла", "козлов")
+    assert_equal "колес", RuPropisju.choose_plural(260, "колесо", "колеса", "колес")
+  end
+  
+  def test_rublej
+    assert_equal "сто двадцать три рубля", RuPropisju.rublej(123)
+    assert_equal "триста сорок три рубля двадцать копеек", RuPropisju.rublej(343.20)
+    assert_equal "сорок две копейки", RuPropisju.rublej(0.4187)
+    assert_equal "триста тридцать два рубля", RuPropisju.rublej(331.995)
+    assert_equal "один рубль", RuPropisju.rubl(1)
+    assert_equal "три рубля четырнадцать копеек", RuPropisju.rublja(3.14)
+  end
+  
+  def test_griven
+    assert_equal "сто двадцать три гривны", RuPropisju.griven(123)
+    assert_equal "сто двадцать четыре гривны", RuPropisju.griven(124)
+    assert_equal "триста сорок три гривны двадцать копеек", RuPropisju.griven(343.20)
+    assert_equal "сорок две копейки", RuPropisju.griven(0.4187)
+    assert_equal "триста тридцать две гривны", RuPropisju.griven(331.995)
+    assert_equal "одна гривна", RuPropisju.grivna(1)
+    assert_equal "три гривны четырнадцать копеек", RuPropisju.grivny(3.14)
+  end
+  
+  def test_kopeek
+    assert_equal "сто двадцать три рубля", RuPropisju.kopeek(12300)
+    assert_equal "три рубля четырнадцать копеек", RuPropisju.kopeek(314)
+    assert_equal "тридцать две копейки", RuPropisju.kopeek(32)
+    assert_equal "двадцать одна копейка", RuPropisju.kopeika(21)
+    assert_equal "три копейки", RuPropisju.kopeiki(3)
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: ru_propisju
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Julik Tarkhanov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-28 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 41
+        segments: 
+        - 2
+        - 9
+        - 1
+        version: 2.9.1
+  type: :development
+  version_requirements: *id001
+description: "\xD0\x92\xD1\x8B\xD0\xB2\xD0\xBE\xD0\xB4\xD0\xB8\xD1\x82 \xD1\x81\xD1\x83\xD0\xBC\xD0\xBC\xD1\x83 \xD0\xBF\xD1\x80\xD0\xBE\xD0\xBF\xD0\xB8\xD1\x81\xD1\x8C\xD1\x8E \xD0\xB8 \xD1\x81\xD1\x83\xD0\xBC\xD0\xBC\xD1\x8B \xD0\xBA\xD0\xBE\xD0\xBF\xD0\xB5\xD0\xB5\xD0\xBA, \xD1\x80\xD1\x83\xD0\xB1\xD0\xBB\xD0\xB5\xD0\xB9 \xD0\xB8 \xD0\xB3\xD1\x80\xD0\xB8\xD0\xB2\xD0\xB5\xD0\xBD. \xD0\x9F\xD0\xBE\xD0\xBC\xD0\xBE\xD0\xB3\xD0\xB0\xD0\xB5\xD1\x82 \xD0\xB2 \xD0\xB2\xD1\x8B\xD0\xB1\xD0\xBE\xD1\x80\xD0\xB5 \xD0\xBF\xD1\x80\xD0\xB0\xD0\xB2\xD0\xB8\xD0\xBB\xD1\x8C\xD0\xBD\xD0\xBE\xD0\xB3\xD0\xBE \xD1\x87\xD0\xB8\xD1\x81\xD0\xBB\xD0\xB8\xD1\x82\xD0\xB5\xD0\xBB\xD1\x8C\xD0\xBD\xD0\xBE\xD0\xB3\xD0\xBE."
+email: 
+- me@julik.nl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- lib/ru_propisju.rb
+- test/test_ru_propisju.rb
+- .gemtest
+has_rdoc: true
+homepage: http://github.com/julik/ru_propisju
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: ru_propisju
+rubygems_version: 1.4.1
+signing_key: 
+specification_version: 3
+summary: "\xD0\x92\xD1\x8B\xD0\xB2\xD0\xBE\xD0\xB4\xD0\xB8\xD1\x82 \xD1\x81\xD1\x83\xD0\xBC\xD0\xBC\xD1\x83 \xD0\xBF\xD1\x80\xD0\xBE\xD0\xBF\xD0\xB8\xD1\x81\xD1\x8C\xD1\x8E \xD0\xB8 \xD1\x81\xD1\x83\xD0\xBC\xD0\xBC\xD1\x8B \xD0\xBA\xD0\xBE\xD0\xBF\xD0\xB5\xD0\xB5\xD0\xBA, \xD1\x80\xD1\x83\xD0\xB1\xD0\xBB\xD0\xB5\xD0\xB9 \xD0\xB8 \xD0\xB3\xD1\x80\xD0\xB8\xD0\xB2\xD0\xB5\xD0\xBD"
+test_files: 
+- test/test_ru_propisju.rb