petrovich 0.2.1 → 1.0.0

metadata

@@ -1,16 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: petrovich
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 1.0.0
 platform: ruby
 authors:
-- Andrew Kozloff
+- Andrew Kozlov
 - Dmitry Ustalov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-07 00:00:00.000000000 Z
+date: 2016-03-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.3.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -25,8 +53,22 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A library to inflect Russian anthroponyms such as first names, last names,
-  and middle names.
+  and middle names. Also it has gender detection functionality.
 email:
 - demerest@gmail.com
 - dmitry@eveel.ru
@@ -38,9 +80,17 @@ files:
 - README.md
 - Rakefile
 - lib/petrovich.rb
-- lib/petrovich/extension.rb
-- lib/petrovich/rules.rb
+- lib/petrovich/case/rule.rb
+- lib/petrovich/case/rule/modifier.rb
+- lib/petrovich/case/rule/test.rb
+- lib/petrovich/gender.rb
+- lib/petrovich/gender/rule.rb
+- lib/petrovich/inflected.rb
+- lib/petrovich/inflector.rb
+- lib/petrovich/name.rb
+- lib/petrovich/rule_set.rb
 - lib/petrovich/unicode.rb
+- lib/petrovich/value.rb
 - lib/tasks/evaluate.rake
 - rules/rules.yml
 homepage: https://github.com/petrovich/petrovich-ruby
@@ -55,7 +105,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.1
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/petrovich/extension.rb

@@ -1,140 +0,0 @@
-# encoding: utf-8
-
-class Petrovich
-  # Этот модуль разработан для возможности его подмешивания в класс Ruby.
-  # Его можно подмешать в любой класс, например, в модель ActiveRecord.
-  #
-  # При помощи вызова метода +petrovich+ вы указываете, какие аттрибуты или методы класса
-  # будут возвращать фамилию, имя и отчество.
-  #
-  # Опции:
-  #
-  # [:+firstname+]
-  #   Указывает метод, возвращающий имя
-  #
-  # [:+middlename+]
-  #   Указывает метод, возвращающий отчество
-  #
-  # [:+lastname+]
-  #   Указывает метод, возвращающий фамилию
-  #
-  # [:+gender+]
-  #   Указывает метод, возвращающий пол. Если пол не был указан, используется автоматическое определение
-  #   пола на основе отчества. Если отчество также не было указано, пытаемся определить правильное склонение
-  #   на основе файла правил.
-  #
-  # Пример использования
-  #
-  #   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
-  #
-  #     def my_gender
-  #       :male # :male, :female или :androgynous
-  #     end
-  #
-  #   end
-  #
-  # Вы получите следующие методы
-  #
-  #   user = User.new
-  #   user.my_lastname_dative   # => Ларину
-  #   user.my_firstname_dative  # => Петру
-  #   user.my_middlename_dative # => Александровичу
-  #
-  # Вышеперечисленные методы доступны и внутри класса User.
-  #
-  module Extension
-    def self.included(base)
-      base.extend ClassMethods
-    end
-
-    module ClassMethods
-      def petrovich_configuration
-        @petrovich_configuration ||= {
-          :lastname   => nil,
-          :firstname  => nil,
-          :middlename => nil,
-          :gender     => nil
-        }
-      end
-
-      def petrovich(options)
-        self.petrovich_configuration.update(options)
-      end
-
-      def inherited(subclass)
-        subclass.petrovich_configuration.update(self.petrovich_configuration)
-        super
-      end
-    end
-
-    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}'!"
-
-      self.class.send(:define_method, method_name) do
-        # 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
-
-    def method_missing(method_name, *args, &block)
-      if match = method_name.to_s.match(petrovich_method_regex)
-        attribute = match[1]
-        gcase     = match[2]
-
-        petrovich_create_getter(method_name, attribute, gcase)
-
-        if respond_to_without_petrovich?(method_name)
-          send method_name
-        else
-          super
-        end
-      else
-        super
-      end
-    end
-
-    alias :respond_to_without_petrovich? :respond_to?
-
-    def respond_to?(method_name, include_private = false)
-      if match = method_name.to_s.match(petrovich_method_regex)
-        true
-      else
-        super
-      end
-    end
-
-    def petrovich_method_regex
-      %r{(.+)_(#{Petrovich::CASES.join('|')})$}
-    end
-
-    protected :petrovich_method_regex
-  end
-end

data/lib/petrovich/rules.rb

@@ -1,209 +0,0 @@
-# encoding: utf-8
-
-class Petrovich
-  # Загрузка правил происходит один раз
-  RULES = YAML.load_file(File.expand_path('../../../rules/rules.yml', __FILE__))
-
-  class UnknownCaseException < Exception;;end
-  class UnknownRuleException < Exception;;end
-  class CantApplyRuleException < Exception;;end
-
-  # Набор методов для нахождения и применения правил к имени, фамилии и отчеству.
-  class Rules
-    include Petrovich::Unicode
-
-    attr_reader :gender
-
-    Matchers = [
-      proc {| x, y, i | y[ 0 ].size <=> x[ 0 ].size },
-      proc {| x, y, i | x[ 1 ][ 'gender' ] != i.gender &&  1 ||
-                        y[ 1 ][ 'gender' ] != i.gender && -1 || 0 },
-      proc {| x, y, i | y[ 1 ][ 'test' ][ 0 ].size <=>
-                        x[ 1 ][ 'test' ][ 0 ].size },
-      proc {| x, y, i | x[ 1 ][ 'test' ][ 0 ] <=> y[ 1 ][ 'test' ][ 0 ] } ]
-
-    def initialize(gender = nil)
-      @gender = gender
-    end
-
-    # Определяет методы +lastname_<i>case</i>+, +firstname_<i>case</i>+ и +middlename_<i>case</i>+
-    # для получения имени, фамилии и отчества в нужном падеже.
-    #
-    # Использование:
-    #
-    #   # Дательный падеж
-    #   lastname_dative('Комаров') # => Комарову
-    #
-    #   # Винительный падеж
-    #   lastname_accusative('Комаров') # => Комарова
-    #
-    [:lastname, :firstname, :middlename].each do |method_name|
-      define_method(method_name) do |name, gcase, scase|
-        inflect(name, gcase, scase, Petrovich::RULES[method_name.to_s])
-      end
-    end
-
-  protected
-    # Известно несколько типов признаков, которые влияют на процесс поиска.
-    #
-    # Признак +first_word+ указывает, что данное слово является первым словом
-    # в составном слове. Например, в двойной русской фамилии Иванов-Сидоров.
-    #
-    def match?(name, gcase, scase, rule, match_whole_word, tags)
-      return false unless tags_allow? tags, rule['tags']
-      return false if rule['gender'] == 'male' && female? ||
-                      rule['gender'] == 'female' && !female?
-
-      rule['test'].each do |chars|
-        begin
-          chars = apply(chars, rule, scase, gcase) if scase != NOMINATIVE
-        rescue CantApplyRuleException
-          next
-        end
-
-        test = match_whole_word ? name : name.slice([name.size - chars.size, 0].max .. -1)
-        return chars if test == chars
-      end
-
-      false
-    end
-
-    def male?
-      @gender == 'male'
-    end
-
-    def female?
-      @gender == 'female'
-    end
-
-    def inflect(name, gcase, scase, rules)
-      i = 0
-
-      parts = name.split('-')
-
-      parts.map! do |part|
-        first_word = (i += 1) == 1 && parts.size > 1
-        find_and_apply(part, gcase, scase, rules, first_word: first_word)
-      end
-
-      parts.join('-')
-    end
-
-    # Применить правило
-    def apply(name, rule, gcase, scase)
-      mod = modificator_from(scase, rule) + modificator_for(gcase, rule)
-      skip = 0
-      mod.each_char do |char|
-        case char
-          when '.'
-          when '-'
-            raise CantApplyRuleException if name.empty?
-            name = name.slice(0, name.size - 1)
-          else
-            name += char
-        end
-      end
-
-      name
-    end
-
-    # Найти правило и применить к имени с учетом склонения
-    def find_and_apply(name, gcase, scase, rules, features = {})
-      rule = find_for(name, gcase, scase, rules, features)
-      apply(name, rule, gcase, scase)
-    rescue UnknownRuleException, CantApplyRuleException
-      # Если не найдено правило для имени, или случилась ошибка применения
-      # правила, возвращаем неизмененное имя.
-      name
-    end
-
-    # Найти подходящее правило в исключениях или суффиксах
-    def find_for(name, gcase, scase, rules, features = {})
-      tags = extract_tags(features)
-
-      # Сначала пытаемся найти исключения
-      if rules.has_key?('exceptions')
-        p = find(name, gcase, scase, rules['exceptions'], true, tags)
-        return p if p
-      end
-
-      # Не получилось, ищем в суффиксах. Если не получилось найти и в них,
-      # возвращаем неизмененное имя.
-      find(name, gcase, scase, rules['suffixes'], false, tags) ||
-      raise( UnknownRuleException, "Cannot find rule for #{name}" )
-    end
-
-    # Найти подходящее правило в конкретном списке правил
-    def find(name, gcase, scase, rules, match_whole_word, tags)
-      name = downcase(name)
-      first =
-      rules.map do| rule |
-        score = match?(name, gcase, scase, rule, match_whole_word, tags)
-        score && [ score, rule ] || nil
-      end.compact.sort do| x, y |
-        Matchers.reduce( 0 ) do| c, m |
-          c = m.call( x, y, self )
-          break c if c != 0
-        end
-      end.first
-
-      first && first[ 1 ]
-    end
-
-    # Получить модификатор из указанного правиля для указанного склонения
-    def modificator_for(gcase, rule)
-      case gcase.to_sym
-        when NOMINATIVE
-          '.'
-        when GENITIVE
-          rule['mods'][0]
-        when DATIVE
-          rule['mods'][1]
-        when ACCUSATIVE
-          rule['mods'][2]
-        when INSTRUMENTAL
-          rule['mods'][3]
-        when PREPOSITIONAL
-          rule['mods'][4]
-        else
-          raise UnknownCaseException, "Unknown grammatic case: #{gcase}"
-      end
-    end
-
-    # Получить модификатор из указанного правила для преобразования
-    # из указанного склонения
-    def modificator_from(scase, rule)
-      return '.' if scase.to_sym == NOMINATIVE
-
-      # TODO т.к. именительный падеж не может быть восстановлен
-      # в некоторых случаях верно, используется первый попавшийся вариант
-      # видимо нужно менять формат таблицы, или развязывать варианты,
-      # находящиеся в поле test
-      base = rule['test'][0].unpack('U*')
-      mod = modificator_for(scase, rule).unpack('U*')
-      mod.map do | char |
-        case char
-        when 46 # '.'
-          46
-        when 45 # '-'
-          base.pop
-        else
-          45
-        end
-      end.reverse.pack('U*')
-    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