Choice Words
This library generates random text based on an input grammar. The grammar file is specified in a "phrase book" containing named lists of phrases. The algorithm randomly replaces tags with a choice of the corresponding phrase.
This example generates "thank you" notes:
root:
- Dear {{ giver }}, thank you for the {{ object }}.
- Hey {{ giver }}, thanks for the {{ object }}!
giver:
- Aunt Emma
- Dave and Edna
- Uncle Bob
object:
- purple vase
- golden retriever
- dishwasher
This phrase book can form phrases such as:
Dear Dave and Edna, thank you for the dishwasher.
Hey Uncle Bob, thanks for the purple vase!
A more complete "thank you" generator is available in the examples folder. Execute it with:
python choicewords.py examples/thankyou.txt
The initial key is called "root" by default but you can use a custom key using the --root argument:
python choicewords.py --root object examples/thankyou.txt
You can use a seed value to specify a specific random variation. The seed doesn't have to be numeric.
python choicewords.py --seed 123 examples/thankyou.txt
The system only deals with text, but this text can be in any language, including programming and markup languages. The examples include a generative SVG drawing generator:
python choicewords.py examples/svg.txt > drawing.html && open drawing.html
Which will create drawings looking like this:
License
Choice Words is licensed under the BSD license. See the LICENSE file for details.
Credits
Choice Words is written by Frederik De Bleser.
The idea of the project is based on the Kant Generator Pro, written by Mark Pilgrim as part of his "Dive Into Python" book. (http://www.diveintopython.net/).