rutils 0.2.5 → 1.0.0

data/lib/gilenson/helper.rb

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*- 
+# Включается на правах хелпера в Rails-приложение
+module RuTils::Gilenson::Helper
+
+  # Возвращает текст обработанный Гиленсоном
+  def gilensize(text, options = {})
+    return "" if text.blank?
+    f = RuTils::Gilenson::Formatter.new
+    f.configure!(options)
+    f.process(text)
+  end
+  
+  # Возвращает текст обработанный Текстилем и Гиленсоном
+  # <i>Метод доступен только при включенном RedCloth</i>
+  def textilize(text)
+    return "" if text.blank?
+    if RuTils.overrides_enabled?
+      RuTils::Gilenson::RedClothExtra.new(text, [ :hard_breaks ]).to_html
+    else
+      super(text)
+    end
+  end
+  
+  # Возвращает текст с кодом Markdown превращенным в HTML, попутно обработанный Гиленсоном
+  # <i>Метод доступен только при наличии BlueCloth</i>.
+  def markdown(text)
+    return "" if text.blank?
+    if RuTils.overrides_enabled?
+      RuTils::Gilenson::BlueClothExtra.new(text).to_html
+    else
+      super(text)
+    end
+  end
+end

data/lib/gilenson/maruku_extra.rb

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*- 
+# Maruku с поддержкой Gilenson
+class RuTils::Gilenson::MarukuExtra < Maruku
+  def to_html(*anything)
+    suspended = super
+    
+    # Return quotes to original state
+    [187, 171, 8220, 8221].map do |e| 
+      suspended.gsub! /&\##{e};/, '"'
+    end
+    
+    # Return spaces to original state
+    [160].map do |e| 
+      suspended.gsub! /&\##{e};/, ' '
+    end
+    
+    suspended.gilensize
+  end
+end

data/lib/gilenson/rdiscount_extra.rb

@@ -0,0 +1,7 @@
+# -*- encoding: utf-8 -*- 
+# RDiscount с поддержкой Gilenson
+class RuTils::Gilenson::RDiscountExtra < RDiscount
+  def to_html(*opts)
+    RuTils::Gilenson::Formatter.new(super(*opts)).to_html
+  end
+end

data/lib/gilenson/redcloth_extra.rb

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*- 
+if RedCloth.class == Module
+  # RedCloth 4 - частичная поддержка
+  class RuTils::Gilenson::RedClothExtra < RedCloth::TextileDoc
+    def to_html(*anything)
+      suspended = super(*anything)
+      
+      # Return quotes to original state
+      [187, 171, 8220, 8221].map do |e| 
+        suspended.gsub! /&\##{e};/, '"'
+      end
+      
+      # Return spaces to original state
+      [160].map do |e| 
+        suspended.gsub! /&\##{e};/, ' '
+      end
+      
+      suspended.gilensize
+    end
+  end
+else 
+  # RedCloth 3 - RuTils выполняет перегрузку Textile Glyphs в RedCloth, перенося форматирование спецсимволов на Gilenson.
+  # Применять как стандартный RedCloth
+  #    RuTils::Gilenson::RedClothExtra.new(some_text).to_html
+  class RuTils::Gilenson::RedClothExtra  < RedCloth
+    # Этот метод в RedCloth при наличии Гиленсона становится заглушкой
+    def htmlesc(text, mode=0)
+      text
+    end
+    
+    # А этот метод обрабатывает Textile Glyphs - ту самую типографицу.
+    # Вместо того чтобы влезать в чужие таблицы мы просто заменим Textile Glyphs на Gilenson - и все будут рады.  
+    def pgl(text) #:nodoc:
+      # Подвешиваем пробелы в начале и в конце каждого блока. Тряпка требует чтобы эти пробелы приехали
+      # назад нетронутыми.
+      spaces =  Array.new(2,'')
+      text.gsub!(/\A([\s]+)/) { spaces[0] = $1; '' }
+      text.gsub!(/(\s+)\Z/) { spaces[1] = $1; '' }
+      text.replace(spaces[0].to_s + RuTils::Gilenson::Formatter.new(text).to_html + spaces[1].to_s)
+    end
+  end
+end

data/lib/integration/integration.rb

@@ -1,11 +1 @@
-module RuTils
-  # Вновь выполняет перегрузку. Делать это надо после того, как в программу импортированы
-  # другие модули.
-  def self.reload_integrations!
-    load File.dirname(__FILE__) + '/blue_cloth_override.rb'
-    load File.dirname(__FILE__) + '/red_cloth_override.rb'
-    load File.dirname(__FILE__) + '/rails_date_helper_override.rb'    
-  end
-end
-
-RuTils::reload_integrations!
+require File.dirname(__FILE__) + '/rails_date_helper_override' if defined?(ActionView)

data/lib/integration/rails_date_helper_override.rb

@@ -1,129 +1,127 @@
-if defined?(Object::ActionView)
-  module Object::ActionView::Helpers::DateHelper
-    # Несколько хаков для корректной работы модуля с Rails 1.2--2.0 одновременно с Rails 2.1 и выше.
+# -*- encoding: utf-8 -*- 
+module Object::ActionView::Helpers::DateHelper
+  # Несколько хаков для корректной работы модуля с Rails 1.2--2.0 одновременно с Rails 2.1 и выше.
 
-    # Хелперы DateHelper принимают параметр <tt>html_options</tt> (идет последним) начиная с Rails 2.1.
-    # Нужно понять, имеем ли мы дело с Rails 2.1+, для этого проверяем наличие классметода helper_modules у
-    # ActionView::Base, который появился как раз в версии 2.1.
-    DATE_HELPERS_RECEIVE_HTML_OPTIONS = ActionView::Base.respond_to?(:helper_modules) #:nodoc:
+  # Хелперы DateHelper принимают параметр <tt>html_options</tt> (идет последним) начиная с Rails 2.1.
+  # Нужно понять, имеем ли мы дело с Rails 2.1+, для этого проверяем наличие классметода helper_modules у
+  # ActionView::Base, который появился как раз в версии 2.1.
+  DATE_HELPERS_RECEIVE_HTML_OPTIONS = ActionView::Base.respond_to?(:helper_modules) #:nodoc:
 
-    # В Rails Edge (2.1+) определяется <tt>Time.current</tt> для работы с временными зонами.
-    unless Time.respond_to? :current
-      class << ::Time # :nodoc:
-        def current; now; end
-      end
+  # В Rails Edge (2.1+) определяется <tt>Time.current</tt> для работы с временными зонами.
+  unless Time.respond_to? :current
+    class << ::Time # :nodoc:
+      def current; now; end
     end
+  end
 
-    # В Rails Edge (2.1+) определяется <tt>Date.current</tt> для работы с временными зонами.
-    unless Date.respond_to? :current
-      class << ::Date # :nodoc:
-        def current; now; end
-      end
-    end
-    
-    # Заменяет <tt>ActionView::Helpers::DateHelper::distance_of_time_in_words</tt> на русское сообщение.
-    #
-    # Целые числа интерпретируются как секунды.
-    # <tt>distance_of_time_in_words(50)</tt> возвращает "меньше минуты".
-    alias :stock_distance_of_time_in_words :distance_of_time_in_words
-    def distance_of_time_in_words(*args)
-      RuTils::overrides_enabled? ? RuTils::DateTime::distance_of_time_in_words(*args) : stock_distance_of_time_in_words
+  # В Rails Edge (2.1+) определяется <tt>Date.current</tt> для работы с временными зонами.
+  unless Date.respond_to? :current
+    class << ::Date # :nodoc:
+      def current; now; end
     end
+  end
   
-    # Заменяет ActionView::Helpers::DateHelper::select_month меню выбора русских месяцев.
-    #
-    #   select_month(Date.today)                             # Использует ключи "Январь", "Март"
-    #   select_month(Date.today, :use_month_numbers => true) # Использует ключи "1", "3"
-    #   select_month(Date.today, :add_month_numbers => true) # Использует ключи "1 - Январь", "3 - Март"
-    def select_month(date, options = {}, html_options = {})
-      locale = options[:locale] unless RuTils::overrides_enabled?
-      
-      val = date ? (date.kind_of?(Fixnum) ? date : date.month) : ''
-      if options[:use_hidden]
-        if self.class.private_instance_methods.include? "_date_hidden_html"
-          _date_hidden_html(options[:field_name] || 'month', val, options)
-        else
-          hidden_html(options[:field_name] || 'month', val, options)
+  # Заменяет <tt>ActionView::Helpers::DateHelper::distance_of_time_in_words</tt> на русское сообщение.
+  #
+  # Целые числа интерпретируются как секунды.
+  # <tt>distance_of_time_in_words(50)</tt> возвращает "меньше минуты".
+  alias :stock_distance_of_time_in_words :distance_of_time_in_words
+  def distance_of_time_in_words(*args)
+    RuTils::overrides_enabled? ? RuTils::DateTime::distance_of_time_in_words(*args) : stock_distance_of_time_in_words
+  end
+
+  # Заменяет ActionView::Helpers::DateHelper::select_month меню выбора русских месяцев.
+  #
+  #   select_month(Date.today)                             # Использует ключи "Январь", "Март"
+  #   select_month(Date.today, :use_month_numbers => true) # Использует ключи "1", "3"
+  #   select_month(Date.today, :add_month_numbers => true) # Использует ключи "1 - Январь", "3 - Март"
+  def select_month(date, options = {}, html_options = {})
+    locale = options[:locale] unless RuTils::overrides_enabled?
+    
+    val = date ? (date.kind_of?(Fixnum) ? date : date.month) : ''
+    if options[:use_hidden]
+      if self.class.private_instance_methods.include? "_date_hidden_html"
+        _date_hidden_html(options[:field_name] || 'month', val, options)
+      else
+        hidden_html(options[:field_name] || 'month', val, options)
+      end
+    else
+      month_options = [] 
+      if RuTils::overrides_enabled?
+        month_names = case true
+          when options[:use_short_month]
+            Date::RU_ABBR_MONTHNAMES
+          # использование в контексте date_select с днями требует родительный падеж
+          when options[:order] && options[:order].include?(:day)
+            Date::RU_INFLECTED_MONTHNAMES
+          else
+            Date::RU_MONTHNAMES
         end
       else
-        month_options = [] 
-        if RuTils::overrides_enabled?
-          month_names = case true
-            when options[:use_short_month]
-              Date::RU_ABBR_MONTHNAMES
-            # использование в контексте date_select с днями требует родительный падеж
-            when options[:order] && options[:order].include?(:day)
-              Date::RU_INFLECTED_MONTHNAMES
-            else
-              Date::RU_MONTHNAMES
+        if defined? I18n
+          month_names = options[:use_month_names] || begin
+            key = options[:use_short_month] ? :'date.abbr_month_names' : :'date.month_names'
+            I18n.translate key, :locale => locale
           end
         else
-          if defined? I18n
-            month_names = options[:use_month_names] || begin
-              key = options[:use_short_month] ? :'date.abbr_month_names' : :'date.month_names'
-              I18n.translate key, :locale => locale
-            end
-          else
-            month_names = options[:use_short_month] ? Date::ABBR_MONTHNAMES : Date::MONTHNAMES
-          end
+          month_names = options[:use_short_month] ? Date::ABBR_MONTHNAMES : Date::MONTHNAMES
         end
-        month_names.unshift(nil) if month_names.size < 13
+      end
+      month_names.unshift(nil) if month_names.size < 13
 
-        1.upto(12) do |month_number|
-          month_name = if options[:use_month_numbers]
-            month_number
-          elsif options[:add_month_numbers]
-            month_number.to_s + ' - ' + month_names[month_number]
-          else
-            month_names[month_number]
-          end
-    
-          month_options << ((val == month_number) ?
-            content_tag(:option, month_name, :value => month_number, :selected => "selected") :
-            content_tag(:option, month_name, :value => month_number)
-          )
-          month_options << "\n"
-        end
-        
-        if DATE_HELPERS_RECEIVE_HTML_OPTIONS
-          if self.class.private_instance_methods.include? "_date_select_html"
-            _date_select_html(options[:field_name] || 'month', month_options.join, options, html_options)
-          else
-            select_html(options[:field_name] || 'month', month_options.join, options, html_options)
-          end
+      1.upto(12) do |month_number|
+        month_name = if options[:use_month_numbers]
+          month_number
+        elsif options[:add_month_numbers]
+          month_number.to_s + ' - ' + month_names[month_number]
         else
-          select_html(options[:field_name] || 'month', month_options.join, options)
+          month_names[month_number]
         end
+  
+        month_options << ((val == month_number) ?
+          content_tag(:option, month_name, :value => month_number, :selected => "selected") :
+          content_tag(:option, month_name, :value => month_number)
+        )
+        month_options << "\n"
       end
-    end
-    
-    alias :stock_select_date :select_date
-    # Заменяет ActionView::Helpers::DateHelper::select_date меню выбора русской даты.
-    def select_date(date = Date.current, options = {}, html_options = {})
-      options[:order] ||= [:day, :month, :year]
+      
       if DATE_HELPERS_RECEIVE_HTML_OPTIONS
-        stock_select_date(date, options, html_options)
+        if self.class.private_instance_methods.include? "_date_select_html"
+          _date_select_html(options[:field_name] || 'month', month_options.join, options, html_options)
+        else
+          select_html(options[:field_name] || 'month', month_options.join, options, html_options)
+        end
       else
-        stock_select_date(date, options)
+        select_html(options[:field_name] || 'month', month_options.join, options)
       end
     end
   end
   
-  module Object::ActionView::Helpers
-    if defined?(InstanceTag) && InstanceTag.private_method_defined?(:date_or_time_select)
-      class InstanceTag #:nodoc:
-        private
-          alias :stock_date_or_time_select :date_or_time_select
-          def date_or_time_select(options, html_options = {})
-            options[:order] ||= [:day, :month, :year]
-            if DATE_HELPERS_RECEIVE_HTML_OPTIONS
-              stock_date_or_time_select(options, html_options)
-            else
-              stock_date_or_time_select(options)
-            end
+  alias :stock_select_date :select_date
+  # Заменяет ActionView::Helpers::DateHelper::select_date меню выбора русской даты.
+  def select_date(date = Date.current, options = {}, html_options = {})
+    options[:order] ||= [:day, :month, :year]
+    if DATE_HELPERS_RECEIVE_HTML_OPTIONS
+      stock_select_date(date, options, html_options)
+    else
+      stock_select_date(date, options)
+    end
+  end
+end
+
+module Object::ActionView::Helpers
+  if defined?(InstanceTag) && InstanceTag.private_method_defined?(:date_or_time_select)
+    class InstanceTag #:nodoc:
+      private
+        alias :stock_date_or_time_select :date_or_time_select
+        def date_or_time_select(options, html_options = {})
+          options[:order] ||= [:day, :month, :year]
+          if DATE_HELPERS_RECEIVE_HTML_OPTIONS
+            stock_date_or_time_select(options, html_options)
+          else
+            stock_date_or_time_select(options)
           end
-      end
+        end
     end
   end
-  
-end #endif
+end

data/lib/integration/rails_pre_filter.rb

@@ -1,3 +1,4 @@
+# -*- encoding: utf-8 -*- 
 class ActionController::Base
   before_filter { RuTils::overrides = true }
 end

data/lib/pluralizer/pluralizer.rb

@@ -1,3 +1,4 @@
+# -*- encoding: utf-8 -*- 
 module RuTils
   module Pluralization #:nodoc:
     # Выбирает нужный падеж существительного в зависимости от числа
@@ -97,10 +98,10 @@ module RuTils
       rest = rest % 100
       rest1 = rest / 10
       ones = ""
-      case rest1
-        when 0 then tens = ""
+      tens = case rest1
+        when 0 then ""
         when 1 # особый случай
-          tens = case rest
+          case rest
             when 10 then "десять "
             when 11 then "одиннадцать "
             when 12 then "двенадцать "
@@ -112,14 +113,14 @@ module RuTils
             when 18 then "восемнадцать "
             when 19 then "девятнадцать "
           end
-        when 2: tens = "двадцать "
-        when 3: tens = "тридцать "
-        when 4: tens = "сорок "
-        when 5: tens = "пятьдесят "
-        when 6: tens = "шестьдесят "
-        when 7: tens = "семьдесят "
-        when 8: tens = "восемьдесят "
-        when 9: tens = "девяносто "
+        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 # единицы
@@ -156,8 +157,8 @@ module RuTils
       end
 
       # сборка строки
-      st = ''
-      return [(st << hundreds.to_s << tens.to_s  << ones.to_s << end_word.to_s << " " << into.to_s).strip, tmp_val] 
+      plural = [hundreds, tens, ones, end_word,  " ",  into].join.strip 
+      return [plural, tmp_val] 
     end
     
     # Реализует вывод прописью любого объекта, реализующего Float

data/lib/rutils.rb

@@ -1,24 +1,20 @@
+# -*- encoding: utf-8 -*- 
 $KCODE = 'u'
 
+require File.dirname(__FILE__) + '/version'
+
 # Главный контейнер модуля
 module RuTils
-  #:stopdoc:
-  
   # Папка, куда установлен модуль RuTils. Нужно чтобы автоматически копировать RuTils в другие приложения.
   INSTALLATION_DIRECTORY = File.expand_path(File.dirname(__FILE__) + '/../') #:nodoc:
-  MAJOR = 0  #:nodoc:
-  MINOR = 2  #:nodoc:
-  TINY  = 5  #:nodoc:
-
-  # Стандартный маркер для подстановок - invalid UTF sequence
-  SUBSTITUTION_MARKER = "\xF0\xF0\xF0\xF0" #:nodoc:
-  
-  # :startdoc:
   
-  # Версия RuTils
-  VERSION = [MAJOR, MINOR ,TINY].join('.')
+  # Стандартный маркер для подстановок - Unicode Character 'OBJECT REPLACEMENT CHARACTER' (U+FFFC)
+  # http://unicode.org/reports/tr20/tr20-1.html
+  # Он официально применяется для обозначения вложенного обьекта
+  SUBSTITUTION_MARKER = [0xEF, 0xBF, 0xBC].pack("U*").freeze
   
-  @@overrides = true
+  class RemovedFeature < RuntimeError
+  end
   
   # Метод позволяет проверить, включена ли перегрузка функций других модулей.
   # Попутно он спрашивает модуль Locale (если таковой имеется) является ли русский
@@ -37,28 +33,22 @@ module RuTils
   
   # Включает или выключает перегрузки других модулей. Полезно, например, в случае когда нужно рендерить страницу
   # сайта на нескольких языках и нужно отключить русское оформление текста для других языков.  
+  #
+  # Флаг overrides в RuTils работают в контексте текущей нити
   def overrides=(new_override_flag)
     Thread.current[:rutils_overrided_enabled] = (new_override_flag ? true : false)
   end
   module_function :overrides=
   
-  def self.thread_local_or_own_flag
+  def self.thread_local_or_own_flag #:nodoc:
     Thread.current.keys.include?(:rutils_overrided_enabled) ? Thread.current[:rutils_overrided_enabled] : false
   end
   
   def self.load_component(name) #:nodoc:
     require File.join(RuTils::INSTALLATION_DIRECTORY, "lib", name.to_s, name.to_s)
   end
-
-  def self.reload_component(name) #:nodoc:
-    load File.join(RuTils::INSTALLATION_DIRECTORY, "lib", name.to_s, "#{name}.rb")
-  end
 end
 
-
-RuTils::load_component :pluralizer #Выбор числительного и сумма прописью
-RuTils::load_component :gilenson # Гиленсон
-RuTils::load_component :datetime # Дата и время без локалей
-RuTils::load_component :transliteration # Транслит
-RuTils::load_component :integration # Интеграция с rails, textile и тд
-RuTils::load_component :countries # Данные о странах на русском и английском
+[:pluralizer, :gilenson, :datetime, :transliteration, :integration, :countries].each do | submodule |
+  require File.join(RuTils::INSTALLATION_DIRECTORY, "lib", submodule.to_s, submodule.to_s)
+end