julik-rutils 1.0.2

data/History.txt

@@ -0,0 +1,162 @@
+=== 1.0.2 - 09.02.2009
+
+* В 1879 раз поправлена генерация rdoc из gems
+
+=== 1.0.1 - 08.02.2009
+
+* Оверрайды очищены и уничтожены, перегрузка форматтеров выполняется через наследование и рельсовый хелпер (julik)
+* Протестировано на JRuby 1.1.6 (julik)
+* Основные шестеренки совместимы с Ruby 1.9.1 (julik)
+* BiDi транслит покидает нас. URL давно поддерживают Unicode, если нет - сохраняйте транслитерированный slug отдельно. 
+  Если кому-то это не нравится - см. Wikipedia (julik)
+
+=== 0.2.5 - 08.08.2008
+
+* Поддержка Rails Edge (pre-2.2) для хелперов DateTime. RuTils при overrides_enabled пытается поставить себя выше I18n -- при overrides_enabled I18n не вызывается для datetime хелперов. (Yaroslav Markin)
+* Частичная поддержка RedCloth 4 (julik)
+* Фильтр для контроллера чтобы установить верный флаг для экшена, то что происходит в экшене - thread local (julik)
+* Разделяем тесты и хаки (julik)
+* Добавлена поддержка strftime макроса %e (номер дня в месяце без лидирующего нуля) -- по аналогии с %d, при использовании %e мы склоняем имя месяца (Yaroslav Markin)
+* Использование с RedCloth 4 больше не вызывает ошибки (совместимости для перегрузки все еще нет) (Yaroslav Markin)
+* Добавлен метод Fixnum#kopeek для вывода целочисленных Денег (julik)
+* RuTils::overrides безопасен для нитей (julik)
+
+=== 0.2.4 - 10.07.2008
+
+* Форматтер даты-времени должен гарантированно возвращать результат (Eugene Pimenov + julik)
+* Передаваемый формат даты-времени не должен мутировать в пути (Eugene Pimenov)
+* В Gilenson закрывающая латинская кавычка не принимается за знак дюйма
+* В Gilenson корректно обрабатываются неразрывные пробелы если в сегменте присутствуют пунктуация из глифов
+* В Gilenson добавлены настройки force_en_quotes и force_ru_quotes (если нужно свести все кавычки к одной форме)
+* До свидания, Gilenson::Obsolete (julik)
+* Небольшая чистка инфраструктуры билдов (julik)
+* strftime("%d %B") теперь возвращает день в двузначном формате (например, 01 декабря) (Anonymous)
+* добавлены алиасы #rubl и #rublja для Numeric#rublej. Теперь можно писать: 1.rubl, 3.rublja. (Yaroslav Markin)
+* Переписаны Date хелперы для Rails. Теперь поддерживаются все опции Rails 1.2--2.0 и 
+  Rails 2.1+ (Yaroslav Markin)
+* Переписаны и дополнены тесты на перегрузку Date хелперов Rails (Yaroslav Markin)
+* Для тестирования оверрайдов Rails используется gem multi_rails
+* До свидания, <nobr>. Указывайте .nobr { text-wrap: nowrap } в своих стилевых таблицах.
+
+=== 0.2.3 - 27.09.2007
+
+* Кошмар - в новой версии rubygems изменилась семантика s.files из-за чего мы забыли
+  все файлы в корневой директории - включая init.rb (julik)
+
+=== 0.2.2 - 24.09.2007
+
+* Gilenson - обрабатываем акронимы по принципу Textile (zajats, julik)
+* Gilenson - отформатирован под 2 пробела (julik)
+* В тестах пользуйтесь assert_equal_cp (julik)
+* Welcome to subversion (julik)
+
+=== 0.2.1 - 02.04.2007
+
+* Восстановлен в gemspec gilenson.rb (Сергей Барабаш)
+
+=== 0.2.0 - 02.04.2007
+
+* Фикс squeeze в dirify (Сергей Барабаш)
+* Формат даты по умолчанию - %F (Сергей Барабаш)
+
+=== 0.1.9 - 17.02.2007
+
+* Gilenson integration - не съедаем пробелы между тегами при прогоне текста через Textile 
+
+=== 0.1.8 - 05.02.2007
+
+* Gilenson - расстановка инициалов не должна цеплять аббревиатуры (julik) 
+
+=== 0.1.7 - 05.02.2007
+* Date helpers приведены в более веселый вид (и в соответствие с Rails 1.2.1) (julik)
+* date_helper надо поменять чтобы передавать рельсовому хелперу весь массив options в хеше (julik)
+
+=== 0.1.6 - 18.08.2006
+
+* Удалили jcode, он нам не сильно нужен (julik)
+* В простом транслите Шипилов - Schipilov вместо SCHipilov (julik)
+* Тесты интеграции валятся явно и громко если зависимые модули на машине отсутствуют (julik)
+* Масса крошечных твиков чтобы сделать все немножко аккуратнее (julik)
+* Родительный падеж (RU_INFLECTED_MONTHNAMES) для месяцев после числа (%d %B === 31 декабря) в strftime (mash)
+
+=== 0.1.5 - 08.05.2006
+
+* Транслитераторы вынесены в отдельные файлы (julik)
+* Починен баг с передачей часа в нужном падеже в distance_of_time (anonyomous)
+* Добавлены корректные методы публикации доков, сменены параметры их генерации (julik)
+* cp -r заменен на cp_r чтобы rutilize работал в Windows (anonymous)
+* Имена месяцев со строчной буквы (sgt - http://rubyforge.org/users/sgt)
+* Поддерживаем оба класса Locale (из ruby-locale и gettext - они немного отличаются по семантике)  (julik)
+
+
+=== 0.1.4 - 02.12.2005
+
+* Поправлен импорт Rails-плагина (julik)
+* Поправлен паттерн сбора тестируемых файлов (julik)
+* Gilenson - на Oniguruma сбоит skip_code, но это надо побарывать нормальным токенизатором, пока откладывается (julik)
+* Gilenson - в тестах произведена замена <cOdE> на <code> и <TT> на <tt> (mash)
+* Gilenson - в двух регулярных выражениях (в "def process_quotes") изменен #{@mark_tag} на
+  \#{@mark_tag} чтобы предотвратить segfault ruby 1.8.2 (2004-12-25) на [i386-mswin32]  (mash)
+* Gilenson - починен дикий баг с маркером в одинарных кавычках - теперь таки последовательность байтов вместо символов (julik)
+* DateTime - RU_INFLECTED_MONTHNAMES => Авгуса --> Августа (mash)
+
+=== 0.1.3 - 14.11.2005
+
+* Gilenson - замена троеточий на ellipsis (julik)
+* Gilenson - теперь пробел, идущий перед одной или двумя буквами на конце слова
+  меняется на glyph[:nbsp]. (mash)
+* Gilenson - починен баг из-за которого не типографилась закрывающая кавычка после вопросительного
+  и восклицательного знака (julik)
+* По умолчанию используется новый Gilenson (Gilenson::Formatter). Старый доступен как Gilenson::Obsolete и через
+  String#o_gilensize и грузится только в случае необходимости. Если у вас были тесты провеяющие gilensize
+  скорее всего они "полетели" (julik)
+* Gilenson - дополнительная фича, не связанная с типографикой: замена амперсанда в следующих атрибутах
+  тагов: href, src, data. Пример: <a href="?x=1&y=2&#38;z=3"> => <a href="?x=1&#38;y=2&#38;z=3"> (mash)
+* Gilenson - изменён метод process_ampersands (стало process_escape_html), меняющий &,<,> на глифы :amp,:lt,:gt
+  при запрете HTML (@settings[:html]=>false). По-умолчанию Гиленсон разрешает использование HTML.
+  В иерархии метод выставлен первым для корректной обработки случаев вида
+  %{Используйте &#38; вместо &amp;}.gilensize(:html=>false) (mash)
+* Gilenson - добавлены :skip_attr=>false и :skip_code=>true для управления обработкой типографики атрибутов тегов title, alt и содержимого <code/>, <tt/>, <![CDATA[...]]> (mash)
+* Gilenson - добавлен :raw_output=>true для вывода обычных UTF-8 chars вместо entities (julik)
+* Смена структуры модулей Gilenson (julik)
+    RuTils::Gilenson::Obsolete - старый класс форматтера
+    RuTils::Gilenson::Formatter - новый класс форматтера
+    При вызове RuTils::Gilenson.new возвращается новый Formatter
+* Gilenson - документация (julik)
+* Gilenson - основные группы настроек "по-умолчанию" выносятся в константы (julik)
+* Gilenson - фильтры выносятся в методы типа process_фильтр и их можно применять по отдельности через Formatter#apply (julik)
+* Gilenson - добавлены &para; и &numero; (последний - не стандарт, но нужен для преобразований символа "номер") (mash)
+* Gilenson - добавлен хэш @glyph_copy_paste для подмены юникодных типографских символов на entities
+  (опционально, через @settings[:copypaste]=>true) (mash)
+* Gilenson - добавлена "склейка" инициалов полукруглой шпацией (thin space)
+* Gilenson - добавлен Formatter#process чтобы обрабатывать строки поточно, и сделан удобный доступ к настройкам
+  через "хвост" метода (julik)
+* Во всех внутренних строковых подстановках Gilenson используются указатели на глифы с двоеточием в начале (julik)
+* Gilenson - введен DOUBLE PRIME (&#8243;) для знаков дюйма (julik) 
+    http://en.wikipedia.org/wiki/Prime_%28mark%29
+    Согласно изощренным правилам скошенный prime правильней чем "
+* Новый Гиленсон lib/gilenson/gilenson.rb (mash)
+    RuTils::GilensonNew::Typografica.new('какой-то текст')
+    %q{"какой-то текст"}.n_gilensize
+* Код приведён к "2 spaces - no tabs", частично полетели дифы (mash)
+* Изменены константы дат, используемые в lib/integration/rails_date_helper_override.rb:
+    Было: RuTils::DateTime::ABBR_MONTHNAMES, RuTils::DateTime::INFLECTED_MONTHNAMES
+    Стало: Date::RU_ABBR_MONTHNAMES, Date::RU_INFLECTED_MONTHNAMES (mash)
+* Добавлена функциия Numeric#rublej (julik)
+* Добавлена русская версия Time#ru_strftime и Date#ru_strftime (mash)
+
+=== 0.1.2 - 01.11.2005
+
+* Добавлен BiDi-транслит c тестами (mash)
+
+=== 0.04 - 20.10.2005
+
+* Чистка документации
+
+=== 0.03 - 18.10.2005
+
+* Легкий рефакторинг и чистка документации, добавлена реализация BiDi-транслита
+
+=== 0.02 - 12.07.2005
+
+* Заменен маркер подстановки тегов в Gilenson. Ранее без oniguruma из-за его применения "проглатывалась" буква "р"

data/Manifest.txt

@@ -0,0 +1,42 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile.rb
+TODO.txt
+WHAT_HAS_CHANGED.txt
+bin/gilensize
+bin/rutilize
+init.rb
+lib/countries/countries.rb
+lib/datetime/datetime.rb
+lib/gilenson/bluecloth_extra.rb
+lib/gilenson/gilenson.rb
+lib/gilenson/helper.rb
+lib/gilenson/maruku_extra.rb
+lib/gilenson/rdiscount_extra.rb
+lib/gilenson/redcloth_extra.rb
+lib/integration/integration.rb
+lib/integration/rails_date_helper_override.rb
+lib/integration/rails_pre_filter.rb
+lib/pluralizer/pluralizer.rb
+lib/rutils.rb
+lib/transliteration/bidi.rb
+lib/transliteration/simple.rb
+lib/transliteration/transliteration.rb
+lib/version.rb
+test/extras/integration_bluecloth.rb
+test/extras/integration_maruku.rb
+test/extras/integration_rails_filter.rb
+test/extras/integration_rails_gilenson_helpers.rb
+test/extras/integration_rails_helpers.rb
+test/extras/integration_rdiscount.rb
+test/extras/integration_redcloth3.rb
+test/extras/integration_redcloth4.rb
+test/run_tests.rb
+test/test_datetime.rb
+test/test_gilenson.rb
+test/test_integration.rb
+test/test_integration_flag.rb
+test/test_pluralize.rb
+test/test_rutils_base.rb
+test/test_transliteration.rb

data/README.txt

@@ -0,0 +1,234 @@
+= RuTils
+
+http://rutils.rubyforge.org
+
+RuTils - простой обработчик русского текста на Ruby.
+Основная цель RuTils - сделать разработку русскоязычных приложений на Ruby (и Rails) максимально простой
+и приятной (в идеале - столь же простой как и разработку оных на английском).
+
+== Шеф! все пропало! я обновил RuTils и он работает совершенно по-другому!
+
+Раздел также известен под именем "Что поменялось в RuTils 1.0.0". Вам {сюда.}[link:files/WHAT_HAS_CHANGED_txt.html]
+
+== Чье это
+
+Разработчики RuTils - {Julik}[http://julik.nl], {Mash}[http://imfo.ru], {Yaroslav Markin}[http://markin.net/]
+
+Большое спасибо Роману Иванову aka Kukutz и Николаю Яремко aka Kuso Mendokuzee за
+реализацию большинства алгоритмов на PHP.
+
+= Как воспользоваться
+
+Просто включите 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
+
+Gilenson - порт Typografica[http://pixel-apes.com/typografica] от Pixel Apes.
+Тыпографица - механизм автоматической расстановки подстановок в тексте перед его
+выводом в HTML, оформляющий неразрывные пробелы, типографские кавычки и тому
+подобные "украшательства".
+
+Gilenson расставит в тексте "умные" правильные кавычки (русские - для кириллицы,
+английские - для латиницы), заменит "хитрые" пунктуационные символы на entities и
+отформатирует знаки типа (c), (tm), телефоны и адреса.
+
+ %q{"И это называется языком?", -- таков был его вопрос}.gilensize => "«И
+ это называется языком?», — таков был его вопрос"
+
+Более подробная документация по Gilenson доступна в документах к
+RuTils::Gilenson::Formatter
+
+В комплекте также есть скрипт gilensize, которым можно поточно обрабатывать
+Unicode-тексты в среде UNIX пользуясь стандартным выводом
+
+ $ cat myfile.txt | gilensize > myfile.html
+
+== Даты
+
+В класс 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::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-приложения.
+
+Если вы используете RuTils в одном приложении со стандартными форматтерами (RedCloth, BlueCloth...) воспользуйтесь
+дополнительными модулями которые выводят отформатированный Гиленсоном результат работы форматтеров
+
+Gilenson определяет следующие дополнительные форматтеры (они работают так же как и их базовые классы)
+
+* RuTils::Gilenson::RedClothExtra
+* RuTils::Gilenson::BlueClothExtra
+* RuTils::Gilenson::RDiscountExtra
+* RuTils::Gilenson::MarukuExtra
+
+В этих классах Gilenson будет обрабатывать типографику во всех текстах, пропускаемых через
+них. Эти классы при включенном флаге RuTils.overrides автоматически подключаются в хелперы
++markdown+ и  +textilize+.
+
+==  Интеграция с Rails версии 2.2.2 и выше
+
+Используйте гем russian для дат и RuTils как дополнение (для транслита, функций kopeek и так далее)
+
+==  Интеграция с Rails версий 1.2 - 2.1.1
+
+RuTils заставляет следующие функции старых (pre-i18n) версий Rails говорить по-русски:
+
+* Меню выбора даты (+date_select+ и +datetime_select+) и связанные с этим хелперы 
+  будут выводиться с русскими именами месяцев, и учитывая локализованный порядок дат
+  (сначала число, потом месяц, потом год)
+* +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.
+
+== Совместимость
+
+* Ruby 1.8.x
+* Ruby 1.9.x (релизные версии начиная с 1.9.1)
+* JRuby 1.1.6
+
+== Требования
+
+* Ruby 1.8.2 или выше, немного прямых рук 
+* 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.
+
+== Если вы все сделали правильно но что-то не работает
+
+Сообщите об ошибке на странице проекта на RubyForge[http://rubyforge.org/projects/rutils]
+Не забудьте указать версию, ее всегда можно узнать в константе
+
+ RuTils::VERSION
+
+== Как ускорить реализацию новых функций
+
+Воспользуйтесь трекером на RubyForge. Опишите нужный вам функционал и приложите
+тесты, которым этот функционал должен удовлетворять. Схему организации тестов вы
+можете скопировать из собственных тестов 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

data/Rakefile.rb

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*- 
+$KCODE = 'u'
+$:.reject! { |e| e.include? 'TextMate' }
+
+require 'lib/version'
+
+begin
+  require 'rubygems'
+  require 'hoe'
+  
+  DOCOPTS = %w(--charset utf-8 --promiscuous)
+  
+  # Disable spurious warnings when running tests, ActiveMagic cannot stand -w
+  Hoe::RUBY_FLAGS.replace ENV['RUBY_FLAGS'] || "-I#{%w(lib test).join(File::PATH_SEPARATOR)}" + 
+    (Hoe::RUBY_DEBUG ? " #{RUBY_DEBUG}" : '')
+  
+  rutils = Hoe.new('rutils', RuTils::VERSION) do |p|
+    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.remote_rdoc_dir = ''
+    p.need_zip = true # ненвижу
+  end
+  rutils.spec.rdoc_options += DOCOPTS
+  
+  require 'load_multi_rails_rake_tasks'
+  
+rescue LoadError
+  $stderr.puts "Meta-operations on this package require Hoe and multi_rails"
+  task :default => [ :test ]
+  
+  require 'rake/testtask'
+  desc "Run all tests (requires BlueCloth, RedCloth and Rails for integration tests)"
+  Rake::TestTask.new("test") do |t|
+    t.libs << "test"
+    t.pattern = 'test/t_*.rb'
+    t.verbose = true
+  end
+end