[Hero] [проходил|hero] мимо неприметного двора и вдруг [заметил|hero] играющих детей. Они бегали с деревянными мечами, посохами и масками чудовищ. Внезапно один из играющих остановился, выставил [игрушечный|hero.weapon|вн] [hero.weapon|вн], выкрикнул: «[Я|hero] [великий|hero] [Hero]! Получай!» — и бросился на «бестий». Они упали наземь, задрыгали руками-ногами, а после встали, сняли маски и засмеялись. [Хмыкнул|hero] и [сам|hero] [Hero], но не [стал|hero] выходить к малышне.

Халлр проходил мимо неприметного двора и вдруг заметил играющих детей. Они бегали с деревянными мечами, посохами и масками чудовищ. Внезапно один из играющих остановился, выставил игрушечную золочёную шпагу, выкрикнул: «Я великий Халлр! Получай!» — и бросился на «бестий». Они упали наземь, задрыгали руками-ногами, а после встали, сняли маски и засмеялись. Хмыкнул и сам Халлр, но не стал выходить к малышне.

Фиевара проходила мимо неприметного двора и вдруг заметила играющих детей. Они бегали с деревянными мечами, посохами и масками чудовищ. Внезапно один из играющих остановился, выставил игрушечный катар, выкрикнул: «Я великая Фиевара! Получай!» — и бросился на «бестий». Они упали наземь, задрыгали руками-ногами, а после встали, сняли маски и засмеялись. Хмыкнула и сама Фиевара, но не стала выходить к малышне.

О сложности генерации текстов

Возможности библиотеки

• переменных (например, имени персонажа);
• зависимостей слов от переменных (например, прилагательного от существительного);
• Зависимостей одних переменных от других;
• Явных свойств слов и переменных (например, можно указать, что имя персонажа вставляется в родительском падеже);

• На зависимые слова переносятся необходимые свойства главного слова. Например, на прилагательное переносится род существительного.
• Согласуется форма зависимых слов с числительными (с учётом формы зависимых слов).
• Модифицируются предлоги если необходимо (например, обо мне / о тебе), предлог для этого должен быть размечен.

• Словарь для хранения необходимых слов.
• Хранилище шаблонов для их хранения по типу и выбора случайного.

Формат шаблонов и пример использования

Вчера [mob] [укусил|mob] [hero|вн].

Вчера гиена укусила Халлра.

Вчера светлячки укусили привидение.

• Вчера — обычный текст.
• [mob] — переменная, вместо которой подставится название монстра.
• [укусил|mob] — слово, зависимое от переменной, часть его свойств будет изменяться в зависимости от свойств названия монстра (например, число). Генератор текста автоматически распознаёт свойства формы слова и пытается их сохранить (например, будет распознано и сохранено прошедшее время, поэтому указывать его не надо).
• [hero|вн] — переменная, вместо которой подставится имя героя. Дополнительно указано, что имя должно быть в винительном падеже.

• [ — открывающая квадратная скобка.
• слово — зависимое слово или идентификатор переменной. Генератор сначала проверяет наличие переменной с таким именем, если такой переменной нет, то слово ищется в словаре.
• | — вертикальная черта — разделитель, нужен если указываем дополнительные свойства.
• имя переменной — переменная, от которой зависит форма слова, может отсутствовать.
• | — вертикальная черта — разделитель, нужен если указываем дополнительные свойства.
• свойства слова через запятую — описание требуемой формы слова (падеж, род и так далее). Их список можно найти на страницах проекта в github и pypi.
• ] — закрывающая квадратная скобка.

• [переменная] — вставить переменную в нормальной форме (например, существительное в именительном падеже единственного числа).
• [переменная|свойства] — вставить переменную с указанными свойствами.
• [слово|переменная] — вставить слово, согласовав его с переменной (например, прилагательное «красивый» с существительным по роду и падежу).
• [слово|переменная|свойства] — вставить слово, согласовав его с переменной и указав дополнительные свойства.

• Указание свойств для слов и переменных действует только в месте вставки, поэтому, чтобы получить словосочетание «красивого героя» мы должны указать винительный падеж явно для двух слов: [красивый|hero|вн] [hero|вн].
• Генератор текста умеет «угадывать» свойства слова по его форме, например, во фразе [hero] [побежал|hero] можно не указывать время глагола.
• Свойства, указанные позже, затирают свойства, указанные ранее. Например, во фразе [красивого|hero] [hero|вн] не будет установлен винительный падеж прилагательного, так как он заменится именительным падежом переменной hero.
• Перечень свойств слов можно найти на страницах библиотеки в github и pypi.

pip install utg

python -m unittest discover utg

from utg import relations as r
from utg import dictionary
from utg import words
from utg import templates
from utg import constructors

#######################################
# описываем существительное для словаря
#######################################

coins_forms = [# единственнео число
               'монета', 'монеты', 'монете', 'монету', 'монетой', 'монете',
               # множественное число
               'монеты', 'монет', 'монетам', 'монеты', 'монетами', 'монетах',
               # счётное число (заполнено для пример,
               # может быть заполнено методом autofill_missed_forms)
               'монеты', 'монет', 'монетам', 'монеты', 'монетами', 'монетах']

# свойства: неодушевлённое, женский род
coins_properties = words.Properties(r.ANIMALITY.INANIMATE, r.GENDER.FEMININE)

# Для создания слова указывается его тип, формы и свойства
coins_word = words.Word(type=r.WORD_TYPE.NOUN,
                        forms=coins_forms,
                        properties=coins_properties)

# Формы слова должны быть указаны в фиксированном порядке.
# Если вы хотите автоматизировать создание слов,
# найти порядок форм слова и их свойства можно в переменных:
# - utg.data.WORDS_CACHES
# - utg.data.INVERTED_WORDS_CACHES

##############################
# описываем глагол для словаря
##############################

# описываем только нужны нам формы слова
# (порядок важен и определён в utg.data.WORDS_CACHES[r.WORD_TYPE.VERB])
action_forms = (['подарить', 'подарил', 'подарило', 'подарила', 'подарили'] +
                [''] * 15)

# свойства: совершенный, прямой залог
action_properties = words.Properties(r.ASPECT.PERFECTIVE, r.VOICE.DIRECT)

action_word = words.Word(type=r.WORD_TYPE.VERB,
                         forms=action_forms,
                         properties=action_properties)

# заполняем пропущенные формы на основе введённых (выбираются наиболее близкие)
action_word.autofill_missed_forms()

##############################################
# создаём словарь для использования в шаблонах
##############################################

test_dictionary = dictionary.Dictionary(words=[coins_word, action_word])

################
# создаём шаблон
################
template = templates.Template()

# externals — внешние переменные, не обязаны быть в словаре
template.parse('[Npc] [подарил|npc] [hero|дт] [coins] [монета|coins|вн].',
               externals=('hero', 'npc', 'coins'))

##############################
# описываем внешние переменные
##############################

hero_forms = ['герой', 'героя', 'герою', 'героя', 'героем', 'герое',
              'герои', 'героев', 'героям', 'героев', 'героями', 'героях',
              'герои', 'героев', 'героям', 'героев', 'героями', 'героях']

# свойства: одушевлённый, мужской род
hero_properties = words.Properties(r.ANIMALITY.ANIMATE, r.GENDER.MASCULINE)

hero = words.WordForm(words.Word(type=r.WORD_TYPE.NOUN,
                                 forms=hero_forms,
                                 properties=hero_properties))

npc_forms = ['русалка', 'русалки', 'русалке', 'русалку', 'русалкой', 'русалке',
             'русалки', 'русалок', 'русалкам', 'русалок', 'русалками', 'русалках',
             'русалки', 'русалок', 'русалкам', 'русалок', 'русалками', 'русалках']

# свойства: одушевлённое, женский род
npc_properties = words.Properties(r.ANIMALITY.ANIMATE, r.GENDER.FEMININE)

npc = words.WordForm(words.Word(type=r.WORD_TYPE.NOUN,
                                forms=npc_forms,
                                properties=npc_properties))

##########################
# осуществляем подстановку
##########################

result = template.substitute(externals={'hero': hero,
                                        'npc': npc,
                                        'coins': constructors.construct_integer(125)},
                             dictionary=test_dictionary)

##########################
# Проверяем
##########################

result == 'Русалка подарила герою 125 монет.'

О словарях

• Общедоступных качественных морфологических словарей я не нашёл.
• Библиотека pymorphy была ещё первой версии и довольно часто косячила (особенно с винительным падежом), из-за чего пришлось от неё отказаться.

Итого