julik-rutils 1.0.2

data/lib/rutils.rb

@@ -0,0 +1,54 @@
+# -*- encoding: utf-8 -*- 
+$KCODE = 'u'
+
+require File.dirname(__FILE__) + '/version'
+
+# Главный контейнер модуля
+module RuTils
+  # Папка, куда установлен модуль RuTils. Нужно чтобы автоматически копировать RuTils в другие приложения.
+  INSTALLATION_DIRECTORY = File.expand_path(File.dirname(__FILE__) + '/../') #:nodoc:
+  
+  # Стандартный маркер для подстановок - Unicode Character 'OBJECT REPLACEMENT CHARACTER' (U+FFFC)
+  # http://unicode.org/reports/tr20/tr20-1.html
+  # Он официально применяется для обозначения вложенного обьекта
+  SUBSTITUTION_MARKER = [0xEF, 0xBF, 0xBC].pack("U*").freeze
+  
+  class RemovedFeature < RuntimeError
+  end
+  
+  # Метод позволяет проверить, включена ли перегрузка функций других модулей.
+  # Попутно он спрашивает модуль Locale (если таковой имеется) является ли русский
+  # текущим языком, и если является, включает перегрузку функций имплицитно.
+  # Это позволяет подчинить настройку перегруженных функций настроенной локали.
+  # Модуль Locale можно получить как часть Ruby-Gettext или как отдельный
+  # модуль ruby-locale. Мы поддерживаем оба.
+  def overrides_enabled?
+    if defined?(Locale) and Locale.respond_to?(:current)
+      return true if Locale.current.to_s.split('_').first == 'ru'
+    end
+    thread_local_or_own_flag ? true : false
+  end
+  alias_method :overrides, :overrides_enabled?
+  module_function :overrides_enabled?
+  
+  # Включает или выключает перегрузки других модулей. Полезно, например, в случае когда нужно рендерить страницу
+  # сайта на нескольких языках и нужно отключить русское оформление текста для других языков.  
+  #
+  # Флаг 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 #: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
+end
+
+[:pluralizer, :gilenson, :datetime, :transliteration, :integration, :countries].each do | submodule |
+  require File.join(RuTils::INSTALLATION_DIRECTORY, "lib", submodule.to_s, submodule.to_s)
+end

data/lib/transliteration/bidi.rb

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*- 
+# ++DEPRECATED++ Этот модуль удален и присутствует только для выдачи сообщения об ошибке.
+module RuTils::Transliteration::BiDi
+  ERR = "Equivalent bidirectional transliteration for URLs is malpractive. BiDi translit has been removed from RuTils"
+  
+  extend self
+  
+  # ++DEPRECATED++ 
+  def translify(str, allow_slashes = true)
+    bail!
+  end
+
+  # ++DEPRECATED++ 
+  def detranslify(str, allow_slashes = true)
+    bail!
+  end
+  
+  def bail! #:nodoc:
+    raise RuTils::RemovedFeature, ERR
+  end
+end

data/lib/transliteration/simple.rb

@@ -0,0 +1,75 @@
+# -*- encoding: utf-8 -*- 
+# Реализует простейшую транслитерацию
+#   "вот мы и здесь".translify => "vot my i zdes"
+#   "vot my i zdes".detranslify => "вот мы и здесь"
+module RuTils::Transliteration::Simple
+  TABLE_LOWER = {
+     "і"=>"i","ґ"=>"g","ё"=>"yo","№"=>"#","є"=>"e",
+     "ї"=>"yi","а"=>"a","б"=>"b",
+     "в"=>"v","г"=>"g","д"=>"d","е"=>"e","ж"=>"zh",
+     "з"=>"z","и"=>"i","й"=>"y","к"=>"k","л"=>"l",
+     "м"=>"m","н"=>"n","о"=>"o","п"=>"p","р"=>"r",
+     "с"=>"s","т"=>"t","у"=>"u","ф"=>"f","х"=>"h",
+     "ц"=>"ts","ч"=>"ch","ш"=>"sh","щ"=>"sch","ъ"=>"'",
+     "ы"=>"yi","ь"=>"","э"=>"e","ю"=>"yu","я"=>"ya"
+  }.sort do | one, two|
+    two[1].size <=> one[1].size
+  end
+  
+  TABLE_UPPER =  {
+    "Ґ"=>"G","Ё"=>"YO","Є"=>"E","Ї"=>"YI","І"=>"I",
+    "А"=>"A","Б"=>"B","В"=>"V","Г"=>"G",
+     "Д"=>"D","Е"=>"E","Ж"=>"ZH","З"=>"Z","И"=>"I",
+     "Й"=>"Y","К"=>"K","Л"=>"L","М"=>"M","Н"=>"N",
+     "О"=>"O","П"=>"P","Р"=>"R","С"=>"S","Т"=>"T",
+     "У"=>"U","Ф"=>"F","Х"=>"H","Ц"=>"TS","Ч"=>"CH",
+     "Ш"=>"SH","Щ"=>"SCH","Ъ"=>"'","Ы"=>"YI","Ь"=>"",
+     "Э"=>"E","Ю"=>"YU","Я"=>"YA",
+  }.sort do | one, two|
+     two[1].size <=> one[1].size
+  end
+
+  TABLE = TABLE_UPPER + TABLE_LOWER
+  
+  # Заменяет кириллицу в строке на латиницу. Немного специфично потому что поддерживает
+  # комби-регистр (Щука -> Shuka)
+  def self.translify(str)
+    chars = str.split(//)    
+    
+    lowers = TABLE_LOWER.map{|e| e[0] }
+    uppers = TABLE_UPPER.map{|e| e[0] }
+    
+    hashtable = {}
+    TABLE.each do | item |
+      next unless item[0] && item[1]
+      hashtable[item[0]] = item[1]
+    end
+    
+    result = ''
+    chars.each_with_index do | char, index |
+      if uppers.include?(char) && lowers.include?(chars[index+1])
+        # Combined case. Here we deal with Latin letters so there is no problem to use
+        # Ruby's builtin upcase_downcase
+        ch = hashtable[char].downcase.capitalize
+        result << ch
+      elsif uppers.include?(char)
+        result << hashtable[char]        
+      elsif lowers.include?(char)
+        result << hashtable[char]
+      else
+        result << char
+      end
+    end
+    return result
+  end
+
+  # Транслитерирует строку, делая ее пригодной для применения как имя директории или URL
+  def self.dirify(string)
+    st = self.translify(string)
+    st.gsub!(/(\s\&\s)|(\s\&amp\;\s)/, ' and ') # convert & to "and"
+    st.gsub!(/\W/, ' ')  #replace non-chars
+    st.gsub!(/(_)$/, '') #trailing underscores
+    st.gsub!(/^(_)/, '') #leading unders
+    st.strip.translify.gsub(/(\s)/,'-').downcase.squeeze('-')
+  end
+end

data/lib/transliteration/transliteration.rb

@@ -0,0 +1,53 @@
+# -*- encoding: utf-8 -*- 
+module RuTils
+  module Transliteration #:nodoc:
+  end
+end
+
+require File.join(File.dirname(__FILE__), 'simple')
+
+# Заглушка
+require File.join(File.dirname(__FILE__), 'bidi')
+    
+# Реализует транслитерацию любого объекта, реализующего String или to_s
+module RuTils::Transliteration::StringFormatting
+  
+  # Транслитерирует строку в латиницу, и возвращает измененную строку
+  def translify
+    RuTils::Transliteration::Simple::translify(self.to_s)
+  end
+
+  # Транслитерирует строку, меняя объект  
+  def translify!
+    self.replace(self.translify)
+  end
+  
+  # Транслитерирует строку, делая ее пригодной для применения как имя директории или URL
+  def dirify
+    RuTils::Transliteration::Simple::dirify(self.to_s)
+  end
+  
+  # ++DEPRECATED++ Вызывает ошибку
+  def bidi_translify(allow_slashes = true)
+    RuTils::Transliteration::BiDi.bail!
+  end
+  
+  # ++DEPRECATED++ Вызывает ошибку
+  def bidi_translify!(allow_slashes = true)
+    RuTils::Transliteration::BiDi.bail!
+  end
+
+  # ++DEPRECATED++ Вызывает ошибку
+  def bidi_detranslify!(allow_slashes = true)
+    RuTils::Transliteration::BiDi.bail!
+  end
+  
+  # ++DEPRECATED++ Вызывает ошибку
+  def bidi_detranslify(allow_slashes = true)
+    RuTils::Transliteration::BiDi.bail!
+  end
+end
+
+class Object::String
+  include RuTils::Transliteration::StringFormatting
+end

data/lib/version.rb

@@ -0,0 +1,5 @@
+# -*- encoding: utf-8 -*- 
+module RuTils
+  # Версия RuTils
+  VERSION = '1.0.2'
+end

data/test/extras/integration_bluecloth.rb

@@ -0,0 +1,13 @@
+# -*- encoding: utf-8 -*- 
+require 'bluecloth'
+
+# Интеграция с BlueCloth - Markdown
+# Сам Markdown никакой обработки типографики не производит (это делает RubyPants, но вряд ли его кто-то юзает на практике)
+class BlueclothIntegrationTest < Test::Unit::TestCase
+  C = RuTils::Gilenson::BlueClothExtra
+  
+  def test_integration_markdown
+    assert_equal "<p>И вот&#160;&#171;они пошли туда&#187;, и&#160;шли шли&#160;шли</p>", 
+      C.new('И вот "они пошли туда", и шли шли шли').to_html
+  end
+end

data/test/extras/integration_maruku.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*- 
+require 'maruku'
+
+# Интеграция с BlueCloth - Markdown
+# Сам Markdown никакой обработки типографики не производит (это делает RubyPants, но вряд ли его кто-то юзает на практике)
+class MarukuIntegrationTest < Test::Unit::TestCase
+  C = RuTils::Gilenson::MarukuExtra
+  
+  def test_integration_maruku
+    
+    assert_equal "<p>И вот&#160;&#171;они пошли туда&#187;, и&#160;шли шли&#160;шли</p>", 
+      C.new('И вот "они пошли туда", и шли шли шли').to_html
+    
+  end
+end

data/test/extras/integration_rails_filter.rb

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*- 
+require 'action_controller'
+require 'action_controller/test_process'
+require File.dirname(__FILE__) +  '/../../init.rb'
+
+ActionController::Routing::Routes.draw {  |map| map.connect ':controller/:action/:id' }
+
+class RutiledController < ActionController::Base #:nodoc:
+  def overridden
+    raise "Overrides are off" unless RuTils::overrides_enabled?
+    render :inline => '<%= Time.local(2008,8,8).strftime("%B") %>'
+  end
+  def rescue_action(e); raise e; end
+end
+
+class RailsFilterTest < Test::Unit::TestCase
+  
+  def setup
+    @controller = RutiledController.new
+    @request = ActionController::TestRequest.new
+    @response = ActionController::TestResponse.new
+  end
+  
+  def test_overrides_preserved_in_render
+    assert_nothing_raised { get :overridden }
+    assert_response :success
+    assert_equal "август", @response.body
+  end
+end

data/test/extras/integration_rails_gilenson_helpers.rb

@@ -0,0 +1,80 @@
+# -*- encoding: utf-8 -*- 
+
+require 'action_controller'
+require 'action_view'
+
+require 'action_controller/test_process'
+require File.dirname(__FILE__) +  '/../../init.rb'
+
+# Перегрузка helper'ов Rails
+class RailsGilensonHelpersTest < Test::Unit::TestCase
+  
+  class Kontroller < ActionController::Base
+    def action_with_gilensize
+      render :inline => "<%= gilensize('Они пришли -- туда -- к А. П. Чехову') %>"
+    end
+    
+    def action_with_gilensize_and_options
+      render :inline => "<%= gilensize('Они пришли -- туда -- к А. П. Чехову', :raw_output => true) %>"
+    end
+    
+    def action_with_textilize
+      render :inline => "<%= textilize('Они пришли -- туда -- к А. П. Чехову') %>"
+    end
+    
+    def action_with_textilize_without_overrides
+      RuTils.overrides = false
+      render :inline => "<%= textilize('Они пришли -- туда -- к А. П. Чехову') %>"
+    end
+    
+    def action_with_markdown
+      render :inline => "<%= markdown('Они пришли -- туда -- к А. П. Чехову') %>"
+    end
+
+    def action_with_markdown_without_overrides
+      RuTils.overrides = false
+      render :inline => "<%= markdown('Они пришли -- туда -- к А. П. Чехову') %>"
+    end
+    
+    def rescue_action(e)
+      raise e
+    end
+  end
+  
+  def setup
+    @request = ActionController::TestRequest.new
+    @response = ActionController::TestResponse.new
+    @controller = Kontroller.new
+  end
+  
+  def test_action_with_gilensize
+    get :action_with_gilensize
+    assert_equal 'Они&#160;пришли &#8212; туда &#8212; к&#160;А.П.&#8201;Чехову', @response.body
+  end
+  
+  def test_action_with_gilensize_and_options
+    get :action_with_gilensize_and_options
+    assert_equal "Они пришли — туда — к А.П. Чехову", @response.body
+  end
+  
+  def test_action_with_textilize
+    get :action_with_textilize
+    assert_equal "<p>Они пришли &#8212; туда &#8212; к&#160;А.П.&#8201;Чехову</p>", @response.body
+  end
+  
+  def test_action_with_textilize_without_overrides
+    get :action_with_textilize_without_overrides
+    assert_equal "<p>Они пришли &#8212; туда &#8212; к А. П. Чехову</p>", @response.body, "Initials should not be formatted"
+  end
+  
+  def test_action_with_markdown
+    get :action_with_markdown
+    assert_equal "<p>Они пришли &#8212; туда &#8212; к&#160;А.П.&#8201;Чехову</p>", @response.body
+  end
+  
+  def test_action_with_markdown_without_overrides
+    get :action_with_markdown_without_overrides
+    assert_equal "<p>Они пришли -- туда -- к А. П. Чехову</p>", @response.body
+  end
+  
+end

data/test/extras/integration_rails_helpers.rb

@@ -0,0 +1,85 @@
+# -*- encoding: utf-8 -*- 
+
+require 'action_controller'
+require 'action_view'
+
+require 'action_controller/test_process'
+require File.dirname(__FILE__) +  '/../../init.rb'
+require 'action_pack/version'
+
+ma, mi, ti = ActionPack::VERSION::MAJOR, ActionPack::VERSION::MINOR, ActionPack::VERSION::TINY 
+
+raise LoadError, "RuTils is not 2.2.2 compat" if (ma >= 2 && mi >= 2 && ti >= 1)
+
+# Перегрузка helper'ов Rails
+class RailsHelpersOverrideTest < Test::Unit::TestCase
+  TEST_DATE = Date.parse("1983-10-15") # coincidentially...
+  TEST_TIME = Time.local(1983, 10, 15, 12, 15) # also coincidentially...
+  
+  # Вспомогательный класс для тестирования перегруженного DateHelper
+  class HelperStub
+    # для тестирования to_datetime_select_tag
+    def date_field; TEST_TIME; end
+  end
+
+  def setup
+    RuTils::overrides = true
+    # А никто и не говорил что класс должен быть один :-)
+    k = Class.new(HelperStub)
+    [ActionView::Helpers::TagHelper, ActionView::Helpers::DateHelper].each{|m| k.send(:include, m)}
+    @stub = k.new
+  end
+  
+  def test_distance_of_time_in_words
+    assert_equal "20 минут", @stub.distance_of_time_in_words(Time.now - 20.minutes, Time.now)
+  end
+  
+  def test_select_month
+    assert_match /июль/, @stub.select_month(TEST_DATE), 
+      "Месяц в выборе месяца должен быть указан в именительном падеже"
+    assert_match />7\<\/option\>/, @stub.select_month(TEST_DATE, :use_month_numbers => true), 
+      "Хелпер select_month с номером месяца вместо названия месяца"
+    assert_match /10\ \-\ октябрь/, @stub.select_month(TEST_DATE, :add_month_numbers => true), 
+      "Хелпер select_month с номером и названием месяца"
+    assert_match /\>июн\<\/option\>/, @stub.select_month(TEST_DATE, :use_short_month => true), 
+      "Короткое имя месяца при использовании опции :use_short_month"
+    assert_match /name\=\"date\[foobar\]\"/, @stub.select_month(TEST_DATE, :field_name => "foobar"), 
+      "Хелпер select_month должен принимать опцию :field_name"
+    assert_match /type\=\"hidden\".+value\=\"10\"/m, @stub.select_month(TEST_DATE, :use_hidden => true),
+      "Хелпер select_month должен принимать опцию :use_hidden"
+  end
+
+  def test_select_date  
+    assert_match /date\_day.+date\_month.+date\_year/m, @stub.select_date(TEST_DATE),
+      "Хелпер select_date должен выводить поля в следующем порядке: день, месяц, год"
+    assert_match /декабря/, @stub.select_date(TEST_DATE), 
+      "Имя месяца должно быть указано в родительном падеже"
+    assert_match /декабря/, @stub.select_date(TEST_DATE, :order => [:month, :year]),
+      "Хелпер select_date не позволяет опускать фрагменты, имя месяца должно быть указано в родительном падеже"
+    assert_match @stub.select_date, @stub.select_date(Time.now), 
+      "Хелпер select_date без параметров работает с текущей датой"
+  end
+
+  def test_select_datetime
+    assert_match /date\_day.+date\_month.+date\_year/m, @stub.select_datetime(TEST_TIME),
+      "Хелпер select_datetime должен выводить поля в следующем порядке: день, месяц, год"
+  end
+  
+  def test_html_options
+    if ActionView::Helpers::DateHelper::DATE_HELPERS_RECEIVE_HTML_OPTIONS
+      assert_match /id\=\"foobar\"/m,  @stub.select_month(TEST_DATE, {}, :id => "foobar"),
+        "Хелпер select_month принимает html_options"
+
+      assert_match /id\=\"foobar\"/m,  @stub.select_date(TEST_DATE, {}, :id => "foobar"),
+        "Хелпер select_date принимает html_options"
+    end
+  end
+  
+  def test_instance_tag
+    @it = ActionView::Helpers::InstanceTag.new(:stub, :date_field, self).to_datetime_select_tag
+    assert_match /\>10\<.+\>октября\<.+\>1983\</m, @it,
+      "to_datetime_select_rag должен выводить поля в следующем порядке: день, месяц, год"
+    assert_match /июля/m, @it,
+     "to_datetime_select_tag выводит месяц в родительном падеже"
+  end
+end

data/test/extras/integration_rdiscount.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*- 
+require 'rdiscount'
+
+# Интеграция с BlueCloth - Markdown
+# Сам Markdown никакой обработки типографики не производит (это делает RubyPants, но вряд ли его кто-то юзает на практике)
+class RdiscountIntegrationTest < Test::Unit::TestCase
+  C = RuTils::Gilenson::RDiscountExtra
+  
+  def test_integration_markdown
+    
+    assert_equal "<p>И вот&#160;&#171;они пошли туда&#187;, и&#160;шли шли&#160;шли</p>", 
+      C.new('И вот "они пошли туда", и шли шли шли').to_html
+    
+  end
+end