Petrovich просклоняет русские имена

Вам часто приходится иметь дело со склонением имён пользователей на русском языке? При рассылке писем, при отображении страниц и упоминаний, при генерации рекламных объявлений? Скорее всего, приходится изворачиваться и писать все сообщения в именительном падеже — Иванов Пётр Сергеевич.

Это не всегда удобно, не всегда красиво, не всегда уместно. Русский язык одарён богатой морфологией, которая несколько затрудняет его автоматическую обработку. Всем известно, что антропонимы, как полагается именам существительным, подчиняются всем правилам словообразования.

Для решения этой проблемы при использовании Ruby существует Petrovich — удобная легковесная библиотека для автомагического склонения русскоязычных имён, фамилий и отчеств.

Суть

В основе алгоритма Petrovich лежит база правил словообразования, составленная вручную. Прикладному программисту работать с библиотекой будет очень легко: на входе указывается слово в канонической форме, на выходе получается слово запрошенного рода и падежа.

Использование

Базовый синтаксис достаточно прост для понимания.

petrovich = Petrovich.new(:male)
petrovich.lastname('Иванов', :dative)      # => Иванову
petrovich.firstname('Пётр', :dative)       # => Петру
petrovich.middlename('Сергеевич', :dative) # => Сергеевичу

Как можно заметить, имеется два параметра, которые описывают поведение анализатора: в конструктор класса Petrovich передаётся пол, вторым параметром метода склонения передаётся падеж.

Во-первых, половая принадлежность имени. Petrovich рассматривает три варианта:

• мужской пол, :male;
• женский пол, :female;
• «андрогинный» пол, :androgynous, при котором форма фамилии не зависит от пола человека. Например, Прокопенко.

Во-вторых, требуемый падеж. Допустимые падежи, изменяющие слово, описаны ниже в таблице.

Имеется возможность подмешать модуль Petrovich::Extension в любой класс. Это особенно полезно при использовании ActiveRecord и подобных ORM.

class User < ActiveRecord::Base
  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

При помощи метода petrovich указываются методы, представляющие фамилию, имя и отчество. В данном примере указано, что метод my_firstname представляет имя, метод my_lastname представляет фамилию, метод my_middlename представляет отчество. Ничто не мешает подмешать модуль и в обычный класс, всё будет работать так же хорошо. В целевой класс будут добавлены методы с падежами, описанными в таблице.

user = User.new
user.my_firstname           # => Пётр

user.my_firstname_genitive  # => Петра
user.my_middlename_genitive # => Ашотовича
user.my_lastname_genitive   # => Бонч-Соколова-Скаля

Некоторые особенности русского правописания учитываются достаточно хорошо.

Оценка точности

Ради приличия, проводилась оценка точности склонения слов. В качестве эталона взят список фамилий и их форм из морфологического словаря АОТ. Точность оценивалась на основе обработки 88 314 примеров по формуле

,

где case — падеж, gender — пол, V_case,gender — количество верных словоизменений для указанного падежа и рода, N_case,gender — общее количество примеров для указанного падежа и рода.

На момент написания статьи наблюдается средняя точность 99,6614% на основе обработки 88 314 примеров. Детали приведены ниже в таблице. Эта информация может быть полезна при использовании Petrovich в боевых условиях.

Реквизиты

Репозиторий на GitHub располагается по адресу rocsci/petrovich. Библиотека распространяется на условиях MIT License. Авторами библиотеки являются Андрей Козлов (Bonch) и Дмитрий Усталов (eveel).

Чтобы установить Petrovich и использовать его в собственных приложениях, достаточно выполнить gem install petrovich или дописать соответствующую строчку в Gemfile.

Веб-интерфейс

Приятно, что Андрей Ситник (Iskin) из «Злых Марсиан» сделал классный интерфейс, который позволяет играться с Petrovich прямо из браузера.