LiterateRandomizer

A random sentence and paragraph generator gem. Using Markov chains, this generates near-english prose.

Installation

Add this line to your application's Gemfile:

gem 'literate_randomizer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install literate_randomizer

Usage

Example:

require 'literate_randomizer'

lr = LiterateRandomizer.create

lr.word
# => "frivolous" 

lr.sentance
# => "Muscular arms round opening of sorts while Lord John Roxton." 

lr.paragraph
# => "Tapped by his feet and the sign of the woods partly! Promoters might find such a row some rough hulking creatures we get a! Prove to think if we killed him state visit http While. Trusted ourselves and leaving the temperature ranges from the. Formally declared that if he will want to a howling the. Attentive neutrality. Helped to place where we heard the wide slow-moving clay-tinted stream and his. Itself as yet I was one circle of leathery wings as will understand." 

puts lr.paragraphs

The last line outputs:

Bane of him away from the bushes waiting for it all rushed me like. Settled determination that he then louder and talked of bitter disappointment and that had. Larger ones were one markedly lighter than a journey which began to them. Leave that foolish and without. Parcel of baggage gave a sight while in vain. Peculiarities are monstrous kangaroos. Volume with them.

Communication reaches the less than harmonious. Absorb us must do not remind this scientific truth? Issued directions which contained the Chestnuts three. Ally of humor moving. Over it was a drawer he waved his beard the evening. Purged that proud delicate profile of this point I am so I could have. Throaty croaking far off those monstrous bat what would increase his eyes? Amiable but forget the results to abide by the Daily Gazette as long slope.

Shredded into each in the pterodactyl we were engaged two or distributing a work. Refund from my pocket and rippling beard and turning into. Contact the first found at a thousand miles and tore. Uppish old types of our way which carried off the proceedings began in upon. Usual scientific mind was inclined to be described? Leafy archway began to provide. Here's something which I wondered where I thought came upon the body. Types surviving and numerous papers including checks online. Ran past ages the wood and Summerlee burst between his? Slur upon the foils and it was in a very different things before the angle. Portions of an intrusive rascals who agree to agree.

When creating a randomizer, there are a few options. The source_material should be a large selection of english text. For example, included is "The Lost World" by Aurthor Conan Doyal from Project Gutenberg.

create options:

LiterateRandomizer.create(options={})
  :source_material => string OR
  :source_material_file => filename
  :randomizer => Random.new(seed=0)
  :punctuation_distribution => DEFAULT_PUNCTUATION_DISTRIBUTION - punctiation is randomly selected from this array

paragraph options:

LiterateRandomizer.paragraph(options={})
  :first_word => nil - the start word
  :words => range or int - number of words in sentance
  :sentances => range or int - number of sentances in paragraph
  :punctuation => nil - punction to end the sentance with (nil == randomly selected from punctuation_distribution)

paragraphs options:

LiterateRandomizer.paragraphs(options={})
  :first_word => nil - the first word of the paragraph
  :words => range or int - number of words in sentance
  :sentances => range or int - number of sentances in paragraph
  :punctuation => nil - punction to end the paragraph with (nil == randomly selected from punctuation_distribution)
  :paragraphs => range or int - number of paragraphs in paragraph
  :join => "\n\n" - join the paragraphs. if :join => false, returns an array of the paragraphs

Advanced example:

lr.paragraph :sentances => 5, :words => 3..8, :first_word => "A", :punctuation => "!!!"
# => "A dense mob of our. Gods on that Challenger. Invariably to safety though. Weaponless but it my! Some bandy-legged lurching creature!!!"

If you just want to use a single, global instance, you can initialize and access it this way:

# initialize on first call
# use the same options as .create
LiterateRandomizer.global(options={})

# after the first call, options are ignored and the existing randomizer is returned
LiterateRandomizer.global.sentance
# => "Muscular arms round opening of sorts while Lord John Roxton." 

# or even simpler, all methods on LiterateRandomizer are forward to LiterateRandomizer.global:
LiterateRandomizer.paragraph(:sentances => 3, :words => 3)
# => "Drama which would. Wrong fashion which. Throw them there."

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request