num2words 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ed408cbe7ab8e51dc7ee381eb516bd72a621e9edea1519a4237e2623a3560cf3
+  data.tar.gz: d9ab27fd319195b92f467d12d6722becd09791669a1639441a959e2a7a370cb0
+SHA512:
+  metadata.gz: 4b96c5fa0203e812683760edb0c1ae6f4f6c84966ba831b14f0f79913f8b560bf478d201765b13da0bbe59ba1ad307f3bb7b9f9e7b7041b997e8ccdee03f18b5
+  data.tar.gz: 9b35076edef208aec9d066dbfa6abf8c42842df9c7616f9396c6baa78aa3c78abd1b5d47da5b9ba630ad27e96a19339b935465ba1579b6e89f2f32cc4a004014

data/.gitignore

@@ -0,0 +1,18 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# IDE specific files (e.g., RubyMine, IntelliJ IDEA)
+.idea/
+
+# Operating system specific files
+.DS_Store
+
+# Ignore Gemfile.lock in libraries (gems)
+# In applications, Gemfile.lock should generally be committed.
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in num2words.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+
+group :development, :test do
+  gem "rspec", "~> 3.12"
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Ruslan Fedotov
+
+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,136 @@
+# num2words
+
+📦 **num2words** — Ruby-гем для преобразования чисел в строковое представление (прописью).
+
+✨ Основные фичи:
+- 🇷🇺 Поддержка русского языка (включая склонения)
+- 💰 Работа с валютами (рубли и копейки)
+- 🔠 Склонения в зависимости от числа (1 рубль, 2 рубля, 5 рублей)
+- 📏 Поддержка чисел до **триллиона**
+- ⚙️ Опция выбора рода (один/одна, два/две)
+- 🚀 Готово для интеграции в Rails
+
+---
+
+## 🚀 Установка
+
+В Gemfile:
+
+```ruby
+gem "num2words"
+```
+
+или напрямую:
+
+```bash
+gem install num2words
+```
+
+---
+
+## 💡 Использование
+
+```ruby
+require "num2words"
+
+Num2words.to_words(21)
+# => "двадцать один"
+
+Num2words.to_currency(21.01)
+# => "двадцать один рубль одна копейка"
+
+Num2words.to_currency(105.15)
+# => "сто пять рублей пятнадцать копеек"
+```
+
+---
+
+## 🔢 Расширение числовых классов
+
+Gem добавляет метод `to_words` для объектов `Integer` и `Float`.  
+Это позволяет удобно переводить числа в текст прямо на самих числах:
+
+```ruby
+123.to_words
+# => "сто двадцать три"
+
+22.to_words(feminine: true)
+# => "сто двадцать две"
+
+21.01.to_currency
+# => "двадцать один рубль одна копейка"
+```
+
+---
+
+## ⚙️ Опции
+
+### Род числительных
+```ruby
+Num2words.to_words(1) 
+# => "один"
+
+Num2words.to_words(1, feminine: true) 
+# => "одна"
+```
+
+### Поддержка больших чисел
+```ruby
+Num2words.to_words(1_000_000)
+# => "один миллион"
+
+Num2words.to_words(2_345_678_901)
+# => "два миллиарда триста сорок пять миллионов шестьсот семьдесят восемь тысяч девятьсот один"
+```
+
+---
+
+## 🧪 Тесты
+
+```bash
+bundle exec rspec
+```
+
+## 📌 Roadmap
+
+- [ ] 🇬🇧 Поддержка английского языка
+- [ ] 💵 Поддержка других валют (USD, EUR)
+- [ ] 🔠 Опция выбора регистра (строчные/Прописные)
+
+---
+
+## Консоль 💻
+
+Num2words поддерживает интерактивную консоль для быстрого тестирования.  
+Это удобно при работе с разными числами и языками.
+
+### Запуск консоли
+
+```bash
+bin/console
+```
+
+После запуска появится приветственное сообщение:
+
+```bash
+🔢 Добро пожаловать в консоль num2words!
+Попробуйте: Num2words.to_words(2025)
+-----------------------------------------------------
+```
+
+👉 Это позволяет проверять работу гема без написания отдельных скриптов.
+
+## 🤝 Вклад
+
+Pull request’ы приветствуются!
+
+1. Сделайте fork
+2. Создайте ветку `git checkout -b feature/my-feature`
+3. Commit: `git commit -m 'Добавил мою фичу'`
+4. PR 🚀
+
+---
+
+## 📜 Лицензия
+
+[MIT](LICENSE)

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+# таска для запуска тестов
+RSpec::Core::RakeTask.new(:spec)
+
+# по умолчанию запускаем тесты
+task default: :spec

data/bin/console

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "num2words"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+# Красивое приветствие
+puts "🔢 Добро пожаловать в консоль num2words!"
+puts "Можете использовать: Num2words.to_words(#{Time.now.year})"
+puts "-------------------------------------------------------------"
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/num2words/converter.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Num2words
+  class Converter
+    ONES_MASC = %w[ноль один два три четыре пять шесть семь восемь девять].freeze
+    ONES_FEM  = %w[ноль одна две три четыре пять шесть семь восемь девять].freeze
+
+    TEENS = %w[десять одиннадцать двенадцать тринадцать четырнадцать пятнадцать
+               шестнадцать семнадцать восемнадцать девятнадцать].freeze
+
+    TENS = [nil, nil, "двадцать", "тридцать", "сорок", "пятьдесят",
+            "шестьдесят", "семьдесят", "восемьдесят", "девяносто"].freeze
+
+    HUNDREDS = [nil, "сто", "двести", "триста", "четыреста", "пятьсот",
+                "шестьсот", "семьсот", "восемьсот", "девятьсот"].freeze
+
+    # формы: [one, few, many]
+    SCALES = [
+      ["", "", ""], # 10^0 (единицы)
+      %w[тысяча тысячи тысяч], # 10^3
+      %w[миллион миллиона миллионов], # 10^6
+      %w[миллиард миллиарда миллиардов], # 10^9
+      %w[триллион триллиона триллионов] # 10^12
+    ].freeze
+
+    RUB = %w[рубль рубля рублей].freeze
+    KOP = %w[копейка копейки копеек].freeze
+
+    class << self
+      def pluralize(n, one, few, many)
+        return many if (11..14).include?(n % 100)
+        case n % 10
+        when 1 then one
+        when 2..4 then few
+        else many
+        end
+      end
+
+      # n — 0..999, scale_idx — индекс разряда (0 — единицы, 1 — тысячи, ...)
+      # feminine: true — использовать женский род для единиц (нужно для тысяч/копеек)
+      def triple_to_words(n, scale_idx, feminine: false)
+        return [] if n.zero?
+
+        words = []
+        words << HUNDREDS[n / 100] if n >= 100
+
+        rest = n % 100
+        if rest.between?(10, 19)
+          words << TEENS[rest - 10]
+        else
+          words << TENS[rest / 10] if rest >= 20
+          ones = rest % 10
+          if ones.positive?
+            words << (feminine ? ONES_FEM[ones] : ONES_MASC[ones])
+          end
+        end
+
+        # добавляем наименование разряда (кроме единиц)
+        words << pluralize(n, *SCALES[scale_idx]) unless scale_idx.zero?
+        words.compact
+      end
+
+      # number — целое число (0..10^12-1)
+      def to_words(number, feminine: false)
+        number = Integer(number)
+        return (feminine ? ONES_FEM[0] : ONES_MASC[0]) if number.zero?
+
+        groups = number.to_s
+                       .chars.reverse.each_slice(3).map(&:reverse)
+                       .map(&:join).map!(&:to_i).reverse
+
+        words = []
+        groups.each_with_index do |grp, idx|
+          scale_idx = groups.size - idx - 1
+          fem = (scale_idx == 1) || feminine # тысячи — жен. род
+          words.concat triple_to_words(grp, scale_idx, feminine: fem)
+        end
+        words.join(" ")
+      end
+
+      # amount может быть String, Integer, Float, BigDecimal
+      def to_currency(amount)
+        str = amount.to_s
+        rub_str, kop_str = str.split(".")
+        rub = Integer(rub_str)
+        # всегда 2 знака для копеек; обрезаем лишние, дополняем недостающие
+        kop = (kop_str || "0")[0, 2].ljust(2, "0").to_i
+
+        rub_words = to_words(rub)
+        rub_name  = pluralize(rub, *RUB)
+
+        kop_words = to_words(kop, feminine: true)
+        kop_name  = pluralize(kop, *KOP)
+
+        "#{rub_words} #{rub_name} #{kop_words} #{kop_name}"
+      end
+    end
+  end
+end

data/lib/num2words/core_ext.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Integer
+  def to_words(feminine: false)
+    Num2words::Converter.to_words(self, feminine: feminine)
+  end
+
+  def to_currency
+    Num2words::Converter.to_currency(self)
+  end
+end
+
+class Float
+  def to_currency
+    Num2words::Converter.to_currency(self)
+  end
+end

data/lib/num2words/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Num2words
+  VERSION = "0.1.0"
+end

data/lib/num2words.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "num2words/version"
+require_relative "num2words/converter"
+require_relative "num2words/core_ext"
+
+module Num2words
+  def self.to_words(number, feminine: false)
+    Converter.to_words(number, feminine: feminine)
+  end
+
+  def self.to_currency(amount)
+    Converter.to_currency(amount)
+  end
+end

data/num2words.gemspec

@@ -0,0 +1,27 @@
+require_relative 'lib/num2words/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "num2words"
+  spec.version       = Num2words::VERSION
+  spec.authors       = ["Ruslan Fedotov"]
+  spec.email         = ["progruson@gmail.com"]
+
+  spec.summary       = %q{Russian number-to-words with currency (руб/коп) and correct declensions}
+  spec.description   = %q{Converts integers and amounts to Russian words with proper gender and plural forms.}
+  spec.homepage      = "https://github.com/skyrusx/num2words"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = spec.homepage + "/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: num2words
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ruslan Fedotov
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-08-18 00:00:00.000000000 Z
+dependencies: []
+description: Converts integers and amounts to Russian words with proper gender and
+  plural forms.
+email:
+- progruson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/num2words.rb
+- lib/num2words/converter.rb
+- lib/num2words/core_ext.rb
+- lib/num2words/version.rb
+- num2words.gemspec
+homepage: https://github.com/skyrusx/num2words
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/skyrusx/num2words
+  source_code_uri: https://github.com/skyrusx/num2words
+  changelog_uri: https://github.com/skyrusx/num2words/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
+summary: Russian number-to-words with currency (руб/коп) and correct declensions
+test_files: []