petrovich 0.1.2 → 0.1.3

data/README.md

@@ -5,6 +5,8 @@
 
 [![Build Status](https://secure.travis-ci.org/rocsci/petrovich.png)](http://travis-ci.org/rocsci/petrovich)
 
+#### Посмотреть в действии: http://petrovich.rocketscience.it
+
 ## Установка
 
 Добавьте в Gemfile:
@@ -47,7 +49,7 @@ p.middlename('Сергеевич', :dative) # => Сергеевичу
 такие как Нельсон.
 
 Важно понимать, что явное указание пола повышает точность обработки слов.
-Если пол не известен, однако известно отчество, то гем постарается
+Если пол неизвестен, однако известно отчество, то гем постарается
 определить по пол отчеству на основе простой эвристики.
 
 ### Продвинутое использование
@@ -166,22 +168,22 @@ person.my_lastname_dative   # => Сафронову
 
 ```
 Pr(nominative|male) = 100.0000%
-Pr(genitive|male) = 99.6763%
-Pr(dative|male) = 99.7012%
-Pr(accusative|male) = 99.7261%
-Pr(instrumental|male) = 97.9485%
-Pr(prepositional|male) = 99.6888%
+Pr(genitive|male) = 99.7137%
+Pr(dative|male) = 99.7386%
+Pr(accusative|male) = 99.7635%
+Pr(instrumental|male) = 97.9858%
+Pr(prepositional|male) = 99.7261%
 ```
 ```
 Pr(nominative|female) = 100.0000%
-Pr(genitive|female) = 99.8652%
-Pr(dative|female) = 99.8952%
-Pr(accusative|female) = 99.9251%
-Pr(instrumental|female) = 99.4189%
-Pr(prepositional|female) = 99.8952%
+Pr(genitive|female) = 99.9102%
+Pr(dative|female) = 99.9401%
+Pr(accusative|female) = 99.9701%
+Pr(instrumental|female) = 99.4636%
+Pr(prepositional|female) = 99.9401%
 ```
 
-В настоящий момент наблюдается точность в 99.6275% на основе обработки
+В настоящий момент наблюдается точность в 99.6614% на основе обработки
 88314 примеров.
 
 [АОТ]: http://seman.svn.sourceforge.net/viewvc/seman/trunk/Docs/Morph_UNIX.txt?revision=HEAD&view=markup
@@ -203,7 +205,6 @@ Pr(prepositional|female) = 99.8952%
  * добавить отладочный режим, чтобы видеть, какое именно правило было
 использовано при словообразовании;
  * интерфейс командной строки, чтобы работать с гемом из командной строки;
- * Web-интерфейс для обработки ФИО;
  * проверка совместимости с различными ORM и сторонними библиотеками.
 
 Если вы хотите помочь этому проекту, вы можете реализовать любую

data/lib/petrovich/extension.rb

@@ -3,7 +3,7 @@
 class Petrovich
   # Этот модуль разработан для возможности его подмешивания в класс Ruby.
   # Его можно подмешать в любой класс, например, в модель ActiveRecord.
-  # 
+  #
   # При помощи вызова метода +petrovich+ вы указываете, какие аттрибуты или методы класса
   # будут возвращать фамилию, имя и отчество.
   #
@@ -24,23 +24,23 @@ class Petrovich
   #   на основе файла правил.
   #
   # Пример использования
-  # 
+  #
   #   class User
   #     include Petrovich::Extension
-  #   
+  #
   #     petrovich :firstname  => :my_firstname,
   #               :middlename => :my_middlename,
   #               :lastname   => :my_lastname,
   #               :gender     => :my_gender
-  #   
+  #
   #     def my_firstname
   #       'Пётр'
   #     end
-  # 
+  #
   #     def my_middlename
   #       'Александрович'
   #     end
-  # 
+  #
   #     def my_lastname
   #       'Ларин'
   #     end
@@ -74,7 +74,7 @@ class Petrovich
         end
 
         self.petrovich_configuration = {
-          :fullname   => nil,
+          :lastname   => nil,
           :firstname  => nil,
           :middlename => nil,
           :gender     => nil
@@ -84,11 +84,20 @@ class Petrovich
 
     def petrovich_create_getter(method_name, attribute, gcase)
       options    = self.class.petrovich_configuration
-      reflection = options.key(attribute.to_sym) or raise "No reflection for attribute '#{attribute}'!"
+      reflection = options.key(attribute.to_sym) or
+        raise "No reflection for attribute '#{attribute}'!"
 
       self.class.send(:define_method, method_name) do
-        rn = Petrovich.new(options[:gender])
-        rn.send(reflection, send(attribute), gcase)
+        # detect by gender attr if defined
+        gender = options[:gender] && send(options[:gender])
+        # detect by middlename attr if defined
+        gender ||= begin
+          middlename = options[:middlename] && send(options[:middlename])
+          middlename && Petrovich.detect_gender(middlename)
+        end
+
+        rn = Petrovich.new gender
+        rn.send reflection, send(attribute), gcase
       end
     end
 

data/lib/petrovich/rules.rb

@@ -26,13 +26,18 @@ class Petrovich
     #
     [:lastname, :firstname, :middlename].each do |method_name|
       define_method(method_name) do |name, gcase|
-        find_and_apply(name, gcase, Petrovich::RULES[method_name.to_s])
+        inflect(name, gcase, Petrovich::RULES[method_name.to_s])
       end
     end
 
   protected
-
-    def match?(name, rule, match_whole_word)
+    # Известно несколько типов признаков, которые влияют на процесс поиска.
+    #
+    # Признак +first_word+ указывает, что данное слово является первым словом
+    # в составном слове. Например, в двойной русской фамилии Иванов-Сидоров.
+    #
+    def match?(name, rule, match_whole_word, tags)
+      return false unless tags_allow? tags, rule['tags']
       return false if rule['gender'] == 'male' && female? || rule['gender'] == 'female' && !female?
 
       name = UnicodeUtils.downcase(name)
@@ -52,6 +57,19 @@ class Petrovich
       @gender == 'female'
     end
 
+    def inflect(name, gcase, rules)
+      i = 0
+
+      parts = name.split('-')
+
+      parts.map! do |part|
+        first_word = (i += 1) == 1 && parts.size > 1
+        find_and_apply(part, gcase, rules, first_word: first_word)
+      end
+
+      parts.join('-')
+    end
+
     # Применить правило
     def apply(name, gcase, rule)
       modificator_for(gcase, rule).each_char do |char|
@@ -68,8 +86,8 @@ class Petrovich
     end
 
     # Найти правило и применить к имени с учетом склонения
-    def find_and_apply(name, gcase, rules)
-      rule = find_for(name, rules)
+    def find_and_apply(name, gcase, rules, features = {})
+      rule = find_for(name, rules, features)
       apply(name, gcase, rule)
     rescue UnknownRuleException
       # Если не найдено правило для имени, возвращаем неизмененное имя.
@@ -77,21 +95,23 @@ class Petrovich
     end
 
     # Найти подходящее правило в исключениях или суффиксах
-    def find_for(name, rules)
+    def find_for(name, rules, features = {})
+      tags = extract_tags(features)
+
       # Сначала пытаемся найти исключения
       if rules.has_key?('exceptions')
-        p = find(name, rules['exceptions'], true)
+        p = find(name, rules['exceptions'], true, tags)
         return p if p
       end
 
       # Не получилось, ищем в суффиксах. Если не получилось найти и в них,
       # возвращаем неизмененное имя.
-      find(name, rules['suffixes'], false) or raise UnknownRuleException, "Cannot find rule for #{name}"
+      find(name, rules['suffixes'], false, tags) or raise UnknownRuleException, "Cannot find rule for #{name}"
     end
 
     # Найти подходящее правило в конкретном списке правил
-    def find(name, rules, match_whole_word)
-      rules.find { |rule| match?(name, rule, match_whole_word) }
+    def find(name, rules, match_whole_word, tags)
+      rules.find { |rule| match?(name, rule, match_whole_word, tags) }
     end
 
     # Получить модификатор из указанного правиля для указанного склонения
@@ -114,5 +134,17 @@ class Petrovich
       end
     end
 
+    # Преобразование +{a: true, b: false, c: true}+ в +%w(a c)+.
+    def extract_tags(features = {})
+      features.keys.select { |k| features[k] == true }.map(&:to_s)
+    end
+
+    # Правило не подходит только в том случае, если оно содержит больше
+    # тегов, чем требуется для данного слова.
+    #
+    def tags_allow?(tags, rule_tags)
+      rule_tags ||= []
+      (rule_tags - tags).empty?
+    end
   end
 end

data/lib/petrovich/rules.yml

@@ -29,8 +29,29 @@
 #
 lastname:
   exceptions:
+    # Неизменяемые первые части двойных русских фамилий.
+    #
+    - gender: androgynous
+      test:
+        - бонч
+        - абдул
+        - белиц
+        - гасан
+        - дюссар
+        - дюмон
+        - книппер
+        - корвин
+        - ван
+        - шолом
+        - тер
+        - призван
+        - мелик
+        - вар
+      mods: [., ., ., ., .]
+      tags: [first_word]
+
     - gender: androgynous
-      test: [дюма, тома, дега, люка, ферма, гамарра, петипа, шандра]
+      test: [дюма, тома, дега, люка, ферма, гамарра, петипа, шандра, скаля]
       mods: [., ., ., ., .]
 
     - gender: androgynous

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: petrovich
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-08 00:00:00.000000000 Z
+date: 2013-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unicode_utils