rutils 0.1.0 → 0.1.1

data/README

@@ -1,20 +1,16 @@
 == Добро пожаловать в RuTils
 
-RuTils - простой обработчик русского текста, позволяющий использовать и обрабатывать
-русский текст несколькими несложными способами. Основная цель RuTils - сделать
+RuTils - простой обработчик русского текста на Ruby. Основная цель RuTils - сделать
 разработку русскоязычных приложений на Ruby (и Rails) максимально простой и приятной (в идеале - столь же
 простой как и разработку оных на английском)
 
 Весь функционал RuTils поддерживает только UTF-8 (настройка $KCODE / KanjiCode 'u'). Стандартно работа RuTils проверяется
 как на стандартной версии Ruby, так и на парсере регулярных выражений Oniguruma (правда имейте в виду, что с ним
 Gilenson работает медленнее).
-
-
-Это версия RuTils
-
-	$Revision: 1.7 $
 	
-Пожалуйста упоминайте версию при сообщении ошибок.
+Пожалуйста упоминайте версию при сообщении ошибок. Версию RUTILS всегда можно узнать в константе
+
+  RuTils::VERSION
 
 Удостоверьтесь, что ваш скрипт правильно обрабатывает Unicode - то есть:
 
@@ -79,7 +75,15 @@ Textile английские кавычки и типографские знак
 
 Перегрузку всех функций (RedCloth, BlueCloth и компоненты Rails) можно включать и отключать в любое время
 с помощью метода overrides= модуля RuTils. Когда перегрузка выключена, все сторонние библиотеки будут работать
-в стандартном режиме (например, RedCloth будет расставлять английские типографские кавычки). 
+в стандартном режиме (например, RedCloth будет расставлять английские типографские кавычки). Это нужно
+когда вам нужно переключиться на английский (или любой другой язык) без перезапуска приложения.
+
+Если вы хотите использовать rutils как дополенние к Rails в одном конкретном приложении, скопируйте
+директорию rutils в папку vendor/plugins вашего приложения. Вы можете воспользоваться командой
+rutilize чтобы сделать это автоматически. После этого вы сможете использовать RuTils без
+необходимости установки gem'а.
+
+  $ rutilize /Sites/my_app
 
 == Требования
 

data/bin/gilensize

@@ -2,6 +2,17 @@
 $KCODE = 'u'
 require File.dirname(__FILE__) + '/../lib/rutils'
 
+# == Synopsis
+# 
+# Processes text on standard input with Typografica
+# 
+# == Usage
+# 
+#   cat myfile.txt | gilensize > output.txt
+#   
+# == Author
+#   Julik <me@julik.nl>
+
 while st = gets do
 	puts RuTils::Gilenson::Formatter.new(st).to_html
 end

data/bin/rutilize

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+# == Synopsis
+# 
+# Copy RuTils to your Rails application, automatically making it speak Russian.
+# The application will need to be restarted for changes to take effect.
+# After that your app contains RuTils and is not dependent on RuTils gem
+# 
+# == Usage
+# 
+#   rutilize /Sites/my_app /Sites/my_other_app
+#   
+# == Author
+#   Julik <me@julik.nl>
+  
+
+$KCODE = 'u'
+require File.dirname(__FILE__) + '/../lib/rutils'
+require 'optparse'
+require 'rdoc/usage'
+
+opts = OptionParser.new
+opts.on(" -h", "--help") { RDoc::usage }
+opts.parse(ARGV) rescue RDoc::usage('usage')
+
+if ARGV.empty?
+  RDoc::usage_no_exit('usage')
+  exit(-1)
+end
+
+for item in ARGV
+  puts "Teaching #{item} to speak Russian"
+  raise "The directory #{item} does not exist" unless File.exist?(item)
+  raise "#{item} - not a directory" unless File.directory?(item)
+  raise "This directory doesn't seem to be a Rails application" unless File.exist?(item + '/vendor')
+  Dir::mkdir(item+'/vendor/plugins') unless File.exist?(item + '/vendor/plugins')
+  `cp -r #{RuTils::INSTALLATION_DIRECTORY} #{item}/vendor/plugins`
+end

data/lib/datetime/datetime.rb

@@ -31,7 +31,7 @@ module RuTils
 				 when 46..90		 then 'около часа'
 				 # исключение, сдвигаем на один влево чтобы соответствовать падежу
 				 when 90..1440	 then "около " + (distance_in_minutes.to_f / 60.0).round.to_s + 
-				                      " " + (distance_in_minutes.to_f / 60.0).round.items("часа", "часов", nil)
+				                      " " + (distance_in_minutes.to_f / 60.0).round.items("часа", "часов", '')
 				 when 1441..2880 then '1 день'
 				 else									(distance_in_minutes / 1440).round.to_s + 
 				                      " " + (distance_in_minutes / 1440).round.items("день", "дня", "дней")

data/lib/gilenson/gilenson_port.rb

@@ -330,11 +330,12 @@ module RuTils
 
 end #end RuTils
 
+# Вгружаем этот форматтер если уже не загружен наш новый
 unless defined?(RuTils::Gilenson::Formatter)
   class RuTils::Gilenson::Formatter < RuTils::Gilenson::Typografica
   end
 end
 
-class String
+class Object::String
 	include RuTils::Gilenson::StringFormatting
 end

data/lib/integration/blue_cloth_override.rb

@@ -1,5 +1,5 @@
 if defined?(BlueCloth)
-  class BlueCloth < String  #:nodoc:
+  class Object::BlueCloth < String  #:nodoc:
     alias_method :old_to_html, :to_html
     def to_html(*opts)
       RuTils::overrides_enabled? ? RuTils::Gilenson::Formatter.new(old_to_html(*opts)).to_html : old_to_html(*opts)

data/lib/integration/integration.rb

@@ -4,7 +4,7 @@ module RuTils
   # Метод позволяет проверить, включена ли перегрузка функций других модулей.
   # Попутно он спрашивает модуль Locale (если таковой имеется) является ли русский
   # текущим языком, и если является, включает перегрузку функций имплицитно.
-  # Модуль Locale можно скачать и скомпилировать а можно получить как часть Multilingual Rails.
+  # Модуль Locale можно получить как часть Multilingual Rails.
   def self.overrides_enabled?
     if defined?(Locale) and Locale.respond_to?(:current)
       return true if Locale.current.split('_').first == 'ru'
@@ -17,8 +17,14 @@ module RuTils
   def self.overrides= (new_override_flag)
     @@overrides = (new_override_flag ? true : false)
   end
+  
+  # Вновь выполняет перегрузку. Делать это надо после того, как в программу импортированы
+  # другие модули.
+  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
 
-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'
+RuTils::reload_integrations!

data/lib/integration/rails_date_helper_override.rb

@@ -1,5 +1,5 @@
-if defined?(ActionView)
-  module ActionView  #:nodoc:
+if defined?(Object::ActionView)
+  module Object::ActionView  #:nodoc:
     module Helpers
       module DateHelper
 

data/lib/integration/red_cloth_override.rb

@@ -1,6 +1,6 @@
-if defined?(RedCloth)
+if defined?(Object::RedCloth)
   # RuTils выполняет перегрузку Textile Glyphs в RedCloth, перенося форматирование спецсимволов на Gilenson.
-  class RedCloth  < String #:nodoc:
+  class Object::RedCloth  < String #:nodoc:
     # Этот метод в RedCloth эскейпит слишком много HTML, нам ничего не оставляет :-)    
     alias_method  :stock_htmlesc, :htmlesc
     def htmlesc(text, mode=0) #:nodoc:

data/lib/pluralizer/pluralizer.rb

@@ -55,17 +55,17 @@ module RuTils
 			# начинаем подсчет с Rest
 			end_word = five_items
 			# сотни
-			case rest / 100
-				when 0 then hundreds = ""
-				when 1 then hundreds = "сто "
-				when 2 then hundreds = "двести "
-				when 3 then hundreds = "триста "
-				when 4 then hundreds = "четыреста "
-				when 5 then hundreds = "пятьсот "
-				when 6 then hundreds = "шестьсот "
-				when 7 then hundreds = "семьсот "
-				when 8 then hundreds = "восемьсот "
-				when 9 then hundreds = "девятьсот "
+			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
 
 			# десятки
@@ -75,17 +75,17 @@ module RuTils
 			case rest1
 				when 0 then tens = ""
 				when 1 # особый случай
-					case rest
-						when 10 then tens = "десять "
-						when 11 then tens = "одиннадцать "
-						when 12 then tens = "двенадцать "
-						when 13 then tens = "тринадцать "
-						when 14 then tens = "четырнадцать "
-						when 15 then tens = "пятнадцать "
-						when 16 then tens = "шестнадцать "
-						when 17 then tens = "семнадцать "
-						when 18 then tens = "восемнадцать "
-						when 19 then tens = "девятнадцать "
+					tens = 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: tens = "двадцать "
 				when 3: tens = "тридцать "
@@ -100,13 +100,10 @@ module RuTils
 			if rest1 < 1 or rest1 > 1 # единицы
 				case rest % 10
 					when 1
-						case gender
-							when 1
-								ones = "один "
-							when 2
-								ones = "одна "
-							when 3
-								ones = "одно "
+						ones = case gender
+							when 1 then "один "
+							when 2 then "одна "
+							when 3 then "одно "
 						end
 						end_word = one_item
 					when 2
@@ -134,7 +131,8 @@ module RuTils
 			end
 
 			# сборка строки
-			return [(hundreds.to_s + tens.to_s + ones.to_s + end_word.to_s + " " + into.to_s).strip, tmp_val] 
+			st = ''
+			return [(st << hundreds.to_s << tens.to_s  << ones.to_s << end_word.to_s << " " << into.to_s).strip, tmp_val] 
 		end
 		
 		# Реализует вывод прописью любого объекта, реализующего Float
@@ -144,14 +142,14 @@ module RuTils
 			# дробная доля оканчивается на нули) до ближайшей доли ( 500 тысячных округляется до 5 десятых).
 			# Дополнительный аргумент - род существительного (1 - мужской, 2- женский, 3-средний)
 			def propisju(gender = 2)
-				raise "NaN propisju eto ne propis!" if self.nan?
+				raise "Это не число!" if self.nan?
 		
 				st = RuTils::Pluralization::sum_string(self.to_i, gender, "целая", "целых", "целых")
 				it = []
 	
-				rmdr = self.to_s.match(/\.(\d+)/)[1]
+				remainder = self.to_s.match(/\.(\d+)/)[1]
 		
-				signs = rmdr.to_s.size- 1
+				signs = remainder.to_s.size- 1
 				
 				it << ["десятая", "десятых"]
 				it << ["сотая", "сотых"]
@@ -167,12 +165,12 @@ module RuTils
 		 # 	it << ["триллионная", "триллионных", "триллионных"]
 
 				while it[signs].nil?
-					rmdr = (rmdr/10).round
-					signs = rmdr.to_s.size- 1
+					remainder = (remainder/10).round
+					signs = remainder.to_s.size- 1
 				end
-								
+
 				suf1, suf2, suf3 = it[signs][0], it[signs][1], it[signs][2]
-				st + " " + RuTils::Pluralization::sum_string(rmdr.to_i, 2, suf1, suf2, suf2)
+				st + " " + RuTils::Pluralization::sum_string(remainder.to_i, 2, suf1, suf2, suf2)
 			end
 
 			def propisju_items(gender=1, *forms)
@@ -207,11 +205,11 @@ module RuTils
 	end
 end
 
-class Numeric
+class Object::Numeric
 	include RuTils::Pluralization::NumericFormatting
 end
 
 
-class Float
+class Object::Float
 	include RuTils::Pluralization::FloatFormatting
 end

data/lib/rutils.rb

@@ -1,11 +1,13 @@
 $KCODE = 'u'
-require 'jcode'
+require 'jcode' # вот от этого надо бы избавиться - скопировать jsize из jcode и поместить его в свой namespace
+
 
 # Главный контейнер модуля
 module RuTils
+  INSTALLATION_DIRECTORY = File.expand_path(File.dirname(__FILE__) + '/../')
   MAJOR = 0
   MINOR = 1
-  TINY = 0
+  TINY = 1
 	VERSION = "#{MAJOR}.#{MINOR}.#{TINY}"
 end
 

data/lib/transliteration/transliteration.rb

@@ -3,7 +3,7 @@ module RuTils
   end
 end
 
-# Реулизует простейшую транслитерацию
+# Реализует простейшую транслитерацию
 #   "вот мы и здесь".translify => "vot my i zdes"
 #   "vot my i zdes".detranslify => "вот мы и здесь"
 module RuTils::Transliteration::Simple
@@ -56,8 +56,8 @@ module RuTils::Transliteration::Simple
 	end
 end
 		
-# Реулизует транслитерацию "в обе стороны", дающую возможность автоматически использовать URL как ключ записи
-module RuTils::Transliteration::BiDi
+# Реализует транслитерацию "в обе стороны", дающую возможность автоматически использовать URL как ключ записи
+module RuTils::Transliteration::BiDi  #:nodoc:
 		TABLE_TO = {
 			 "А"=>"A","Б"=>"B","В"=>"V","Г"=>"G","Д"=>"D",
 			 "Е"=>"E","Ё"=>"JO","Ж"=>"ZH","З"=>"Z","И"=>"I",
@@ -148,26 +148,26 @@ module RuTils::Transliteration::StringFormatting
 	end
 	
 	# Транслитерирует строку (взаимно-однозначный транслит), и возвращает измененную строку
-	def bidi_translify(allow_slashes = true)
+	def bidi_translify(allow_slashes = true) #:nodoc:
 		RuTils::Transliteration::BiDi::translify(self.to_s, allow_slashes)
 	end
 	
 	# Транслитерирует строку (взаимно-однозначный транслит), меняя объект
-	def bidi_translify!(allow_slashes = true)
+	def bidi_translify!(allow_slashes = true) #:nodoc:
 		self.replace(RuTils::Transliteration::BiDi::translify(self.to_s, allow_slashes))
 	end
 
 	# Заменяет латиницу на кириллицу (взаимно-однозначный транслит), меняя объект
-	def bidi_detranslify!(allow_slashes = true)
+	def bidi_detranslify!(allow_slashes = true) #:nodoc:
 		self.replace(RuTils::Transliteration::BiDi::detranslify(self.to_s, allow_slashes))
 	end
 	
 	# Заменяет латиницу на кириллицу (взаимно-однозначный транслит), и возвращает измененную строку
-	def bidi_detranslify(allow_slashes = true)
+	def bidi_detranslify(allow_slashes = true) #:nodoc:
 		RuTils::Transliteration::BiDi::detranslify(self.to_s, allow_slashes =  true)
 	end
 end
 
-class String
+class Object::String
 	include RuTils::Transliteration::StringFormatting
 end

data/test/t_binaries.rb

@@ -0,0 +1,26 @@
+$KCODE = 'u'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/rutils'
+
+
+class RutilizeTest < Test::Unit::TestCase
+  def setup
+    @dirs = [
+      '/tmp/app',
+      '/tmp/notapp',
+      '/tmp/app/vendor',
+    ]
+    @dirs.each{|dir|  Dir::mkdir(dir) }
+    @rutilize = File.dirname(__FILE__) + '/../bin/rutilize'
+  end
+  
+  def test_rutilize_app
+    `#{@rutilize} #{@dirs[0]}`
+    assert File.exist?(@dirs[0] + '/vendor/plugins/rutils')
+    assert File.exist?(@dirs[0] + '/vendor/plugins/rutils/lib/rutils.rb')
+  end
+    
+  def teardown
+    @dirs.each {|dir|  `rm -rf #{dir}` }
+  end
+end

data/test/t_datetime.rb

@@ -7,5 +7,6 @@ class DistanceOfTimeTest < Test::Unit::TestCase
 		assert_equal "меньше минуты", RuTils::DateTime::distance_of_time_in_words(0, 50)
 		assert_equal "2 минуты", RuTils::DateTime::distance_of_time_in_words(0, 140)
 		assert_equal "около 2 часов", RuTils::DateTime::distance_of_time_in_words(0, 60*114)
+		assert_equal "около 3 часов", RuTils::DateTime::distance_of_time_in_words(0, 60*120+60*60)
 	end
 end

data/test/t_integration.rb

@@ -2,16 +2,14 @@ $KCODE = 'u'
 require 'test/unit'
 require 'rubygems'
 
+require 'action_view'
 require_gem 'RedCloth'
 require_gem 'BlueCloth'
 
-
 require File.dirname(__FILE__) + '/../lib/rutils'
+load File.dirname(__FILE__) +  '/../lib/integration/integration.rb'
 
-# Весь integration надо грузить после патчимых пакетов
-load File.dirname(__FILE__) + '/../lib/integration/integration.rb'
-
-class IntegrationTest < Test::Unit::TestCase
+class IntegrationFlagTest < Test::Unit::TestCase
   def setup
     RuTils::overrides = true
   end
@@ -21,23 +19,54 @@ class IntegrationTest < Test::Unit::TestCase
     assert !RuTils::overrides_enabled?
     RuTils::overrides = true    
     assert RuTils::overrides_enabled?
-  end
+  end  
 end
 
 # Интеграция с RedCloth - Textile.
 # Нужно иметь в виду что Textile осуществляет свою обработку типографики, которую мы подменяем!
-class TextileIntegrationTest < IntegrationTest
-	def test_integration_textile		
+class TextileIntegrationTest < Test::Unit::TestCase
+	def test_integration_textile
+	  RuTils::overrides = true
+	  assert RuTils.overrides_enabled?
 		assert_equal "<p>И&nbsp;вот &laquo;они пошли туда&raquo;, и&nbsp;шли шли&nbsp;шли</p>", 
 			RedCloth.new('И вот "они пошли туда", и шли шли шли').to_html
+
+  	RuTils::overrides = false
+	  assert !RuTils.overrides_enabled?
+		assert_equal "<p>И вот &#8220;они пошли туда&#8221;, и шли шли шли</p>", 
+			RedCloth.new('И вот "они пошли туда", и шли шли шли').to_html
 	end
 end
 
 # Интеграция с BlueCloth - Markdown
 # Сам Markdown никакой обработки типографики не производит (это делает RubyPants, но вряд ли его кто-то юзает на практике)
-class MarkdownIntegrationTest < IntegrationTest
+class MarkdownIntegrationTest < Test::Unit::TestCase
 	def test_integration_markdown
+	  RuTils::overrides = true
+	  assert RuTils.overrides_enabled?
 		assert_equal "<p>И вот&nbsp;&laquo;они пошли туда&raquo;, и&nbsp;шли шли&nbsp;шли</p>", 
 			BlueCloth.new('И вот "они пошли туда", и шли шли шли').to_html
+			
+		RuTils::overrides = false
+	  assert !RuTils.overrides_enabled?
+		assert_equal "<p>И вот \"они пошли туда\", и шли шли шли</p>", 
+			BlueCloth.new('И вот "они пошли туда", и шли шли шли').to_html
 	end
-end
+end
+
+# Перегрузка helper'ов Rails
+class RailsHelpersOverrideTest < Test::Unit::TestCase
+	def test_distance_of_time_in_words
+	  eval 'class Foo
+	          include ActionView::Helpers::DateHelper
+	          def get_dst
+	            distance_of_time_in_words(Time.now - 20.minutes, Time.now)
+	          end
+	        end'
+	        
+	  RuTils::overrides = true
+	  foo = Foo.new
+	  assert_equal "20 минут", foo.get_dst
+	end
+end
+

data/test/t_rutils_base.rb

@@ -0,0 +1,10 @@
+$KCODE = 'u'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/rutils'
+
+class RutilsBaseTest < Test::Unit::TestCase
+  def test_rutils_location
+    libdir = File.expand_path(File.dirname(__FILE__) + '/../')
+    assert_equal libdir, RuTils::INSTALLATION_DIRECTORY
+  end
+end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: rutils
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
-date: 2005-10-23 00:00:00 +02:00
+  version: 0.1.1
+date: 2005-10-29 00:00:00 +02:00
 summary: Simple processing of russian strings
 require_paths: 
   - lib
@@ -31,11 +31,14 @@ authors:
   - Julian "Julik" Tarkhanov
 files: 
   - bin/gilensize
+  - bin/rutilize
   - test/run_tests.rb
+  - test/t_binaries.rb
   - test/t_datetime.rb
   - test/t_gilenson.rb
   - test/t_integration.rb
   - test/t_pluralize.rb
+  - test/t_rutils_base.rb
   - test/t_transliteration.rb
   - test/t_typografica.rb
   - lib/datetime
@@ -61,6 +64,7 @@ test_files:
 rdoc_options: 
   - "--main=README"
   - "--line-numbers"
+  - "--webcvs http://rubyforge.org/cgi-bin/viewcvs.cgi/rutils/%s?cvsroot=rutils"
   - "--charset=utf-8"
   - "--promiscuous"
 extra_rdoc_files: 
@@ -69,6 +73,7 @@ extra_rdoc_files:
   - CHANGELOG
 executables: 
   - gilensize
+  - rutilize
 extensions: []
 requirements: []
 dependencies: []