Add Faker::Markdown.sandwich

doc/markdown.md

@@ -26,4 +26,11 @@ Faker::Markdown.table #=> "ad | similique | voluptatem\n---- | ---- | ----\ncorr
 
 # Random - randomly chooses an above method
 Faker::Markdown.random #=> returns output from a single method outlined above
+
+# Sandwich - creates a simulated blog-esque text-heavy block in markdown
+Faker::Markdown.sandwich #=> returns newline separated content of 1 header, 1 default lorem paragraph, and 1 random markdown element
+
+Faker::Markdown.sandwich(5) #=> returns newline separated content of 1 header, 1 5-sentence lorem paragraph, and 1 random markdown element
+
+Faker::Markdown.sandwich(6, 3) #=> returns newline separated content of 1 header, and then 3 sections consisting of, here, 1 6-sentence lorem paragraph and 1 random markdown element. The random markdown element is chosen at random in each iteration of the paragraph-markdown pairing.
 ```

lib/faker/markdown.rb

@@ -56,6 +56,16 @@ def random
         send(available_methods[rand(0..available_methods.length - 1)])
       end
 
+      def sandwich(sentences = 3, repeat = 1)
+        text_block = []
+        text_block << headers
+        repeat.times do
+          text_block << Faker::Lorem.paragraph(sentences)
+          text_block << random
+        end
+        text_block.join("\n")
+      end
+
       private
 
       def available_methods

test/test_faker_markdown.rb

@@ -68,4 +68,20 @@ def test_random
     assert_instance_of(String, test_trigger)
   end
 
+  def test_sandwich
+    test_trigger = @tester.sandwich
+
+    test_array = []
+    test_trigger.each_line{|substr| test_array << substr }
+
+    assert(test_array.length == 3)
+
+    assert(test_array[0].split(' ').length == 2)
+    assert(test_array[0].split(' ').first.include?("#"))
+
+    assert(test_array[1].count(".") == 3)
+
+    assert_instance_of(String, test_array[2])
+  end
+
 end