Petrovich

Библиотека для склонения падежей русских имен, фамилий и отчеств.

Установка

Для NodeJS

Используйте npm:

npm install petrovich

Для браузера

Используйте bower:

bower install petrovich

Или вручную. Ссылка: petrovich.min.js

Подключение

В браузере:

<script src="/path/to/petrovich/dist/petrovich.min.js"></script>

В NodeJS:

var petrovich = require('petrovich');

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

Петровича можно использовать двумя способами.

Первый вариант

// создаем объект person, содержащий параметр gender
// и хотя бы один из параметров first, middle и last
var person = {
 gender: 'male',
 first: 'Петр',
 last: 'Чайковский'
};
// вызываем Петровича как функцию, указав падеж:
petrovich(person, 'dative');
// вернет копию объекта:
// {gender: 'male', first: 'Петру', last: 'Чайковскому'}

Если указано отчество, можно опустить пол, он определится автоматически:

var person = {
 first: 'Петр',
 middle: 'Ильич',
 last: 'Чайковский'
};
petrovich(person, 'dative');
// вернет:
// {first: 'Петру', middle: 'Ильичу', last: 'Чайковскому', gender: 'male'}

Второй вариант использования

// Петрович обладает цепочкой методов вида petrovich[gender][nametype][case]:
petrovich.male.first.genitive('Андрей') // вернет "Андрея"
petrovich.female.last.accusative('Иванова') // вернет "Иванову"

Авто определение пола по отчеству

Петрович может определить пол по отчеству, используя простое правило:

• мужские имена заканчиваются на "-ич",
• женские - на "-на",
• все остальное определяется как "androgynous".

petrovich.detect_gender('Иванович') // вернет 'male'
petrovich.detect_gender('Ильинична') // вернет 'female'
petrovich.detect_gender('Блаблабла') // вернет 'androgynous'

Cписок параметров и их возможных значений

Пол может иметь одно из следующих значений:

• male - мужской,
• female - женский,
• androgynous - неопределенный.

Типы имени:

• first - имя,
• last - фамилия,
• middle - отчество.

Падежи:

• nominative - именительный (кто? что?)
• genitive - родительный (кого? чего?)
• dative - дательный (кому? чему?)
• accusative - винительный (кого? что?)
• instrumental - творительный (кем? чем?)
• prepositional - предложный (о ком? о чем?)

Разработчику

Два ключевых файла проекта:

• petrovich.js - содержит собственно модуль,
• rules.json - содержит правила склонений, которые берутся из этого репозитория.

Правила включаются в модуль в процессе сборки (см. ниже).

В проекте используется следующие инструменты:

• Grunt для автоматизации сборки,
• Jasmine для тестирования.

Установка инструментов:

sudo npm install -g grunt-cli
sudo npm install -g jasmine-node

Клонирование репозитория:

git clone https://github.com/petrovich/petrovich-js.git

Установка локальных модулей:

npm install

Тесты находятся в директории tests/spec/. Запуск тестов:

jasmine-node tests/spec/
# или просто:
npm test

Сборка проекта в директорию dist (включает rules.json в petrovich.js и создает минифицированную копию последнего)

grunt build