rutils 1.1.4 → 2.0.0

data/History.txt

@@ -1,3 +1,13 @@
+=== 2.0.0 - 19.03.2011
+
+* Все ребята, хватит. Пользоваться рутилями на Rails 3 с Ruby 1.9.2 это пиздец и привет горячий.
+	Примерно как ставить тюнингованный жигулевский карбюратор на феррари.
+	Рутили остаются в рабочем состоянии для старых приложений для которых апгрейд на i18n+russian
+	не является целесообразным. Если вы использовали какую-то конкретную маленькую полезняшку из рутилей
+	она скорее всего доступна отдельным модулем.
+	
+	Спасибо что были с нами и до новых встреч!
+	
 === 1.1.4 - 03.11.2010
 
 * Подавление KCODE для Ruby 1.9

data/Manifest.txt

@@ -4,19 +4,15 @@ Manifest.txt
 README.txt
 Rakefile.rb
 TODO.txt
-bin/rutilize
 init.rb
-lib/countries/countries.rb
-lib/datetime/datetime.rb
-lib/gilenson/gilenson_stub.rb
+lib/gilenson_stub.rb
 lib/integration/integration.rb
 lib/integration/rails_date_helper_override.rb
 lib/integration/rails_pre_filter.rb
-lib/pluralizer/pluralizer.rb
+lib/pluralizer.rb
+lib/rudates.rb
 lib/rutils.rb
-lib/transliteration/bidi.rb
-lib/transliteration/simple.rb
-lib/transliteration/transliteration.rb
+lib/transliteration.rb
 lib/version.rb
 test/extras/integration_rails_filter.rb
 test/extras/integration_rails_gilenson_helpers.rb

data/README.txt

@@ -1,108 +1,28 @@
 = RuTils
 
-http://rutils.rubyforge.org
+http://github.com/julik/rutils
 
-RuTils - простой обработчик русского текста на Ruby.
-Основная цель RuTils - сделать разработку русскоязычных приложений на Ruby (и Rails) максимально простой
-и приятной (в идеале - столь же простой как и разработку оных на английском).
+RuTils был целым ящиком инструментов для простой обработки русского текста на Ruby
+и руссификации Ryby-приложений. После тяжелого четырехлетного труда ящик списан на пенсию
+в дедушкин сарай. Для справки - "дедушкин сарай" это то место где крутятся написанные с помощью
+RuTils приложения и где клиенты очень не хотят чтобы при апдейтах RuTils приложение ломалось.
 
-== Чье это
-
-Разработчики RuTils - {Julik}[http://julik.nl], {Mash}[http://imfo.ru], {Yaroslav Markin}[http://markin.net/]
+rutils в настоящий момент - минимальная прослойка между маленькими составными библиотеками которые
+можно (и нужно!) использовать отдельно. Сам модуль rutils обновляться больше не будет, функционал
+заморожен, авторы ушли и выключили свет.
 
 = Как воспользоваться
 
-Просто включите rutils в свою программу как библиотеку
-
-  require 'rutils'
-
-Для использования с Ruby on Rails установите RuTils как плагин 
-(скопируйте библиотеку в vendor/plugins приложения).
-
-= Что оно делает
-
-== Cумма прописью и выбор числительного
-
-RuTils реализует сумму прописью для целых и дробных чисел, с дополнительным
-учетом рода. Например:
-
-  4.propisju => "четыре"
-  345.propisju => "триста сорок пять"
-  231.propisju(2) => "двести тридцать одна"
-  341.propisju_items(1, "чемодан", "чемодана", "чемоданов") => "триста сорок один чемодан"
-  (212.40).propisju_items(2, "сволочь", "сволочи", "сволочей") => "двести двенадцать целых
-      четыре десятых сволочи"
-
-Также реализуется выбор варианта числительного в зависимости от числа
-
- 15.items("кодер", "кодера", "кодеров") => "кодеров"
-
-и вывод "суммы прописью" для денежных сумм в рублях
-
- (413.2).rublej => "четыреста тринадцать рублей двадцать копеек"
- 1.rubl         => "один рубль"
- 22.rublja      => "двадцать два рубля"
-
-Если вы храните денежные единицы в целочисленных типах, пользуйтесь "копеечными" вариантами:
-
- 300.kopeek     => "три рубля"
- 121.kopeika    => "один рубль двадцать одна копейка"
-
-== Транслит
-
-RuTils на данный момент реализует простейший транслит "в одну сторону".
-"Взаимно-однозначный транслит" (BiDi-транслит)  больше не поддерживается.
-
- "Вот такое вот дело".translify => "Vot takoye vot delo" 
- "Несомненный прогресс по сравнению с PHP".dirify => "nesomnennyi-progress-po-sravneniu-s-php"
-
-== Обработка русской типографики в HTML
-
-rutils автоматически использует Gilenson (http://github.com/julik/gilenson) - улучшайзер типографики в русском наборе.
-
-Gilenson расставит в тексте "умные" правильные кавычки (русские - для кириллицы,
-английские - для латиницы), заменит "хитрые" пунктуационные символы на entities и
-отформатирует знаки типа (c), (tm), телефоны и адреса.
-
- %q{"И это называется языком?", -- таков был его вопрос}.gilensize => "«И
- это называется языком?», — таков был его вопрос"
-
-== Даты
-
-В класс Date введены следующие константы:
-
-* RU_MONTHNAMES (Январь Февраль Март...)
-* RU_DAYNAMES (Воскресенье Понедельник...)
-* RU_ABBR_MONTHNAMES (Янв Фев Мар...)
-* RU_ABBR_DAYNAMES (Вск Пн Вт Ср...)
-* RU_INFLECTED_MONTHNAMES (Января Февраля Марта...)
-* RU_DAYNAMES_E (первое второе третье...)
-
-Пример использования:
-
-  require 'date' date = Date.new(2005, 11, 9)
-  puts "#{Date::RU_ABBR_MONTHNAMES[date.mon]}" => Ноя
-  puts "#{Date::RU_MONTHNAMES[date.mon]}" => Ноябрь
-  puts "#{Date::RU_ABBR_DAYNAMES[date.wday]}" => Ср
-  puts "#{Date::RU_DAYNAMES[date.wday]}" => Среда
+RuTils больше пользоваться не надо. Когда будет время просто рефакторните его вон. Гемы которые вам понадобятся
+для реализации функций RuTils и сверх того:
 
-При включенной перезагрузке функций (RuTils::overrides_enabled) осуществляется
-"покрытие" стандартной функции Time#strftime ("родную" #strftime можно продолжать
-использовать через alias-метод #strftime_norutils):
-
-  Time.local(2005,"dec",31).strftime("%a, %A, %b, %B") => "Сб, Суббота, Дек, Декабрь" 
-  Time.local(2005,"dec",31).strftime_norutils("%a, %A, %b, %B") => "Sat, Saturday, Dec, December"
-
-== Интеграция с RedCloth и BlueCloth
-
-RuTils в первую очередь задумывался как максимально "прозрачный" механизм
-обработки русского текста в контексте Rails-приложения. Вывод стандартных рельсовых
-хелперов +markdown+ и +textilize+ будет автоматически (при включенных overrides) пропускаться через
-Гиленсон.
+* russian
+* ru_propisju
+* gilenson
 
 ==  Интеграция с Rails версии 2.2.2 и выше
 
-Используйте гем russian для дат и RuTils как дополнение (для транслита, функций kopeek и так далее)
+Не надо использовать RuTils для этих приложений. Вот собственно и все.
 
 ==  Интеграция с Rails версий 1.2 - 2.1.1
 
@@ -114,93 +34,21 @@ RuTils заставляет следующие функции старых (pre-
 * +distance_of_time_in_words+ будет выводить 
   русские описания длительности ("более 2 часов")
 
-== Управление оверрайдами
-
-Перегрузку всех функций других модулей можно включать и отключать в любое время с
-помощью метода RuTils::overrides=. Когда перегрузка выключена, все сторонние
-хелперы будут работать в стандартном режиме (например, даты и время будут выводиться по-русски).
-Это нужно когда вам нужно переключиться на английский (или любой другой язык) без перезапуска приложения.
-
-Рекомендуемый способ использования RuTils с Ruby on Rails приложением -- установка RuTils 
-плагином. Для этого скопируйте директорию rutils в папку vendor/plugins вашего
-приложения или воспользуйтесь командой rutilize путь_к_rails_приложению чтобы сделать это
-автоматически. После этого вы сможете использовать RuTils без необходимости
-установки gem  на вашем сервере (не забудьте перезапустить приложение чтобы
-вгрузить в него RuTils).
-
- $ rutilize /Sites/my_app1 /Sites/my_app2 /Sites/my_another_app
-
 == Распространения
 
 Вы можете свободно распространять RuTils со своим приложением при условии
-сохранения структуры и файла README.
+сохранения структуры и файла README. Но лучше не распространяйте RuTils потому что он безнадежно устарел.
 
-== Совместимость
+== Совместимость/требования
 
-* Ruby 1.8.x
-* Ruby 1.9.x (релизные версии начиная с 1.9.1)
-* JRuby 1.1.6
-
-== Требования
-
-* Ruby 1.8.2 или выше, немного прямых рук 
+* Ruby 1.8 или выше, немного прямых рук 
 * Rake[http://rake.rubyforge.org],
 
-
-Rails[http://rubyonrails.org],
-RedCloth[http://www.whytheluckystiff.net/ruby/redcloth/] и
-BlueCloth[http://www.deveiate.org/projects/BlueCloth] для выполнения тестов.
-
-== Работает ли это с текстом в кодировке отличной от UTF-8 (Windows-1251, KOI-8)
-
-Нет и никогда не будет.
-
 == Как получить помощь
 
-Весь функционал RuTils поддерживает только UTF-8 (настройка $KCODE / KanjiCode
-'u'). Удостоверьтесь, что ваш скрипт правильно обрабатывает Unicode - то есть:
-
-* Переменная $KCODE включена в режим 'u' 
-* Все строки которые вы собираетесь обрабатывать уже в кодировке UTF-8
-
-Если вы используете RuTils для сайта под mod_ruby воспользуйтесь директивой
-RubyKanjiCode в своем httpd.conf.
-
-== Если вы все сделали правильно но что-то не работает
-
-Сообщите об ошибке на странице проекта на github[http://github.com/julik/rutils/issues]
-Не забудьте указать версию, ее всегда можно узнать в константе
-
- RuTils::VERSION
-
-== Как ускорить реализацию новых функций
-
-Опишите нужный вам функционал и приложите тесты, которым этот функционал должен удовлетворять.
-Схему организации тестов вы можете скопировать из собственных тестов RuTils.
-
-Если вы пишете исходный код, который войдет в RuTils или в тестовые наборы,
-пожалуйста следуйте следующим правилам оформления кода:
-
-* Unix line breaks (LF)
-* Кодировка файлов - строго UTF-8 без BOM (Byte Order Mark)
-* Все файлы должны содержать emacs-прагму
-     # -*- encoding: utf-8 -*- 
-  в первой строке
-* Отступы в 2 пробела, без табуляций
-* Только однозначный код для 1.8 и 1.9
-  * Без функций которые отсутствуют в 1.8 (в первую очередь encodings)
-  * Без функций которые убраны из 1.9
-* Однострочные блоки с фигурными скобками, многострочные - с +do ... end+
-* Все другие конвенции нормального написания 
-  Ruby-кода (http://github.com/chneukirchen/styleguide/tree/master)
-
-При сравнении текстовых сегментов, прошедших через хитрые форматтеры пользуйтесь assert_equal_cp
-- он внятно покажет вам какой символ отличается в двух строках (иначе будете вслепую искать
-разницу между двумя разными пробелами, например)
-
-Если вы хотите участвовать в разработке RuTils - fork us on GitHub
-
-git clone git://github.com/julik/rutils.git
+Помощь по RuTils предоставляется в строго дозированном и ограниченном виде, потому что совесть тоже надо иметь.
+В настоящее время есть большое количество более новых, современных библиотек реализующий функции рутилей быстро,
+эффективно и совместимых с большим количеством версий Rails, ruby и так далее.
 
 == Лицензия
 

data/Rakefile.rb

@@ -2,7 +2,7 @@
 $KCODE = 'u' if RUBY_VERSION < '1.9.0'
 $:.reject! { |e| e.include? 'TextMate' }
 
-require 'lib/version'
+require File.expand_path(File.dirname(__FILE__) + '/lib/version')
 
 begin
   require 'rubygems'
@@ -14,22 +14,16 @@ begin
   Hoe::RUBY_FLAGS.replace ENV['RUBY_FLAGS'] || "-I#{%w(lib test).join(File::PATH_SEPARATOR)}" + 
     (Hoe::RUBY_DEBUG ? " #{RUBY_DEBUG}" : '')
   
-  #Rake::RDocTask.class_eval do
-  #  alias_method :_odefine, :define
-  #  def define; @options.unshift(*DOCOPTS); _odefine; end
-  #end
-
   rutils = Hoe.spec('rutils') do |p|
     p.version = RuTils::VERSION
     p.name = "rutils"
     p.author = ["Julian 'Julik' Tarkhanov", "Danil Ivanov", "Yaroslav Markin"]
     p.email = ['me@julik.nl', 'yaroslav@markin.net']
-    p.description = 'Simple processing of russian strings'
-    p.summary     = 'Simple processing of russian strings'
-    p.extra_deps = {"gilenson" => ">=1.1.0"}
-    p.remote_rdoc_dir = ''
-    p.need_zip = true # ненвижу
+    p.description = 'DEPRECATED processing of russian strings'
+    p.summary     = 'DEPRECATED processing of russian strings'
+    p.extra_deps = {"gilenson" => ">=1.1.0", "russian" => ">= 0.2.7", "ru_propisju" => ">= 1.0.0"  }
   end
+  
   rutils.spec.rdoc_options += DOCOPTS
   
   require 'load_multi_rails_rake_tasks'

data/init.rb

@@ -5,10 +5,10 @@
   RuTils будет автоматически загружен с включенным флагом <tt>RuTils::overrides = true</tt>.
   В ActionController::Base будет установлен пре-фильтр устанавливающий флаг <tt>overrides.</tt>
 =end
-require File.dirname(__FILE__) +  '/lib/rutils' unless defined?(RuTils)
+require File.expand_path(File.dirname(__FILE__)) +  '/lib/rutils' unless defined?(RuTils)
 
 RuTils::overrides = true
-require File.dirname(__FILE__) + '/lib/integration/rails_pre_filter' 
+require File.expand_path(File.dirname(__FILE__)) + '/lib/integration/rails_pre_filter' 
 
 def russan_gem_required?
   require 'action_pack/version'
@@ -20,7 +20,7 @@ end
 if russan_gem_required?
   STDERR.puts "RuTils WARNING: On this version of Rails use the `russian` gem for date helper overrides instead"
 else
-  require File.dirname(__FILE__) +  '/lib/integration/rails_date_helper_override'
+  require File.expand_path(File.dirname(__FILE__)) +  '/lib/integration/rails_date_helper_override'
   ::ActionController::Base.send(:helper, RuTils::DateHelper)
 end
 

data/lib/{gilenson/gilenson_stub.rb → gilenson_stub.rb}

@@ -5,12 +5,6 @@ require "gilenson"
 module RuTils
   module GilensonStub
     
-    # Позволяет возвращать класс форматтера при вызове
-    #  RuTils::Gilenson.new
-    def self.new(*args) #:nodoc:
-      Gilenson.new(*args)
-    end
-    
     # Включается на правах хелпера в Rails-приложение
     module Helper
       

data/lib/integration/integration.rb

@@ -1 +1 @@
-require File.dirname(__FILE__) + '/rails_date_helper_override' if defined?(ActionView)
+require File.expand_path(File.dirname(__FILE__)) + '/rails_date_helper_override' if defined?(ActionView)

data/lib/integration/rails_date_helper_override.rb

@@ -25,7 +25,7 @@ module RuTils::DateHelper
   # Целые числа интерпретируются как секунды.
   # <tt>distance_of_time_in_words(50)</tt> возвращает "меньше минуты".
   def distance_of_time_in_words(*args)
-    RuTils::overrides_enabled? ? RuTils::DateTime::distance_of_time_in_words(*args) : super
+    RuTils::overrides_enabled? ? RuTils::RuDates.distance_of_time_in_words(*args) : super
   end
   
   # Заменяет ActionView::Helpers::DateHelper::select_month меню выбора русских месяцев.
@@ -52,12 +52,12 @@ module RuTils::DateHelper
       if RuTils::overrides_enabled?
         month_names = case true
           when options[:use_short_month]
-            Date::RU_ABBR_MONTHNAMES
+            RuTils::RuDates::RU_ABBR_MONTHNAMES
           # использование в контексте date_select с днями требует родительный падеж
           when options[:order] && options[:order].include?(:day)
-            Date::RU_INFLECTED_MONTHNAMES
+            RuTils::RuDates::RU_INFLECTED_MONTHNAMES
           else
-            Date::RU_MONTHNAMES
+            RuTils::RuDates::RU_MONTHNAMES
         end
       else
         if defined? I18n

data/lib/pluralizer.rb

@@ -0,0 +1,101 @@
+# -*- encoding: utf-8 -*- 
+require "rubygems"
+require "ru_propisju"
+
+module RuTils
+  
+  # ++DEPRECATED++ - Сумма прописью и выбор падежа
+  module Pluralization #:nodoc:
+    def self.choose_plural(amount, *variants)
+      RuPropisju.choose_plural(amount, *variants)
+    end
+    
+    def self.rublej(amount)
+      RuPropisju.rublej(amount)
+    end
+    
+    def self.griven(amount)
+      RuPropisju.griven(amount)
+    end
+    
+    def self.kopeek(amount)
+      RuPropisju.kopeek(amount)
+    end
+    
+    # Реализует вывод прописью любого объекта, реализующего Float
+    module FloatFormatting
+      
+      # Выдает сумму прописью с учетом дробной доли. Дробная доля округляется до миллионной, или (если
+      # дробная доля оканчивается на нули) до ближайшей доли ( 500 тысячных округляется до 5 десятых).
+      # Дополнительный аргумент - род существительного (1 - мужской, 2- женский, 3-средний)
+      def propisju(gender = 2)
+        RuPropisju.propisju(self, gender)
+      end
+
+      def propisju_items(gender=1, *forms)
+        RuPropisju.propisju_shtuk(self, gender, *forms)
+      end
+
+    end
+    
+    # Реализует вывод прописью любого объекта, реализующего Numeric
+    module NumericFormatting
+      # Выбирает корректный вариант числительного в зависимости от рода и числа и оформляет сумму прописью
+      #   234.propisju => "двести сорок три"
+      #   221.propisju(2) => "двести двадцать одна"
+      def propisju(gender = 1)
+        RuPropisju.propisju(self, gender)
+      end
+      
+      def propisju_items(gender=1, *forms)
+        RuPropisju.propisju_shtuk(self, gender, *forms)
+      end
+      
+      # Выбирает корректный вариант числительного в зависимости от рода и числа. Например:
+      # * 4.items("колесо", "колеса", "колес") => "колеса"
+      def items(one_item, two_items, five_items)
+        RuPropisju.choose_plural(self, one_item, two_items, five_items)
+      end  
+      
+      # Выводит сумму в рублях прописью. Например:
+      # * (15.4).rublej => "пятнадцать рублей сорок копеек"
+      # * 1.rubl        => "один рубль"
+      # * (3.14).rublja => "три рубля четырнадцать копеек"
+      def rublej
+        RuPropisju.rublej(self)
+      end
+      alias :rubl   :rublej
+      alias :rublja :rublej
+      
+      # Выводит сумму в гривнах прописью. Например:
+      # * (15.4).griven => "пятнадцать гривен сорок копеек"
+      # * 1.grivna      => "одна гривна"
+      # * (3.14).grivny => "три гривны четырнадцать копеек"
+      def griven
+        RuPropisju.griven(self)
+      end
+      alias :grivna :griven
+      alias :grivny :griven
+    end
+    
+    module FixnumFormatting
+      def kopeek
+        RuPropisju.kopeek(self)
+      end
+      alias :kopeika   :kopeek
+      alias :kopeiki :kopeek
+    end
+  end
+end
+
+class Object::Numeric
+  include RuTils::Pluralization::NumericFormatting
+end
+
+class Object::Fixnum
+  include RuTils::Pluralization::FixnumFormatting
+end
+
+class Object::Float
+  include RuTils::Pluralization::FloatFormatting
+end