factory-helper 1.6.7 → 1.7.0

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: 72a61bdc1de1cbd5de1abd330d48567051083ffb
-  data.tar.gz: ecf403f1b7acca0beb50a523e73f34f8aca86c76
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NjVhZTJiYjU2NDQ5YmIzY2EwOTZlYmI0Zjc1NzljZjhhZTZlODY0NA==
+  data.tar.gz: !binary |-
+    OGE5NmYyOTBhODJhZGU4NDcyYWYyNzE3ZDY1NzA4OWQ3Mzc2NDcyNA==
 SHA512:
-  metadata.gz: 96e8d7ddf078379852f401de34632b79d0ecc02a554c1621d0fed7ec27baca848ed7f54a458128bdefb04067095469eacc2e6321f3c62df255e3f9530fd785a6
-  data.tar.gz: 96b16daa17f269addcd12f1bdc24b3776c624fd57cbfc9742dff574926f1e6d83d1959d66a664c15920938bf3cdb77b5ce535adbdbaa02532a597b763f18debb
+  metadata.gz: !binary |-
+    YzVlNDIxZDZiZTgxMWVmNmQ1MDdhYjkzODI4OTRiMDU3ODY3ZmZmZjY3ZDMx
+    MDc5NWNjY2EyNmU1ODkyZGM0ZjliY2VjNTg4MGFhZjA0MDQ4ODY2OTM3MGYz
+    MzY3OWE2NjQ5NzZmN2Y3ZWM5MzI0ZjJiZGNmNjY1MGY2NTMzYzI=
+  data.tar.gz: !binary |-
+    YmNhN2VkYWI0ZDViMGE1ODIzYTcxNzQxM2NiMTRlNjllZTI5NzZkYTVlZDU5
+    NmZmNzA1NTdmODM5YzdhODA2MGEwYzZjNTJkNjYzMDM5MTk5YzI2MjkwYzMw
+    MDdkY2NkN2I2MzcwN2QyMTEzYTgyM2YzMTBmOGM5MmM3YTY3OTI=

data/README.md

@@ -35,9 +35,29 @@ FactoryHelper::Name.name      #=> "Christophe Bartell"
 FactoryHelper::Internet.email #=> "kirsten.greenholt@corkeryfisher.info"
 ```
 
+###Seeding
+----------
+FactoryHelper now supports seeding of Ruby's pseudo-random number generator
+(PRNG) to provide deterministic output of repeated method calls.
+
+```ruby
+FactoryHelper::Config.seed = 99
+FactoryHelper::Company.bs #=> "utilize real-time functionalities"
+FactoryHelper::Company.bs #=> "orchestrate wireless web-readiness"
+
+FactoryHelper::Config.seed = 99
+FactoryHelper::Company.bs #=> "utilize real-time functionalities"
+FactoryHelper::Company.bs #=> "orchestrate wireless web-readiness"
+
+FactoryHelper::Config.seed = nil # seeds the PRNG with Ruby's default entropy source
+
+FactoryHelper::Config.random.seed #=> 57010835277627224902731113142647237214
+
+FactoryHelper::Company.bs #=> "revolutionize plug-and-play architectures"
+```
+
 ###FactoryHelper::String
 -----------------
-
 Random UTF-8 string with an optional length argument
 
 ```ruby
@@ -297,9 +317,11 @@ FactoryHelper::Avatar.image("my-own-slug", "50x50", "bmp") #=> "http://robohash.
 ----------------
 
 ```ruby
-# Required parameter: digits
+# Optional parameter: digits
 FactoryHelper::Number.number(10) #=> "1968353479"
 
+FactoryHelper::Number.hexadecimal(10) #=> "9b7b26aa4c"
+
 FactoryHelper::Number.digit #=> "1"
 ```
 
@@ -404,7 +426,6 @@ FactoryHelper::App.author #=> "Daphne Swift"
 
 ###FactoryHelper::SlackEmoji
 -----------------
-
 Random Slack Emoji
 
 ```ruby
@@ -468,7 +489,7 @@ See [CONTRIBUTING.md](https://github.com/factory-helper/factory-helper/blob/mast
 
 Contact
 -------
-Comments and feedback are welcome. Send an email to factory-helper@googlegroups.com.
+Comments and feedback are welcome via GitHub Issues.
 
 License
 -------

data/lib/factory-helper.rb

@@ -17,12 +17,19 @@ I18n.load_path += Dir[File.join(mydir, 'locales', '*.yml')]
 module FactoryHelper
   class Config
     @locale = nil
+    @random = Random.new
 
     class << self
       attr_writer :locale
+      attr_reader :random
+
       def locale
         @locale || I18n.locale
       end
+
+      def seed=(seed)
+        @random = seed ? Random.new(seed) : Random.new
+      end
     end
   end
 
@@ -34,11 +41,11 @@ module FactoryHelper
     class << self
       ## make sure numerify results doesn’t start with a zero
       def numerify(number_string)
-        number_string.sub(/#/) { (rand(9)+1).to_s }.gsub(/#/) { rand(10).to_s }
+        number_string.sub(/#/) { (FactoryHelper::Config.random.rand(9)+1).to_s }.gsub(/#/) { FactoryHelper::Config.random.rand(10).to_s }
       end
 
       def letterify(letter_string)
-        letter_string.gsub(/\?/) { ULetters.sample }
+        letter_string.gsub(/\?/) { ULetters.sample(:random => FactoryHelper::Config.random) }
       end
 
       def bothify(string)
@@ -69,21 +76,21 @@ module FactoryHelper
         re.
           gsub(/^\/?\^?/, '').gsub(/\$?\/?$/, '').                                                                      # Ditch the anchors
           gsub(/\{(\d+)\}/, '{\1,\1}').gsub(/\?/, '{0,1}').                                                             # All {2} become {2,2} and ? become {0,1}
-          gsub(/(\[[^\]]+\])\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample }.                # [12]{1,2} becomes [12] or [12][12]
-          gsub(/(\([^\)]+\))\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample }.                # (12|34){1,2} becomes (12|34) or (12|34)(12|34)
-          gsub(/(\\?.)\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample }.                      # A{1,2} becomes A or AA or \d{3} becomes \d\d\d
-          gsub(/\((.*?)\)/) {|match| match.gsub(/[\(\)]/, '').split('|').sample }.                                      # (this|that) becomes 'this' or 'that'
-          gsub(/\[([^\]]+)\]/) {|match| match.gsub(/(\w\-\w)/) {|range| Array(Range.new(*range.split('-'))).sample } }. # All A-Z inside of [] become C (or X, or whatever)
-          gsub(/\[([^\]]+)\]/) {|match| $1.split('').sample }.                                                          # All [ABC] become B (or A or C)
-          gsub('\d') {|match| Numbers.sample }.
-          gsub('\w') {|match| Letters.sample }
+          gsub(/(\[[^\]]+\])\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample(:random => FactoryHelper::Config.random) }.                # [12]{1,2} becomes [12] or [12][12]
+          gsub(/(\([^\)]+\))\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample(:random => FactoryHelper::Config.random) }.                # (12|34){1,2} becomes (12|34) or (12|34)(12|34)
+          gsub(/(\\?.)\{(\d+),(\d+)\}/) {|match| $1 * Array(Range.new($2.to_i, $3.to_i)).sample(:random => FactoryHelper::Config.random) }.                      # A{1,2} becomes A or AA or \d{3} becomes \d\d\d
+          gsub(/\((.*?)\)/) {|match| match.gsub(/[\(\)]/, '').split('|').sample(:random => FactoryHelper::Config.random) }.                                      # (this|that) becomes 'this' or 'that'
+          gsub(/\[([^\]]+)\]/) {|match| match.gsub(/(\w\-\w)/) {|range| Array(Range.new(*range.split('-'))).sample(:random => FactoryHelper::Config.random) } }. # All A-Z inside of [] become C (or X, or whatever)
+          gsub(/\[([^\]]+)\]/) {|match| $1.split('').sample(:random => FactoryHelper::Config.random) }.                                                          # All [ABC] become B (or A or C)
+          gsub('\d') {|match| Numbers.sample(:random => FactoryHelper::Config.random) }.
+          gsub('\w') {|match| Letters.sample(:random => FactoryHelper::Config.random) }
       end
 
       # Helper for the common approach of grabbing a translation
       # with an array of values and selecting one of them.
       def fetch(key)
         fetched = translate("factory_helper.#{key}")
-        fetched = fetched.sample if fetched.respond_to?(:sample)
+        fetched = fetched.sample(:random => FactoryHelper::Config.random) if fetched.respond_to?(:sample)
         if fetched.match(/^\//) and fetched.match(/\/$/) # A regex
           regexify(fetched)
         else
@@ -141,7 +148,7 @@ module FactoryHelper
 
         # Use the alternate form of translate to get a nil rather than a "missing translation" string
         if translation = translate(:factory_helper)[@flexible_key][m]
-          translation.respond_to?(:sample) ? translation.sample : translation
+          translation.respond_to?(:sample) ? translation.sample(:random => FactoryHelper::Config.random) : translation
         else
           super
         end
@@ -150,7 +157,7 @@ module FactoryHelper
       # Generates a random value between the interval
       def rand_in_range(from, to)
         from, to = to, from if to < from
-        Random.new.rand(from..to)
+        FactoryHelper::Config.random.rand(from..to)
       end
     end
   end

data/lib/factory-helper/address.rb

@@ -47,11 +47,11 @@ module FactoryHelper
       def country_code;  fetch('address.country_code');  end
 
       def latitude
-        ((rand * 180) - 90).to_s
+        ((FactoryHelper::Config.random.rand * 180) - 90).to_s
       end
 
       def longitude
-        ((rand * 360) - 180).to_s
+        ((FactoryHelper::Config.random.rand * 360) - 180).to_s
       end
 
     end

data/lib/factory-helper/bitcoin.rb

@@ -18,7 +18,7 @@ module FactoryHelper
         address_for(:testnet)
       end
 
-      protected
+      private
 
       def base58(str)
         alphabet = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
@@ -38,8 +38,9 @@ module FactoryHelper
       end
 
       def address_for(network)
+        hex_160_bit = 0xffffffffffffffffffffffffffffffffffffffff
         version = PROTOCOL_VERSIONS.fetch(network)
-        hash = SecureRandom.hex(20)
+        hash = FactoryHelper::Config.random.rand(hex_160_bit).to_s(16)
         packed = version.chr + [hash].pack("H*")
         checksum = Digest::SHA2.digest(Digest::SHA2.digest(packed))[0..3]
         base58(packed + checksum)

data/lib/factory-helper/commerce.rb

@@ -8,7 +8,7 @@ module FactoryHelper
 
       def department(max = 3, fixed_amount = false)
         num = max if fixed_amount
-        num ||= 1 + rand(max)
+        num ||= 1 + FactoryHelper::Config.random.rand(max)
 
         categories = categories(num)
 
@@ -28,7 +28,7 @@ module FactoryHelper
       end
 
       def price
-        random = Random.new
+        random = FactoryHelper::Config.random
         (random.rand(0..100.0) * 100).floor/100.0
       end
 

data/lib/factory-helper/company.rb

@@ -13,29 +13,29 @@ module FactoryHelper
 
       # Generate a buzzword-laden catch phrase.
       def catch_phrase
-        translate('factory_helper.company.buzzwords').collect {|list| list.sample }.join(' ')
+        translate('factory_helper.company.buzzwords').collect {|list| list.sample(:random => FactoryHelper::Config.random) }.join(' ')
       end
 
       def buzzword
-        translate('factory_helper.company.buzzwords').flatten.sample
+        translate('factory_helper.company.buzzwords').flatten.sample(:random => FactoryHelper::Config.random)
       end
 
       # When a straight answer won't do, BS to the rescue!
       def bs
-        translate('factory_helper.company.bs').collect {|list| list.sample }.join(' ')
+        translate('factory_helper.company.bs').collect {|list| list.sample(:random => FactoryHelper::Config.random) }.join(' ')
       end
 
       def ein
-        ('%09d' % rand(10 ** 9)).gsub(/(\d\d)(\d\d\d\d\d\d\d)/, '\\1-\\2')
+        ('%09d' % FactoryHelper::Config.random.rand(10 ** 9)).gsub(/(\d\d)(\d\d\d\d\d\d\d)/, '\\1-\\2')
       end
 
       def duns_number
-        ('%09d' % rand(10 ** 9)).gsub(/(\d\d)(\d\d\d)(\d\d\d\d)/, '\\1-\\2-\\3')
+        ('%09d' % FactoryHelper::Config.random.rand(10 ** 9)).gsub(/(\d\d)(\d\d\d)(\d\d\d\d)/, '\\1-\\2-\\3')
       end
 
       # Get a random company logo url in PNG format.
       def logo
-        rand_num = Random.rand(13) + 1
+        rand_num = FactoryHelper::Config.random.rand(13) + 1
         "http://pigment.github.io/fake-logos/logos/medium/color/#{rand_num}.png"
       end
     end

data/lib/factory-helper/date.rb

@@ -3,7 +3,7 @@ module FactoryHelper
 
     class << self
 
-      def between(from, to)
+      def between(from=::Date.today-10, to=::Date.today+10)
         from = get_date_object(from)
         to   = get_date_object(to)
 
@@ -25,9 +25,9 @@ module FactoryHelper
       end
 
       def birthday(min_age = 18, max_age = 65)
-        t = ::Date.today
-        from =  ::Date.new(t.year - min_age, t.month, t.day - 1)
-        to   =  ::Date.new(t.year - max_age, t.month, t.day + 1)
+        today= ::Date.today
+        from = ::Date.new(today.year - min_age, today.month, today.day) - 1
+        to   = ::Date.new(today.year - max_age, today.month, today.day) + 1
 
         between(from, to).to_date
       end

data/lib/factory-helper/finance.rb

@@ -5,7 +5,7 @@ module FactoryHelper
     class << self
       def credit_card(*types)
         types = CREDIT_CARD_TYPES if types.empty?
-        type = types.sample
+        type = types.sample(:random => FactoryHelper::Config.random)
         template = numerify(fetch("credit_card.#{type}"))
 
         # calculate the luhn checksum digit

data/lib/factory-helper/hacker.rb

@@ -2,18 +2,18 @@
 module FactoryHelper
   class Hacker < Base
     flexible :hacker
-    
+
     class << self
       def say_something_smart
-        phrases.sample
+        phrases.sample(:random => FactoryHelper::Config.random)
       end
-      
+
       def abbreviation;  fetch('hacker.abbreviation'); end
       def adjective;     fetch('hacker.adjective'); end
       def noun;          fetch('hacker.noun'); end
       def verb;          fetch('hacker.verb'); end
       def ingverb;       fetch('hacker.ingverb'); end
-                    
+
       def phrases
          [ "If we #{verb} the #{noun}, we can get to the #{abbreviation} #{noun} through the #{adjective} #{abbreviation} #{noun}!",
            "We need to #{verb} the #{adjective} #{abbreviation} #{noun}!",
@@ -22,7 +22,7 @@ module FactoryHelper
            "Use the #{adjective} #{abbreviation} #{noun}, then you can #{verb} the #{adjective} #{noun}!",
            "The #{abbreviation} #{noun} is down, #{verb} the #{adjective} #{noun} so we can #{verb} the #{abbreviation} #{noun}!",
            "#{ingverb} the #{noun} won't do anything, we need to #{verb} the #{adjective} #{abbreviation} #{noun}!",
-           "I'll #{verb} the #{adjective} #{abbreviation} #{noun}, that should #{noun} the #{abbreviation} #{noun}!"               
+           "I'll #{verb} the #{adjective} #{abbreviation} #{noun}, that should #{noun} the #{abbreviation} #{noun}!"
            ]
       end
     end

data/lib/factory-helper/internet.rb

@@ -11,12 +11,19 @@ module FactoryHelper
       end
 
       def safe_email(name = nil)
-        [user_name(name), 'example.'+ %w[org com net].shuffle.first].join('@')
+        [
+          user_name(name),
+          'example.'+ %w[org com net].
+            shuffle(:random => FactoryHelper::Config.random).first
+        ].join('@')
       end
 
       def user_name(specifier = nil, separators = %w(. _))
         if specifier.kind_of? ::String
-          return specifier.scan(/\w+/).shuffle.join(separators.sample).downcase
+          return specifier.scan(/\w+/).
+            shuffle(:random => FactoryHelper::Config.random).
+            join(separators.sample(:random => FactoryHelper::Config.random)).
+            downcase
         elsif specifier.kind_of? Integer
           tries = 0 # Don't try forever in case we get something like 1_000_000.
           begin
@@ -41,15 +48,15 @@ module FactoryHelper
           Proc.new {
             [ Name.first_name, Name.last_name ].map {|n|
               n.gsub(/\W/, '')
-            }.join(separators.sample).downcase }
-        ].sample.call)
+            }.join(separators.sample(:random => FactoryHelper::Config.random)).downcase }
+        ].sample(:random => FactoryHelper::Config.random).call)
       end
 
       def password(min_length = 8, max_length = 16)
         temp = Lorem.characters(min_length)
         diff_length = max_length - min_length
         if diff_length > 0
-          diff_rand = rand(diff_length + 1)
+          diff_rand = FactoryHelper::Config.random.rand(diff_length + 1)
           temp += Lorem.characters(diff_rand)
         end
         temp = temp[0..min_length] if min_length > 0
@@ -60,17 +67,6 @@ module FactoryHelper
         [ fix_umlauts(domain_word), domain_suffix ].join('.')
       end
 
-      def fix_umlauts(string)
-        string.gsub(/[äöüß]/i) do |match|
-            case match.downcase
-                when "ä" 'ae'
-                when "ö" 'oe'
-                when "ü" 'ue'
-                when "ß" 'ss'
-            end
-        end
-      end
-
       def domain_word
         Company.name.split(' ').first.gsub(/\W/, '').downcase
       end
@@ -81,21 +77,25 @@ module FactoryHelper
 
       def mac_address(prefix='')
         prefix_digits = prefix.split(':').map{ |d| d.to_i(16) }
-        address_digits = (6 - prefix_digits.size).times.map{ rand(256) }
+        address_digits = (6 - prefix_digits.size).times.map do
+          FactoryHelper::Config.random.rand(256)
+        end
         (prefix_digits + address_digits).map{ |d| '%02x' % d }.join(':')
       end
 
       def ip_v4_address
         ary = (2..254).to_a
-        [ary.sample,
-        ary.sample,
-        ary.sample,
-        ary.sample].join('.')
+        [ary.sample(:random => FactoryHelper::Config.random),
+        ary.sample(:random => FactoryHelper::Config.random),
+        ary.sample(:random => FactoryHelper::Config.random),
+        ary.sample(:random => FactoryHelper::Config.random)].join('.')
       end
 
       def ip_v6_address
         @@ip_v6_space ||= (0..65535).to_a
-        container = (1..8).map{ |_| @@ip_v6_space.sample }
+        container = (1..8).map do |_|
+          @@ip_v6_space.sample(:random => FactoryHelper::Config.random)
+        end
         container.map{ |n| n.to_s(16) }.join(':')
       end
 
@@ -104,13 +104,23 @@ module FactoryHelper
       end
 
       def slug(words = nil, glue = nil)
-        glue ||= %w[- _ .].sample
+        glue ||= %w[- _ .].sample(:random => FactoryHelper::Config.random)
         (words || FactoryHelper::Lorem::words(2).join(' ')).gsub(' ', glue).downcase
       end
 
       def device_token
-        rand(16 ** 64).to_s(16).rjust(64, '0').chars.to_a.shuffle.join
+        FactoryHelper::Config.random.rand(16 ** 64).to_s(16).rjust(64, '0').
+          chars.to_a.shuffle(:random => FactoryHelper::Config.random).join
       end
+
+      def fix_umlauts(string= '')
+        {"ä" => 'ae', "ö" => 'oe', "ü" => 'ue', "ß" => 'ss'}.each do |key, val|
+          string.gsub!(key.downcase, val.downcase)
+          string.gsub!(key.upcase, val.upcase)
+        end
+        string
+      end
+
     end
   end
 end

data/lib/factory-helper/lorem.rb

@@ -3,7 +3,7 @@ module FactoryHelper
   class Lorem < Base
     class << self
       def word
-        translate('factory_helper.lorem.words').sample
+        translate('factory_helper.lorem.words').sample(:random => FactoryHelper::Config.random)
       end
 
       def words(num = 3, supplemental = false)
@@ -13,21 +13,23 @@ module FactoryHelper
           (supplemental ? translate('factory_helper.lorem.supplemental') : [])
         )
         word_list = word_list * ((resolved_num / word_list.length) + 1)
-        word_list.shuffle[0, resolved_num]
+        word_list.shuffle(:random => FactoryHelper::Config.random)[0, resolved_num]
       end
 
       def character
         characters(1)
       end
 
-      def characters(char_count = 255)
+      def characters(char_count= 255)
         return '' if char_count.respond_to?(:to_i) && char_count.to_i < 1
         char_count = resolve(char_count)
-        rand(36**char_count).to_s(36).rjust(char_count, '0').chars.to_a.shuffle.join
+        FactoryHelper::Config.random.rand(36**char_count).to_s(36).
+          rjust(char_count, '0').chars.to_a.
+          shuffle(:random => FactoryHelper::Config.random).join
       end
 
       def sentence(word_count = 4, supplemental = false, random_words_to_add = 6)
-        words(word_count + rand(random_words_to_add.to_i).to_i, supplemental).join(' ').capitalize + '.'
+        words(word_count + FactoryHelper::Config.random.rand(random_words_to_add.to_i).to_i, supplemental).join(' ').capitalize + '.'
       end
 
       def sentences(sentence_count = 3, supplemental = false)
@@ -39,7 +41,7 @@ module FactoryHelper
       end
 
       def paragraph(sentence_count = 3, supplemental = false, random_sentences_to_add = 3)
-        sentences(resolve(sentence_count) + rand(random_sentences_to_add.to_i).to_i, supplemental).join(' ')
+        sentences(resolve(sentence_count) + FactoryHelper::Config.random.rand(random_sentences_to_add.to_i).to_i, supplemental).join(' ')
       end
 
       def paragraphs(paragraph_count = 3, supplemental = false)
@@ -56,8 +58,8 @@ module FactoryHelper
       # All other values are simply returned.
       def resolve(value)
         case value
-        when Array then value[rand(value.size)]
-        when Range then rand((value.last+1) - value.first) + value.first
+        when Array then value[FactoryHelper::Config.random.rand(value.size)]
+        when Range then FactoryHelper::Config.random.rand((value.last+1) - value.first) + value.first
         else value
         end
       end

data/lib/factory-helper/number.rb

@@ -1,23 +1,23 @@
 module FactoryHelper
   class Number < Base
     class << self
-      def number(digits)
+      def number(digits=10)
         (1..digits).collect {digit}.join
       end
 
-      def decimal(l_digits, r_digits = 2)
+      def decimal(l_digits=5, r_digits = 2)
         l_d = self.number(l_digits)
         r_d = self.number(r_digits)
         "#{l_d}.#{r_d}"
       end
 
       def digit
-        (rand() * 9).round.to_s
+        (FactoryHelper::Config.random.rand() * 9).round.to_s
       end
 
-      def hexadecimal(digits)
+      def hexadecimal(digits=6)
         hex = ""
-        digits.times { hex += rand(15).to_s(16) }
+        digits.times { hex += FactoryHelper::Config.random.rand(15).to_s(16) }
         hex
       end
 

data/lib/factory-helper/phone_number.rb

@@ -40,7 +40,7 @@ module FactoryHelper
       # Since extensions can be of variable length, this method taks a length parameter
       def subscriber_number(length = 4)
         begin
-          rand.to_s[2..(1 + length)]
+          FactoryHelper::Config.random.rand.to_s[2..(1 + length)]
         rescue I18n::MissingTranslationData
           nil
         end

data/lib/factory-helper/string.rb

@@ -1,28 +1,32 @@
 module FactoryHelper
   class String
-    def self.random(length= 32)
-      if length.class.included_modules.include? Enumerable
-        utf8string length.to_enum.to_a.sample
-      else
-        utf8string length
+    class << self
+      def random(length= 32)
+          utf8string select_a length
       end
-    end
 
-  protected
+    private
 
-    def self.utf8string(length)
-      (1..length.to_i).map do |_|
-        characters.sample.chr(Encoding::UTF_8)
-      end.join.force_encoding("UTF-8")
-    end
+      def select_a length
+        if length.class.included_modules.include? Enumerable
+          select_a length.to_enum.to_a.sample(:random => FactoryHelper::Config.random)
+        else
+          length
+        end
+      end
 
-    def self.characters
-      [
-        rand(59)+ 32,          # latin alphabet
-        rand(128),             # 7-bit ASCII
-        rand(0xd800),          # utf-8 codepoints below utf-16 surrogate halves
-        rand(0x102000)+ 0xe000 # utf-8 codepoints above utf-16 surrogate halves
-      ]
+      def utf8string(length)
+        (1..length.to_i).map{ utf8character }.join
+      end
+
+      def utf8character
+        [
+          FactoryHelper::Config.random.rand(59)+ 32,          # latin alphabet
+          FactoryHelper::Config.random.rand(128),             # 7-bit ASCII
+          FactoryHelper::Config.random.rand(0xd800),          # utf-8 codepoints below utf-16 surrogate halves
+          FactoryHelper::Config.random.rand(0x102000)+ 0xe000 # utf-8 codepoints above utf-16 surrogate halves
+        ].sample(:random => FactoryHelper::Config.random).chr(Encoding::UTF_8)
+      end
     end
   end
 end

data/lib/factory-helper/team.rb

@@ -12,7 +12,7 @@ module FactoryHelper
       end
 
       def state
-        fetch('factory_helper.address.state').titleize
+        fetch('address.state').split(' ').map(&:capitalize).join(' ')
       end
     end
 

data/lib/factory-helper/time.rb

@@ -11,7 +11,8 @@ module FactoryHelper
     }
 
     class << self
-      def between(from, to, period = :all)
+
+      def between(from=::Time.at(0), to=::Time.now, period = :all)
         super(from, to).to_time + random_time(period)
       end
 
@@ -31,7 +32,7 @@ module FactoryHelper
 
       def hours(period)
         raise ArgumentError, 'invalid period' unless TIME_RANGES.has_key? period
-        hour_at_period = TIME_RANGES[period].to_a.sample
+        hour_at_period = TIME_RANGES[period].to_a.sample(:random => FactoryHelper::Config.random)
 
         (60 * 60 * hour_at_period)
       end
@@ -41,7 +42,7 @@ module FactoryHelper
       end
 
       def seconds
-        (0..59).to_a.sample
+        (0..59).to_a.sample(:random => FactoryHelper::Config.random)
       end
     end
   end

data/lib/factory-helper/version.rb

@@ -1,3 +1,3 @@
 module FactoryHelper #:nodoc:
-  VERSION = "1.6.7"
+  VERSION = "1.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factory-helper
 version: !ruby/object:Gem::Version
-  version: 1.6.7
+  version: 1.7.0
 platform: ruby
 authors:
 - Brian Giaraffa
@@ -9,93 +9,93 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-29 00:00:00.000000000 Z
+date: 2015-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.10'
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.8'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.2'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
-description: 'Easily generate fake data: names, addresses, phone numbers, etc.'
+description: ! 'Easily generate fake data: names, addresses, phone numbers, etc.'
 email:
 - factory-helper@googlegroups.com
 executables: []
@@ -165,17 +165,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.4
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: Easily generate fake data