Metadata-Version: 2.1
Name: frankenpoem
Version: 7.0.0
Summary: Generate poems cobbled together from the remains of older, better poems, with a particular emphasis on rhyme and meter consistency.
Home-page: https://github.com/ruthlee/frankenpoems
Author: Kyelee Fitts
Author-email: kyelee.fitts@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: pandas
Requires-Dist: pronouncing

# Frankenpoem 

Lots of poetry generators these days are focused on trying to cobble together "original" "creative" works of algorithmic poetry. To this I say: why reinvent the wheel? A wheel that the old masters surely have already perfected.

This is a poetry generator which cobbles together lines from poems that have already been written while paying attention to meter and rhyme to form something that (while perhaps nonsensical in content) still sounds like a, ahem, real poem.

In order to spread Frankenbot's genius throughout the world, I made a package with exactly one use case: to run Frankenbot's `write_poem()` command. So you, too, can experience the grandeur of Frankenbot's poetic vision.

## Installation
Enter `pip3 install frankenpoem` in your command line and it should world. Or try `pip install frankenpoem`. The latest version is 6.0.0 (...because it took me six tries to get the actual package working and I couldn't be bothered with TestPyPi), so if THAT doesn't work try `pip install frankenpoem==6.0.0` or pip3 of the same command.

Warning: you may need to make sure to have the following packages installed (because I don't think I got the package dependencies quite right lol):
- [pandas](https://pandas.pydata.org/pandas-docs/stable/getting_started/install.html): this should already be installed if you have the anaconda distribution installed 
- [pronouncing](https://pypi.org/project/pronouncing/): just install with `pip install pronouncing` if needed.
- collections, re, random: you shouldn't need to install these if you have an up-to-date python interpreter because they're built-in modules, but ya know. 

## Usage
In the terminal, go to your python interpreter (for me I just type `python3`). Then:

```python
import frankenpoem as f
f.write_poem()
```

Et voila! A poem should generate. There are no arguments because you have no control over Frankenbot's creative process. He is his own creative entity and should be respected as such.

The repo also contains [a notebook which documents the process of making write_poem()](https://github.com/ruthlee/frankenpoems/blob/master/frankenpoem_demo.ipynb)

## Sources
Big shoutout to:

[Allison Parrish's repo](https://github.com/aparrish/gutenberg-poetry-corpus/blob/master/quick-experiments.ipynb) for providing the data for the project as well as a very useful rhyme-dictionary data structure for Frankenbot to use.

[Laurence Tennant's poetry-tools](https://github.com/hyperreality/Poetry-Tools) for meter and syllable analysis. 


