literate_randomizer 0.2.1 → 0.3.0

data/README.md

@@ -23,29 +23,54 @@ 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.
 
-    LiterateRandomizer.create options:
+**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
 
-Here are the options for the paragraph method:
+**paragraph** options:
 
-    LiterateRandomizer.create.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 => "!!!"
@@ -61,6 +86,10 @@ If you just want to use a single, global instance, you can initialize and access
     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
 
 1. Fork it

data/lib/literate_randomizer.rb

@@ -4,12 +4,21 @@ end
 
 module LiterateRandomizer
 
-  def LiterateRandomizer::create(options={})
-    MarkovChain.new options
-  end
+  class << self
+    def create(options={})
+      MarkovChain.new options
+    end
 
-  def LiterateRandomizer::global(options={})
-    MarkovChain.global options
-  end
+    def global(options={})
+      @global_instance ||= MarkovChain.new options
+    end
 
+    def method_missing(method, *arguments, &block)
+      global.send(method, *arguments, &block)
+    end
+
+    def respond_to?(method)
+      super || global.respond_to?(method)
+    end
+  end
 end

data/lib/literate_randomizer/markov.rb

@@ -4,7 +4,8 @@
 
 module LiterateRandomizer
 class MarkovChain
-  DEFAULT_PUNCTUATION_DISTRIBUTION = %w{. . . . . . . . ? !}
+  DEFAULT_PUNCTUATION_DISTRIBUTION = %w{. . . . . . . . . . . . . . . . ? !}
+  PREPOSITION_REGEX = /^(the|to|and|a|in|that|it|if|is|was|for|on|as|an)$/
   attr_accessor :randomizer, :init_options, :punctuation_distribution
   attr_reader :markov_words, :words, :first_words
 
@@ -79,6 +80,11 @@ class MarkovChain
     populate_markov_sum
   end
 
+  def max(r)
+    return r if r.kind_of? Integer
+    r.max
+  end
+
   def rand_count(r)
     return r if r.kind_of? Integer
     rand(r.max-r.min)+r.min
@@ -97,12 +103,6 @@ class MarkovChain
     populate
   end
 
-  class << self
-    def global(options={})
-      @global_randomizer = MarkovChain.new options
-    end
-  end
-
   def inspect
     "#<#{self.class}: #{@words.length} words, #{@markov_words.length} word-chains, #{@first_words.length} first_words>"
   end
@@ -112,10 +112,10 @@ class MarkovChain
     sum = @markov_weighted_sum[word]
     random = rand(sum)+1
     partial_sum = 0
-    markov_words[word].find do |word, count|
+    (markov_words[word].find do |w, count|
       partial_sum += count
-      partial_sum >= random
-    end.first
+      w!=word && partial_sum >= random
+    end||[]).first
   end
   
   def rand(limit=nil)
@@ -143,6 +143,13 @@ class MarkovChain
   def punctuation
     @punctuation_distribution[rand(@punctuation_distribution.length)]
   end
+
+  def extend_trailing_preposition(max_words,words)
+    while words.length < max_words && words[-1] && words[-1][PREPOSITION_REGEX]
+      words << next_word(words[-1])
+    end
+    words
+  end
   
   # return a random sentance
   # options:
@@ -151,12 +158,17 @@ class MarkovChain
   #   * :punctuation => nil - punction to end the sentance with (nil == randomly selected from punctuation_distribution)
   def sentance(options={})
     word = options[:first_word] || self.markov_word
-    count = rand_count options[:words] || (3..15)
+    num_words_option = options[:words] || (3..15)
+    count = rand_count num_words_option
     punctuation = options[:punctuation] || self.punctuation
 
-    capitalize(count.times.collect do 
+    words = count.times.collect do 
       word.tap {word = next_word(word)}
-    end.compact.join(" ") + punctuation)
+    end.compact
+
+    words = extend_trailing_preposition(max(num_words_option), words)
+
+    capitalize words.compact.join(" ") + punctuation
   end
   
   # return a random paragraph
@@ -175,5 +187,27 @@ class MarkovChain
       sentance op
     end.join(" ")
   end
+
+  # return random 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
+  #   * :paragraphs => range or int - number of paragraphs in paragraph
+  #   * :join => "\n\n" - join the paragraphs. if :join => false, returns an array of the paragraphs
+  #   * :punctuation => nil - punction to end the paragraph with (nil == randomly selected from punctuation_distribution)
+  def paragraphs(options={})
+    count = rand_count options[:paragraphs] || (3..5)
+    join_str = options[:join]
+
+    res = count.times.collect do |i|
+      op = options.clone
+      op.delete :punctuation unless i==count-1
+      op.delete :first_word unless i==0
+      paragraph op
+    end
+
+    join_str!=false ? res.join(join_str || "\n\n") : res
+  end
 end
 end

data/lib/literate_randomizer/version.rb

@@ -1,3 +1,3 @@
 module LiterateRandomizer
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/spec/literate_randomizer_spec.rb

@@ -8,6 +8,10 @@ describe LiterateRandomizer do
     $lr
   end
 
+  before(:each) do
+    LiterateRandomizer.global.randomizer = Random.new(1)
+  end
+
   it "should be possible to create a randomizer" do
     lr = new_lr
     lr.should_not == nil
@@ -31,44 +35,57 @@ describe LiterateRandomizer do
   end
 
   it "sentance should return a random sentance" do
-    new_lr.sentance.should == "Bad form of my own chances are a riding-whip!"
+    new_lr.sentance.should == "Bad form of my own chances are a riding-whip."
   end
 
   it "sentance length should work" do
-    new_lr.sentance(:words => 1).should == "Bad?"
-    new_lr.sentance(:words => 3).should == "Bad job for?"
-    new_lr.sentance(:words => 5).should == "Bad job for a final?"
-    new_lr.sentance(:words => 7).should == "Bad job for a final credit of?"
-    new_lr.sentance(:words => 9).should == "Bad job for a final credit of the side?"
-    new_lr.sentance(:words => 2..7).should == "Bad job for a final credit?"
+    new_lr.sentance(:words => 1).should == "Bad."
+    new_lr.sentance(:words => 3).should == "Bad money if."
+    new_lr.sentance(:words => 5).should == "Bad money if ever come."
+    new_lr.sentance(:words => 7).should == "Bad money if ever come outwards at."
+    new_lr.sentance(:words => 9).should == "Bad money if ever come outwards at the side."
+    new_lr.sentance(:words => 2..7).should == "Bad job for a final credit."
   end
 
   it "successive calls should vary" do
     lr = new_lr
-    lr.sentance.should == "Bad form of my own chances are a riding-whip!"
-    lr.sentance.should == "Hit you that book down below as his tattered sketch-book which held."
-    lr.sentance.should == "Seated upon their journey up my sleeve and incalculable people start to-morrow!"
+    lr.sentance.should == "Bad form of my own chances are a riding-whip."
+    lr.sentance.should == "Hit you chaps think of battle Our young fellah when in Streatham."
+    lr.sentance.should == "Upward curves which should be through the whole tribe."
   end
 
   it "paragraph should work" do
-    lr = new_lr
-    lr.paragraph.should == "Bad form of my own chances are a riding-whip! Hit you that book down below as his tattered sketch-book which held. Seated upon their journey up my sleeve and incalculable people start to-morrow! Telling you propose to this half-educated age of the bushes at last supreme! Placed over us. Rubbing his strong sunlight struck me and Fate with the effect of. Columns until he came at a. Elusive enemies while beneath the main river up in it because on. Fully justified in the big as the bank of that the. Variety of photographs said for the words!"
+    new_lr.paragraph.should == "Bad form of my own chances are a riding-whip. Hit you chaps think of battle Our young fellah when in Streatham. Upward curves which should be through the whole tribe. Mend it at Edinburgh rose and it in diameter. Placed behind him. Rubbing his elephant-gun and sloth which way up to Project Gutenberg is going. Columns until he came at a last. Elusive enemies while beneath the main river up in it because on a boiling. Burying its coloring that skull and that there was able. Eventful moment of my clothes were to visit."
   end
 
   it "first_word should work" do
-    new_lr.paragraph(:sentances => 5, :words=>3).should == "Bad job for? Discreetly vague way. Melee in the. Gleam of a. Puffing red-faced irascible."
-    new_lr.paragraph(:sentances => 2..4, :words=>3).should == "Bad job for? Discreetly vague way. Melee in the."
+    new_lr.paragraph(:sentances => 5, :words=>3).should == "Bad money if. Discreetly vague way. Melee in that. Hopin that dreadful. Executive and hold."
+    new_lr.paragraph(:sentances => 2..4, :words=>3).should == "Bad money if. Discreetly vague way. Melee in that."
   end
 
   it "first_word should work" do
-    new_lr.paragraph(:first_word => "A",:sentances => 5, :words=>3).should == "A roaring rumbling. Instanced a most. Melee in the. Gleam of a. Puffing red-faced irascible."
+    new_lr.paragraph(:first_word => "A",:sentances => 5, :words=>3).should == "A roaring rumbling. Instanced a journalist. Eight after to-morrow. Hopin that dreadful. Executive and hold."
   end
 
   it "punctuation should work" do
-    new_lr.paragraph(:punctuation => "!!!",:sentances => 5, :words=>3).should == "Bad job for? Discreetly vague way. Melee in the. Gleam of a. Puffing as a!!!"
+    new_lr.paragraph(:punctuation => "!!!",:sentances => 5, :words=>3).should == "Bad money if. Discreetly vague way. Melee in that. Hopin that dreadful. Executive and hold!!!"
   end
 
   it "global_randomizer_should work" do
     LiterateRandomizer.global.class.should == LiterateRandomizer::MarkovChain
   end
+
+  it "global_randomizer_should forwarding should work" do
+    LiterateRandomizer.respond_to?(:paragraph).should == true
+    LiterateRandomizer.respond_to?(:fonsfoaihdsfa).should == false
+    LiterateRandomizer.word.should == "own"
+    LiterateRandomizer.sentance.should == "Beak filled in the side of Vertebrate Evolution and up into private."
+    LiterateRandomizer.paragraph.should == "GUTENBERG-tm concept of their rat-trap grip upon Challenger of the carrying of! Precipices of me! Telling you with great enterprise upon their own eventual goal and it in a liar. The complete your. Historical architecture elaborated slowly defined our heads there came upon their leathery. Their signs of. Elusive enemies while beneath the main river up in it because on a boiling."
+  end
+
+  it "global_randomizer_should forwarding should work" do
+    LiterateRandomizer.paragraphs(:words =>2, :sentances => 2).should == "Bad money. Instanced a.\n\nFLAIL OF. Melee in.\n\nHit you. Executive and.\n\nHopes and. Puffing red-faced."
+    LiterateRandomizer.paragraphs(:words =>2, :sentances => 2, :join=>"--").should == "Pick holes. Telling you.--Mend it. Considerate of!--Albany and! Fame or?--The weak. Prime mover."
+    LiterateRandomizer.paragraphs(:words =>2, :sentances => 2, :join=>false).should == ["Reporters down. Again the.", "Their position. Dressing down.", "Chandeliers in. Although every."]
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: literate_randomizer
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors: