randomperson 0.0.19 → 1.0.0

data/spec/randomperson_spec.rb

@@ -0,0 +1,321 @@
+# encoding: UTF-8
+
+require_relative "./rspec_helper.rb"
+require_relative "../lib/randomperson.rb"
+
+shared_examples "a Person" do
+  it { subject.first.should_not be_nil }
+  it { subject.first.should be_a_kind_of String }
+  it { subject.last.should_not be_nil }
+  it { subject.last.should be_a_kind_of String }
+  it { subject.prefix.should_not be_nil }
+  it { subject.prefix.should be_a_kind_of String }
+end
+
+shared_examples "there is more than one demographic" do
+  context "Given a new demographic" do
+    before(:all) { r.demographic("America").add_American }
+    context "but not changing to it" do
+      let(:last_run) { r.person }
+      subject { last_run } 
+      it { should equal first_run }
+      context "changing to the new demographic" do
+        let(:new_demo_person) { r.person "America" }
+        subject { new_demo_person } 
+        it { should_not equal last_run }
+      end
+    end
+  end
+end
+
+shared_examples "getting the last person" do
+  context "on first run" do
+    subject{ first_run }
+    it_behaves_like "a Person"
+    context "on next run" do
+      context "Given no demographic" do
+        subject { r.person }
+        it { should equal first_run }
+      end
+      context "Given the same demographic" do
+        subject{ r.person "Spain" }
+        it { should equal first_run }
+        it_behaves_like "there is more than one demographic"
+      end
+    end
+  end
+end
+
+shared_examples "clear or reset" do
+  let(:r) { RandomPerson() }
+  before(:all) {
+    r.demographic("Spain").add_Spanish
+    r.demographic("Finland").add_Finnish
+    r.generate "Spain"
+    r.generate
+    r.generate "Finland"
+    r.generate
+    r.generate "Spain"
+  }
+  subject { r.clear }
+  it { should be_nil }
+  specify { r.should_not be_nil }
+  specify { r.should be_a_kind_of RandomPerson::Facade }
+  specify { r.generators.should be_empty }
+  specify { r.demographics.should be_empty }
+  specify { expect { r.person }.to raise_error }
+  specify { expect { r.generate }.to raise_error }
+  specify { expect { r.gen_new }.to raise_error }
+end
+
+
+describe RandomPerson do
+  
+  describe :person do
+    let(:r) { RandomPerson() }
+    context "Given a demographic" do
+      context "With a name" do
+        context "and one demographic specified" do
+          before(:all) {
+            r.demographic("Spain").add_Spanish
+          }
+          let(:first_run) { r.person "Spain" }
+          subject{ first_run }
+          it_behaves_like "a Person"
+          context "on next run" do
+            context "Given no demographic" do
+              subject { r.person }
+              it { should equal first_run }
+              context "and then given the same demographic explicitly" do
+                subject{ r.person "Spain" }
+                it { should equal first_run }
+                context "and then given a demo name that doesn't exist" do
+                  subject{ r.person "Spurious" }
+                  it { should be_nil }
+                  context "and then given no demo name" do
+                    subject{ r.person }
+                    it { should equal first_run }
+                  end
+                  context "and then given the last good demographic explicitly" do
+                    subject{ r.person "Spain" }
+                    it { should equal first_run }
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        context "and no demographic specified" do
+          before(:all) {
+            r.demographic("Spain").add_Spanish
+          }
+          let(:first_run) { r.person }
+          it_behaves_like "getting the last person"
+        end
+          
+      end
+      
+      context "Without a name" do
+        context "and with a demographic specified" do
+          before(:all) {
+            r.clear
+            r.demographic.add_Spanish
+          }
+          subject { r.person "Spain" }
+          it { should be_nil }
+        end
+
+        context "and no demographic specified" do
+          before(:all) {
+            r.demographic.add_Spanish
+          }
+          let(:first_run) { r.person }
+          subject { r.person }
+          it { should equal first_run }
+          context "on repeated runs" do
+            before(:all) {
+              r.clear
+              r.demographic.add_Spanish
+              r.generate
+              r.generate
+            }
+            let(:last) { r.person }
+            subject { r.person }
+            it { should equal last }
+          end
+            
+        end
+      end
+    end
+    context "With no demographic" do
+      context "Already loaded" do
+        subject { r.person }
+        specify { expect { subject }.to raise_error }
+        context "and given a demo name" do
+          subject { r.person "Not loaded" }
+          specify { expect { subject }.to raise_error }
+        end
+      end
+      context "Because they've been cleared" do
+        subject { r.person }
+        specify { expect { subject }.to raise_error }
+        context "and given a demo name" do
+          subject { r.person "Been cleared" }
+          specify { expect { subject }.to raise_error }
+        end
+      end
+    end
+  end # :person
+  
+  
+  describe :generators do
+    let(:r) { RandomPerson() }
+    before(:all) {
+      r.demographic("Spain").add_Spanish
+      r.demographic("Finland").add_Finnish
+    }
+    context "Before first run" do
+      subject { r.generators }
+      it { should be_empty }
+    end
+    context "First run" do
+      before { 
+        r.generate "Spain"
+        r.generate
+        r.generate "Finland"
+        r.generate
+        r.generate "Spain"
+      }
+      subject { r.generators }
+      it { should_not be_empty }
+      specify { subject.keys.should include("Spain", "Finland") } 
+    end
+  end # generators
+  
+  describe :clear do
+    it_behaves_like "clear or reset"
+  end
+  
+  describe :reset do
+    it_behaves_like "clear or reset"
+  end
+  
+  describe :generate do
+    let(:r) { RandomPerson() }
+    context "Before a demographic has been loaded" do
+      subject { r.generate }
+      specify { expect { subject }.to raise_error }
+    end
+    context "When there is a demographic loaded" do
+      before(:all) {
+        r.demographic("Spain").add_Spanish
+      }
+      let(:people) { 
+        people = []
+        1000.times{ people << r.generate }
+        people
+      }
+      context "Given a demographic name" do
+        context "That has been added to demographics" do
+          subject { r.generate "Spain" }
+          it { should_not be_nil }
+          it { should be_a_kind_of RandomPerson::Person }
+          it_behaves_like "a Person"
+          it { should_not satisfy {|person| people.include? person } }
+        end
+        context "That has not been added to demographics" do
+          subject { r.generate "Spurious" }
+          it { should be_nil }
+        end
+      end
+      context "Given a no demographic name" do
+        subject { r.generate }
+        it { should_not be_nil }
+        it { should be_a_kind_of RandomPerson::Person }
+        it_behaves_like "a Person"
+        it { should_not satisfy {|person| people.include? person } }
+      end
+    end
+    context "When there is no demographic loaded" do
+      context "Given a demographic name" do
+        subject { r.generate "Spain" }
+      end
+    end
+  end
+    
+  
+  describe :demographics do
+    let(:r) { RandomPerson() }
+    context "With no demographics loaded" do
+      subject { r.demographics }
+      it { should be_empty }
+      it { should be_a_kind_of Hash }
+    end
+    context "Given a demographic" do
+      context "With a name" do
+        before(:all) {
+          r.demographic("Spain").add_Spanish
+        }
+        subject { r.demographics }
+        it { should_not be_empty }
+        it { should be_a_kind_of Hash }
+        specify { subject.first.should be_a_kind_of Array }
+        specify { subject.first.first.should be_a_kind_of String }
+        specify { subject.first.last.should be_a_kind_of RandomPerson::Demographic }
+      end
+      context "Without a name" do
+        before(:all) {
+          r.demographic.add_Spanish
+        }
+        subject { r.demographics }
+        it { should_not be_empty }
+        it { should be_a_kind_of Hash }
+        specify { subject.first.should be_a_kind_of Array }
+        specify { subject.first.first.should be_a_kind_of String }
+        specify { subject.first.last.should be_a_kind_of RandomPerson::Demographic }
+      end
+      
+      context "With options" do
+        context "With a named demographic" do
+          let(:lower){ rand(99) }
+          let(:upper){ rand(100 - lower) + lower }
+          let(:females) { rand(10) } 
+          let(:males) { rand(10) }
+          before(:all) {
+            r.demographic("Random!", gender_ratio: [females,males] , age_lower: lower, age_upper: upper ).add_Spanish
+          }
+          subject { r.demographics }
+          it { should_not be_empty }
+          it { should be_a_kind_of Hash }
+          specify { subject.first.should be_a_kind_of Array }
+          specify { subject.first.first.should be_a_kind_of String }
+          specify { subject.first.last.should be_a_kind_of RandomPerson::Demographic }
+          specify { subject.first.last.age_lower.should == lower }
+          specify { subject.first.last.age_upper.should == upper }
+          specify { subject.first.last.gender_ratio.should == [females,males] }
+        end
+        context "Without a named demographic" do
+          let(:lower){ rand(99) }
+          let(:upper){ rand(100 - lower) + lower }
+          let(:females) { rand(10) } 
+          let(:males) { rand(10) }
+          before(:all) {
+            r.demographic(gender_ratio: [females,males] , age_lower: lower, age_upper: upper ).add_Spanish
+          }
+          subject { r.demographics }
+          it { should_not be_empty }
+          it { should be_a_kind_of Hash }
+          specify { subject.first.should be_a_kind_of Array }
+          specify { subject.first.first.should be_a_kind_of String }
+          specify { subject.first.last.should be_a_kind_of RandomPerson::Demographic }
+          specify { subject.first.last.age_lower.should == lower }
+          specify { subject.first.last.age_upper.should == upper }
+          specify { subject.first.last.gender_ratio.should == [females,males] }
+        end
+      end
+    end
+  end
+    
+    
+end

data/spec/rspec_helper.rb

@@ -0,0 +1,22 @@
+# encoding: UTF-8
+
+require "rspec"
+require 'simplecov'
+#require_relative "./support/helpers.rb"
+
+SimpleCov.start
+
+RSpec.configure do |c|
+#  c.include RandomPerson::Spec::Helpers
+#  c.treat_symbols_as_metadata_keys_with_true_values = true
+end
+
+spec_dir = File.expand_path( File.dirname __FILE__ )
+Dir[ File.join( spec_dir, "/support/**/*.rb")].each {|f| require f}
+
+require "logger"
+lg = Logger.new STDOUT
+lg.level = Logger::DEBUG
+Lg = lg
+
+

data/spec/support/helpers.rb

@@ -0,0 +1,13 @@
+# encoding: UTF-8
+
+module RandomPerson
+  module Spec
+
+    module Helpers
+
+      def all_kind_of?( collection, kind )
+        collection.all? {|c| c.kind_of? kind }
+      end
+    end # Helpers
+  end # Spec
+end # RandomPerson

data/spec/support/matchers/all.rb

@@ -0,0 +1,14 @@
+# encoding: UTF-8
+
+require "rspec/expectations"
+
+RSpec::Matchers.define :all_be_a_kind_of do |kind|
+  match do |actual|
+    all_kind_of? actual, kind
+  end
+
+  def all_kind_of?( collection, kind )
+    collection.all? {|c| c.kind_of? kind }
+  end
+
+end

data/spec/support/matchers/be_in.rb

@@ -0,0 +1,9 @@
+# encoding: UTF-8
+
+require "rspec/expectations"
+
+RSpec::Matchers.define :be_in do |collection|
+  match do |actual|
+    collection.include? actual
+  end
+end

data/spec/support/shared_examples/names.rb

@@ -0,0 +1,59 @@
+# encoding: UTF-8
+
+dir = File.dirname(__FILE__)
+spec_dir = File.expand_path( File.join dir, "../../" )
+
+require_relative File.expand_path( File.join spec_dir, "../lib/randomperson/person.rb" )
+
+shared_examples "it cares about gender and/or age" do |opts={}|
+  opts.each{|k,v| opts[k] = { gender: "m", times: 5, age: rand(83)+17,  }.merge( v ) }
+
+  opts.each_pair do |k,v|
+    context "Given a #{k.to_s.gsub("_", " ")}" do
+      it_should_behave_like "a name generator" , opts[k]
+    end
+  end
+end
+
+shared_examples "a name generator" do |opts={}|
+  opts = {times: 1000,  gender: "f", age: rand(100),}.merge( opts )
+  opts[:rgx] = /^\p{Upper}\p{Alpha}+$/x if opts[:in].nil? && opts[:rgx].nil? 
+  describe :execute do
+    subject { instance.execute RandomPerson::Person.new( gender: opts[:gender], age: opts[:age] ) }
+    it { should_not be_nil }
+
+    opts[:times].times do |_|
+      opts[:rgx].nil? ?  nil : it { should match opts[:rgx]  }
+      opts[:in].nil? ? nil : it { should be_in opts[:in] }
+    end
+  end # execute
+end
+
+
+shared_examples "a Name class", :parent => "Name" do
+
+  describe "Generally" do
+    subject { instance }
+    it { should_not be_nil }
+    it { should respond_to( :execute ) }
+    it { should respond_to(:formats ) }
+    it { should respond_to( :formats_ratiod ) }
+    it { should respond_to(:names)} 
+    it { should respond_to(:possibles)}
+    specify { subject.qualified_const_get( "Names" ).should_not be_empty }
+  end
+
+
+  describe :formats_ratiod do
+    subject { instance.formats_ratiod }
+    it { should be_a_kind_of Array }
+    it { should all_be_a_kind_of Range }
+    specify { (0..99).all?{|i| subject.index_in_range( i ).kind_of? Fixnum }.should be_true } # this should make sure that format ratios are specified properly
+  end
+
+  describe :names do
+    subject { instance.names }
+    it { should be_a_kind_of Array }
+    it { should all_be_a_kind_of String }
+  end
+end

data/test/benchmarks/concat_or_add.rb

@@ -0,0 +1,30 @@
+require "benchmark"
+require_relative "../lib/randomperson/Names/SpanishLast.rb"
+
+S = RandomPerson::Names::SpanishLast.new
+
+Benchmark.bm do |b|
+  b.report( "+  " ) do
+    a = ""
+    1_000_000.times { 
+      S.names.rand + 
+      ' ' +
+      S.names.rand  
+    }
+  end
+    
+  b.report( '#{}' ) do
+    a = ""
+    1_000_000.times { 
+      "#{S.names.rand} #{S.names.rand}"
+    }
+  end
+
+# this was just too slow    
+#  b.report( "concat " ) do
+#    a = ""
+#    1_000_000.times { 
+#      S.names.rand.concat(' ').concat( S.names.rand )
+#    }
+#  end
+end

data/test/benchmarks/my_assoc_or_select.rb

@@ -0,0 +1,60 @@
+require "benchmark"
+
+class Hash
+  def by_index( n )
+    self.each_with_index { |item, index| break item if index == n }
+  end
+end
+
+class Array
+  def index_in_range( n )
+    self.each_with_index do |x, i|
+      return i if x === n
+    end
+    return nil
+  end
+end
+
+Times = 1000_000
+Formats_ratiod = [ 0..23, 24..55, 56..74, 75..90, 91..96, 97..99 ]
+Formats = Formats_ratiod.map{|x| x.to_s}
+
+Current = Hash[ (1..Formats_ratiod.length).map{|x| x.to_s.to_sym}.zip Formats ]
+
+Ranges = Hash[ Formats_ratiod.zip Formats ]
+
+r = []
+max = Formats_ratiod.last.end + 1
+Times.times {|_| r << rand( max ) }
+
+R = r
+r = nil
+
+def current( r )
+  i = Formats_ratiod.index_in_range( r )
+  f = Current.by_index(i).last
+end
+
+def array_contender( r )
+  i = Formats_ratiod.index_in_range( r )
+  f = Formats[i]
+end
+
+def hash_with_ranges_contender( r )
+  f = Ranges.each_pair{|k,v| break v if k === r } 
+end
+
+
+Benchmark.bmbm do |b|  
+  b.report( 'a ' ) do
+    Times.times {|i| array_contender R[i] }
+  end
+  
+  b.report( 'h ' ) do
+    Times.times {|i| array_contender R[i] }
+  end
+  
+  b.report( "c " ) do
+    Times.times {|i| current R[i] }
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: randomperson
 version: !ruby/object:Gem::Version
-  version: 0.0.19
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -50,7 +50,8 @@ cert_chain:
   -----END CERTIFICATE-----
 
 '
-date: 2011-06-21 00:00:00.000000000Z
+date: 2011-11-15 00:00:00.000000000 +00:00
+default_executable: 
 dependencies: []
 description: ! '    RandomPerson is a port to Ruby of Perl''s Data::RandomPerson.
   Use it to generate random persons given various parameters, such as country, age
@@ -65,10 +66,11 @@ files:
 - .gitignore
 - CHANGELOG
 - Manifest
-- README
+- README.markdown
 - Rakefile
 - gem-public_cert.pem
 - lib/randomperson.rb
+- lib/randomperson/Loader.rb
 - lib/randomperson/Names/AmericanFemaleFirst.rb
 - lib/randomperson/Names/AmericanLast.rb
 - lib/randomperson/Names/AmericanMaleFirst.rb
@@ -119,7 +121,8 @@ files:
 - lib/randomperson/Names/WelshLast.rb
 - lib/randomperson/Names/WelshMaleFirst.rb
 - lib/randomperson/Names/WelshPrefix.rb
-- lib/randomperson/choice.rb
+- lib/randomperson/Outputter.rb
+- lib/randomperson/demographic.rb
 - lib/randomperson/ext/Array.rb
 - lib/randomperson/ext/Date.rb
 - lib/randomperson/ext/Enumerable.rb
@@ -132,11 +135,24 @@ files:
 - lib/randomperson/ratio.rb
 - lib/randomperson/version.rb
 - randomperson.gemspec
-- spec/choice_spec.rb
+- spec/AmericanSuffix_spec.rb
+- spec/AnyLast_spec.rb
+- spec/Last_and_First_Names_spec.rb
+- spec/array_spec.rb
+- spec/demographic_spec.rb
 - spec/generator_spec.rb
 - spec/name_spec.rb
+- spec/randomperson_spec.rb
+- spec/rspec_helper.rb
+- spec/support/helpers.rb
+- spec/support/matchers/all.rb
+- spec/support/matchers/be_in.rb
+- spec/support/shared_examples/names.rb
+- test/benchmarks/concat_or_add.rb
+- test/benchmarks/my_assoc_or_select.rb
 - test/test_Choice.rb
 - test/test_Generator.rb
+has_rdoc: true
 homepage: http://github.com/yb66/RandomPerson
 licenses: []
 post_install_message: 
@@ -157,13 +173,25 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.5
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: A gem for generating random persons :)
 test_files:
-- spec/choice_spec.rb
+- spec/AmericanSuffix_spec.rb
+- spec/AnyLast_spec.rb
+- spec/Last_and_First_Names_spec.rb
+- spec/array_spec.rb
+- spec/demographic_spec.rb
 - spec/generator_spec.rb
 - spec/name_spec.rb
+- spec/randomperson_spec.rb
+- spec/rspec_helper.rb
+- spec/support/helpers.rb
+- spec/support/matchers/all.rb
+- spec/support/matchers/be_in.rb
+- spec/support/shared_examples/names.rb
+- test/benchmarks/concat_or_add.rb
+- test/benchmarks/my_assoc_or_select.rb
 - test/test_Choice.rb
 - test/test_Generator.rb

metadata.gz.sig

@@ -1,3 +1,2 @@
-Q�?��p�d�)��ZS�Ĩ|�^r2mF*�%�3���v�q�'#
-n��+dJn�/�Y��攟xurS��j�[t̨��O<��,!4�C��#�(��}�#��n�OٴI��R�L/�_�D�{�����a����s��ee�T��ȑ���)~�ܘ,Ǥ]��$/�b�(�a��mL��|�
-9G$�tm�KxP�8:W��M�9?t~����<�˵��6��qVS'�Q1MH1�ՃN�=˜BFV�/��
+�c�G2e��C�i����w��iX�^X5��EP�q鬿[;G7˻!o�!f�<�cq
c��pb�P�)�9~����q�E<�Kp�w�:�a���fA$=���|?�
+�m�!9�U��mGz�����:�/N�E13�B��ɗȊfѲ_�F	P[������l�I0��73�ӫ�_�[�z�N�����o�,e��t0���`����8����);��40��5Q+eV%iQ����pu���g1�F�U�L$