ducthang-vu / text-generator

A simple Python application which generates random texts from a corpus of texts from various authors.

text-generator

text-generator is a Python application which generates random texts from a corpus of texts from various authors. The following authors are available:

• Kapy Perry: 20 songs,
• Lady Gaga: 30 songs, and
• Saint Paul: Letter to the Romans.

This application retrieve a corpus and then generate a Markov chain which establishes a relationships between words.

Minimum requirements

python 3.9.0

atomicwrites==1.4.0
attrs==20.3.0
colorama==0.4.4
coverage==5.5
iniconfig==1.1.1
packaging==20.9
pluggy==0.13.1
py==1.10.0
pyparsing==2.4.7
pytest==6.2.2
toml==0.10.2

Usage

Open terminal and install the necessary packages by running:

pip install -r requirements.txt

Then start the application by running from the root directory main.py. The script accepts the following arguments:

• --author, -a: the author, and
• --length, -l: the total number of words to be generated
• --wordsPerState, -w: the number of words for every Markov chain state (default: 1)

For example:

python main.py -a lady_gaga -l 10
fight gotta find your love love again Oh oh Ooh

python main.py -a saint_paul -l 15 -w 2
a result they have killed your prophets they have not believed and how can they hear

For running unit tests, do:

    coverage run -m pytest
    coverage report
    coverage html

The latter command creates the coverage file coverage/index.html, which can be opened with a browser.

Implementation notes

The algorithm is simple and naive: it considers as word any substring between spaces, provided that only letters, apostrophes and hyphen are kept. Further improvement may be added in the future.