randomperson 0.0.19 → 1.0.0

data/.gitignore

@@ -14,3 +14,5 @@
 *.zip
 pkg
 rdoc
+*.swp
+coverage/

data/CHANGELOG

@@ -1,3 +1,5 @@
+v1.0.0 Lots of breaking changes to API. Lots more specs, for code and namefiles. Some general cleaning of data too.
+
 v0.0.19 Start of some specs.
 
 v0.0.18 Improved documentation a bit. Changed some filenames to fix a problem with case sensitivity on some systems.

data/Manifest

@@ -1,10 +1,11 @@
 .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
@@ -55,7 +56,8 @@ lib/randomperson/Names/WelshFemaleFirst.rb
 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
@@ -68,5 +70,23 @@ lib/randomperson/person.rb
 lib/randomperson/ratio.rb
 lib/randomperson/version.rb
 randomperson.gemspec
+spec/AmericanPrefix_spec.rb
+spec/AmericanSuffix_spec.rb
+spec/AnyLast_spec.rb
+spec/FinnishPrefix_spec.rb
+spec/Last_and_First_Names_spec.rb
+spec/SpanishPrefix_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

data/README.markdown

@@ -0,0 +1,475 @@
+# RandomPerson
+
+A port to Ruby of Perl's Data::RandomPerson.
+
+http://search.cpan.org/~peterhi/Data-RandomPerson-0.4/
+
+Make sure you're reading the right version of the docs to go with your library! (If you're reading this on Github look for the "Switch Tags" or "Current Branch" -> "Tags" buttons to get the right version.)
+
+## QUICK NOTE!
+
+This was the first Ruby library I wrote. I'm adding specs and improving the code now I've half an idea of what I should be doing, but I'd really, *really* appreciate it that if you do see something is wrong or doesn't work for you or you've an idea for improvement **let me know**. Wow, Github makes this so easy, just go for it! I'll be happy to help and happy for the help.
+
+
+## Why did I write this?
+
+Because the Faker library and a few of the other random ones are excellent, but they don't have the precision I needed. I wanted believable male names between a certain age range for a football game I was writing. Producing names like Mrs Albert Wiggins wasn't really going to cut it.
+
+And I'm a masochist.
+
+It also has unicode characters, so it'll give your database a real test. At least, if it's MySQL, all the other databases won't even notice.
+
+
+## Installation:
+
+You'll need at least Ruby v1.9.1
+
+Get the public key from http://github.com/yb66/RandomPerson/blob/master/gem-public_cert.pem and do:
+
+		gem cert --add /path/to/wherever/you/downloaded/this/to/public_cert.pem
+  
+then install it:
+
+		gem install randomperson -P HighSecurity
+  
+
+## USAGE:
+
+The original API (if you can call it that) was very clunky so I've endeavoured to improve it by adding a nice facade over the top. I'll start off using that but as the examples move along I might do some things "the old fashioned way" by using some of the classes underlying everything directly, just so you know what's going on under there. If you see several ways of doing the same thing don't freak out! You're probably best using the stuff just below here.
+
+So, to generate 1000 random people with Spanish names, between the ages of 16 and 35 with a ratio of 3 males to every 5 females:
+
+		require 'randomperson'
+
+		r = RandomPerson() # don't forget the brackets!
+
+		r.demographic("Spain", gender_ratio: [3,5] , age_lower:16, age_upper:35 ).add_Spanish
+
+		people = [ ]
+		1000.times { people << r.generate }
+
+		10.times { |i| puts "#{people[i].first} #{people[i].last} age: #{people[i].age} born: #{people[i].dob.strftime("%d-%b-%Y")}" }
+
+Output:  
+
+  Bartolomé Andrés de Elixaeberna age: 20 born: 28-Apr-1990  
+  Fabiana Cordero Balmaceda age: 21 born: 14-Jun-1989  
+  Jorge Alas Albarracin age: 29 born: 16-Apr-1981  
+  Eufemia Berlanga de Sergi age: 33 born: 25-Jan-1977  
+  David Puig Villaroel age: 19 born: 17-Apr-1991  
+  Alba Henchoz de Hurtado age: 30 born: 14-Feb-1980  
+  Natalia Jara de Guevara age: 33 born: 28-Jul-1977  
+  Tito Cresaco Campo age: 20 born: 14-Feb-1990  
+  Susana Pitillas de Vaime age: 32 born: 12-Aug-1978  
+  Gustavo Hierro Carbajal y Plazas age: 31 born: 08-Feb-1979  
+
+Here's an example using the Thai Romanised data:
+
+		r.demographic("Thai").add_Thai_Romanised  
+		people = [ ]
+		10.times { people << r.generate( "Thai") }
+		10.times { |i| puts "#{people[i].first} #{people[i].last} age: #{people[i].age} born: #{people[i].dob.strftime("%d-%b-%Y")}" }
+
+Output:  
+ 
+  Yongchaiyuth Sripituksakul Puntasrima age: 39 born: 29-Mar-1971  
+  Sri-Patana Wattanasin age: 77 born: 04-Feb-1933  
+  Wattana Rojjanasukchai age: 7 born: 27-Jun-2003  
+  Ban Sukbunsung age: 85 born: 07-Sep-1925  
+  Daeng Prasongsanti age: 65 born: 27-Mar-1945  
+  Proi Paowsong Sriwarunyu age: 60 born: 06-May-1950  
+  Ban Yongjaiyut age: 4 born: 06-Nov-2006  
+  Siam Narkhirunkanok age: 15 born: 12-Aug-1995  
+  Tong Punyawong Kadesadayurat age: 64 born: 01-Sep-1946  
+  Sarai Wattanapanit Maneerattana age: 44 born: 21-Dec-1966  
+
+## DEMOGRAPHICS
+
+The Demographic class sets the parameters that will be used to generate people.
+
+    r.demographic("My fancy demo")
+
+is the same as
+
+    r.demographic("My fancy demo", gender_ratio: [1,1] , age_lower: 0, age_upper: 115 )
+
+So you'd end up with a population of roughly 50:50 male/female with ages from 0 to 115 years.
+
+If you don't give a demographic name it will be given a number. To see the demographics use:
+
+    r.demographics
+    
+To see a particular one, use its name (it's a hash):
+
+    r.demographics["My fancy demo"]
+    
+## LAST PERSON
+
+    r.demographic("Who was last?").add_English
+    r.person.lastname # generates a new person if none.
+> => "Fletcher"
+
+    r.person.lastname # gets the last person if there was one.
+> => "Fletcher"
+
+    r.generate.lastname # generates a new name every time
+> => "Ford"
+    
+    r.person.lastname
+> => "Ford"
+    
+    r.generate.lastname
+> => "Bradley"
+
+    r.generate.lastname
+> => "King"
+
+    r.person.lastname
+> => "King"
+
+
+    # an undefined demographic will return nil
+    r.person("What?").lastname
+> NoMethodError: undefined method `lastname' for nil:NilClass
+
+    r.person("What?") 
+> => nil
+
+    r.person.lastname # it still remembers the last person.
+> => "King"
+
+    r.person("What?") 
+> => nil
+
+    r.person("Who was last?").lastname
+> => "King"
+
+
+    r.demographic("Not English").add_Thai
+    r.person.lastname # not using Thais yet
+> => "King"
+
+    r.generate.lastname # generate will automatically assume you want to use the last loaded demographic, unless specified otherwise
+> => "Ornlamai Sriwarunyu"
+
+    r.generate("Who was last?").lastname # specify to the demographic to generate using it.
+> => "Bradley-Adams"
+
+    r.person.lastname
+> => "Bradley-Adams"
+    
+    r.generate("Not English").lastname
+> => "Suntornnitikul Parnthong"
+
+    r.person("Who was last?").lastname # this will generate a new name due to the switch between demographics. It's only keeping one lastname, not a lastname for every demographic.
+> => "Jones"
+
+## WHY NAME THE DEMOGRAPHIC?
+
+Because you can mix and match.
+
+
+These will produce the same results (Spanish names), but are named differently.
+
+    r.demographic("Spain").add_Spanish  
+    r.demographics.keys
+> => ["Spain"]
+
+
+    r.demographic.add_Spanish # the name is handled for you.  
+    r.demographics.keys
+> => ["0"]
+
+But, you can play about a bit with the name files. For example:
+
+    r.demographic("Mix n match").add_Spanish  
+    person = r.generate  
+    puts "#{person.prefix if person.prefix} #{person.first} #{person.last} #{person.suffix if person.suffix}  age: #{person.age} born: #{person.dob.strftime("%d-%b-%Y")}"  
+> => Sra. Enriqueta Sedeno Arbizu   age: 53 born: 22-Nov-1958
+
+That is what we expect, but we can change the prefixes to British, the females' first names to be Finnish, and the males' first names to be French, while keeping the Spanish last names, and an American suffix for good measure!
+
+    r.demographic("Mix n match").add_BritishPrefix.add_SpanishLast.add_FinnishFemaleFirst.add_FrenchMaleFirst.add_AmericanSuffix  
+    person = r.generate  
+    puts "#{person.prefix if person.prefix} #{person.first} #{person.last} #{person.suffix if person.suffix}  age: #{person.age} born: #{person.dob.strftime("%d-%b-%Y")}"  
+> => Miss Johanna Sanchez Questi   age: 94 born: 20-May-1917
+
+and the last 2 lines again:
+
+> => Mr Rémy Escriba Sanroma   age: 103 born: 16-Mar-1908
+
+or:
+
+    r.demographic("French Spaniards").add_SpanishLast.add_French_First  
+    person = r.generate # a couple of times and then puts...  
+    
+> => Denise-Juliette Parrado Heras   age: 80 born: 06-Apr-1931  
+> => Gustav Cordona Belsue   age: 20 born: 27-Oct-1991
+
+
+## LOADING NAMEFILES
+
+`r.demographic.add_Spanish_Female` would just load the `SpanishFemaleFirst` class into `r.demographics`.
+  
+`r.demographic.add_Spanish` would load:
+
+  `SpanishFemaleFirst` into `r.demographic["0"].femalefirst`  
+  `SpanishMaleFirst` into `r.demographic["0"].malefirst`  
+  `SpanishLast` into `r.demographic["0"].last`  
+
+etc etc
+  
+or you can do things the old fashioned way (but why? anyway...)
+
+		require 'namefiles/spanishfemalefirst'   
+		#obviously you need to use the path from where you are or where the script will run from
+  
+		r.demographic["My fancy demo"].femalefirst = RandomPerson::Names::SpanishFemaleFirst.new
+
+The rule is, put\_underscores\_between\_the\_important\_words
+
+_and_
+
+always begin with `add_`
+
+_and_
+
+make sure each word is capitalised, `add_male` will actually pick up Fe_male_ whereas `add_Female` and `add_Male` will get what you want.
+
+If you want EnglishLast names loaded:
+
+    r.demographic.add_English_Last
+
+All English files:
+
+    r.demographic.add_English
+
+English males:
+
+    r.demographic.add_English_Male
+
+
+If you need to check what's loaded, have a look in the instance variables of the demographic:
+
+		r.demographics["Mix n match"].malefirst.class.name  
+> => "RandomPerson::Names::SpanishMaleFirst"
+
+    r.demographics["Mix n match"].femalefirst.class.name  
+> => "RandomPerson::Names::SpanishFemaleFirst"
+
+    r.demographics["Mix n match"].last.class.name  
+> => "RandomPerson::Names::SpanishLast"
+
+    r.demographics["Mix n match"].prefix.class.name  
+> => "RandomPerson::Names::SpanishPrefix"
+    
+    r.demographics["Mix n match"].suffix.class.name  
+> => "NilClass"
+    
+  
+## NEGATIONS
+
+Sometimes you'll want to load something but not another, you can do this by prepending _not_ to the things you don't want. For example, to get the Thai names that are in Thai script and not romanised:
+
+		# an already load demographic gets Thai, non romanised
+	  r.demographic["Thai"].male.add_Thai_notRomanised
+  
+or to also get rid of the female names.
+
+		# a new demographic gets non romanised Thai and no female names
+	  r.demographic("Thai").add_Thai_notRomanised_notFemale
+  
+This is an experimental thing. Seems to work, but may change. You cannot do this (at the moment)
+
+	  r.demographic.notRomanised_add_Thai
+  
+**Always** *begin with* `add_`
+
+Here's an example:
+
+    r.demographic("SuperThai").add_Thai_notRomanised  
+    people = [ ]  
+    10.times { people << r.generate( "SuperThai") }  
+    10.times { |i| puts "#{people[i].first} #{people[i].last} age: #{people[i].age} born: #{people[i].dob.strftime("%d-%b-%Y")}" }
+    
+Output:
+    
+> ทักษิณ ชัยภูมิ age: 53 born: 14-May-1958  
+> สุริยา พิษณุโลก age: 47 born: 21-Aug-1964  
+> แก้วเก้า เจริญปุระ age: 61 born: 14-Mar-1950  
+> บัณฑิตา สระบุรี age: 113 born: 06-Nov-1898  
+> วิศิษฏ์ สุโขทัย age: 83 born: 23-Sep-1928  
+> สุประภา โลโซ age: 50 born: 09-Apr-1961  
+> สริตา ตรัง age: 111 born: 27-Jan-1900  
+> ณัฎฐา ลพบุรี age: 86 born: 24-Dec-1925  
+> สุชาย ลพบุรี age: 88 born: 06-Apr-1923  
+> ปราณี สะเมิง age: 85 born: 04-Mar-1926  
+    
+
+## RATIOS VS ODDS
+
+The default gender ratio is 1:1. The male part is the left side (or Array#first), the female is the right side (or Array#last). All ratios are given as an array i.e. [1,1] or [3,2]
+
+A ratio of 1:1 will not necessarily give you a population with exactly half male, half female. The ratio is the odds of getting that. So a ratio of [1,3] will give a 25% chance of producing a male and a 75% chance of being a female.
+
+If you wish to have an exact ratio within the population then create two choices each with a 0% chance of producing the other. For example:
+
+	  r.demographic("Men", gender_ratio:[1,0] )
+	  r.demographic("Women", gender_ratio:[0,1] )
+	  #...more code here...
+	  
+	  25.times { people << r.generate("Men") }
+	  75.times { people << r.generate("Women") }
+
+This would give you a population of 25 males and 75 females. Which sounds great unless you really think about it.
+
+## FORMATTING
+
+Each culture has it's own conventions around names. This makes sticking some monolithic algorithm in the centre of the code to sort out how names should be displayed impossible, so each data file describes how it thinks the names should be formatted.
+
+For example, in the EnglishLast.rb file:
+
+		@formats = [
+		  ->(n)   { n.rand },
+			->(n)   { n.rand + '-' + n.rand },
+		]
+       
+This tells us that there are two ways of formatting last names defined in the file. All formats are described as lambda functions in an array.
+
+## BIT MORE ON RATIOS
+
+Behind the scenes, ratios like this [1,3] are converted to an array of ranges like this `[0..24, 25..99]`, called ratiod. Just so you know for this next bit.
+
+In the EnglishLast.rb file:
+
+    @formats_ratiod = [ 0..96, 97..99 ]
+
+This says that the chances of a name being single barrelled is 97%, and double barrelled with a hypen is 3%. I made up those figures from my own experience, but if you disagree with either the ratios or the formatting then you can change it. Either directly in the file or while running the code. It's your choice. Just make sure the numbers are right, length of arrays should be the same ( e.g. four formatting options should have a ratio with four parts like [a,b,c,d]) or it will break.
+
+## PREFIXES AND SUFFIXES
+
+Each generator starts by producing a person with a gender, an age and a date of birth. These are then passed on to the subsequent name portions so that a male always gets a male name and a male prefix (if you've specified a prefix file).
+
+Suffix files will also (I hope) do a bit of checking at what's already been set, so you won't get Dr. Bobby Horliton PhD, as it should be either Dr. or PhD (apparently). Stuff like that should get caught.
+
+## ADDING YOUR OWN NAMEFILES
+
+My suggestion is to find the type of name that is closest (if you're looking for Spanishy names then look at the Spanish files as they'll have similar formatting rules there for free...) and copy and paste it in to a new one. It's easier that way.
+
+If you do make your own name file then fork this project and send me a pull request! (See the Github help if you don't know how).
+
+These are current name files in the library:
+
+AmericanFemaleFirst  
+AmericanLast  
+AmericanMaleFirst  
+AmericanPrefix  
+AmericanSuffix  
+AncientGreekFemaleFirst  
+AncientGreekLast  
+AncientGreekMaleFirst  
+AnyLast  
+BasqueFemaleFirst  
+BasqueLast  
+BasqueMaleFirst  
+BritishPrefix  
+BritishSuffix  
+EnglishFemaleFirst  
+EnglishLast  
+EnglishMaleFirst  
+EnglishPrefix  
+FinnishFemaleFirst  
+FinnishLast  
+FinnishMaleFirst  
+FinnishPrefix  
+FrenchFemaleFirst  
+FrenchLast  
+FrenchMaleFirst  
+GermanFemaleFirst  
+GermanLast  
+GermanMaleFirst  
+ScottishFemaleFirst  
+ScottishLast  
+ScottishMaleFirst  
+ScottishPrefix  
+SpanishFemaleFirst  
+SpanishLast  
+SpanishMaleFirst  
+SpanishPrefix  
+SwedishFemaleFirst  
+SwedishLast  
+SwedishMaleFirst  
+ThaiFemaleFirst  
+ThaiFirst  
+ThaiLast  
+ThaiMaleFirst  
+ThaiRomanisedFemaleFirst  
+ThaiRomanisedLast  
+ThaiRomanisedMaleFirst  
+WelshFemaleFirst  
+WelshLast  
+WelshMaleFirst  
+WelshPrefix  
+
+
+## ACCURACY OF NAMES AND RATIOS
+
+I've taken bits and pieces from wherever I could get them, so if you see something is wrong then either let me know or produce a patch, just have a look at the help links on Github for how to do it. I'll also add you name to this readme, and worldly fame will be yours.
+
+## TODO:
+
+There's lots to do. Lot of repetition and ugly bits here and there, but it works so I'll get round to it when I can.
+
+## THANKS GO TO
+
+Peter Hickman for writing the original library in Perl that inspired this on in Ruby.
+
+My good friends:
+Johan Bergsten for helping me out with the Swedish names.  
+HALLOJULIA (hayl yeah!) for helping me with the German names.  
+Aino Rissanen for helping me with the Finnish names.  
+Fabiola Fernández Gutiérrez for help with the Spanish prefixes.  
+Aled Coe and Annette Smith for help with Welsh surnames.
+
+Special thanks to my agent, all the people at Marvel and DC for such fine comics, my wife and my mom for supporting me when no one else believed in me, but (sniff) most thanks goes to Noel Edmonds and Jeremy Kyle, for making daytime TV so **creepy** and inane that I rarely waste time watching it.
+
+## THE END UNLESS YOU WANT TO READ THE LICENCE
+
+*Iain Barnett*
+
+## LICENCE:
+
+It's an MIT Licence, I didn't take any code from the Perl one just names and a slight idea on how to structure things, so this ain't gonna be under the GPL. MIT is better anyway ;)
+
+ Copyright (c) 2010 Iain Barnett
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in
+ all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ THE SOFTWARE.
+
+In other words, be good.
+
+
+
+
+
+
+
+
+
+
+

data/lib/randomperson/Loader.rb

@@ -0,0 +1,62 @@
+# encoding: UTF-8
+
+require_relative "./ext/Kernel.rb"
+
+
+module RandomPerson
+  
+  # This module is here to do the loading of data into a demographic class
+  # It relies on there being a self.available_classes method wrapped around a Set
+  module Loader
+  
+
+    module ClassMethods
+      
+      
+      def load_names( opts={} )
+        opts = { patterns: ['*.rb'], lib_dir: File.dirname(__FILE__) }.merge( opts )
+        
+        fulls = opts[:patterns].map do |pattern|
+          full_pattern = File.join( opts[:lib_dir], 'Names', pattern )
+        end
+         Dir.glob( fulls )
+      end
+      
+      
+      def requiring( file_name )
+        require file_name
+        set_of_names = File.basename( file_name, File.extname( file_name ) ) #remove the extension too
+      end
+      
+      def prefix_em( collection, prefix="RandomPerson::Names::" )
+        collection.map{|x| "#{prefix}#{x}"}
+      end
+        
+    
+      
+    end # ClassMethods
+  
+  
+    module InstanceMethods
+    
+      # this adds the classes as constants
+      # The patterns are there to stop other files being added by accident.
+      # and to load the right names into the right instance var
+      def addklass( klass, patterns=[["Male",'First'],["Female", "First"], ['Last'], ['Prefix'], ['Suffix']] )
+      
+        patterns.each do |ps|
+          if ps.all?{|p| klass =~ /#{p}/ }
+            instance_variable_set( "@#{ps.join.downcase}", eval("#{klass}.new") )
+          end # if
+        end
+      end # addklass
+
+    end # InstanceMethods
+  
+    def self.included(receiver)
+      receiver.extend         ClassMethods
+      receiver.send :include, InstanceMethods
+    end
+  end # Loader
+  
+end # RandomPerson

data/lib/randomperson/Names/AmericanFemaleFirst.rb

@@ -1,20 +1,22 @@
+# encoding: UTF-8
+
+require_relative "../name.rb"
+require_relative "../ext/Array.rb"
+
 module RandomPerson
   module Names
 
     class AmericanFemaleFirst < Name
   
       def initialize
-        @formats = {
-          :single =>                      ->(n)   { n.rand },
-         }
-         
+        @names = Names
         @formats_ratiod = [ (0..99) ]
-        setupnames
-      end
+        @formats = [ ->(n){ n.rand } ]
         
-      def setupnames
-        @names = %w{ Mary Patricia Linda Barbara Elizabeth Jennifer Maria Susan Margaret Dorothy Lisa Nancy Karen Betty Helen Sandra Donna Carol Ruth Sharon Michelle Laura Sarah Kimberly Deborah Jessica Shirley Cynthia Angela Melissa Brenda Amy Anna Rebecca Virginia Kathleen Pamela Martha Debra Amanda Stephanie Carolyn Christine Marie Janet Catherine Frances Ann Joyce Diane Alice Julie Heather Teresa Doris Gloria Evelyn Jean Cheryl Mildred Katherine Joan Ashley Judith Rose Janice Kelly Nicole Judy Christina Kathy Theresa Beverly Denise Tammy Irene Jane Lori Rachel Marilyn Andrea Kathryn Louise Sara Anne Jacqueline Wanda Bonnie Julia Ruby Lois Tina Phyllis Norma Paula Diana Annie Lillian Emily Robin Peggy Crystal Gladys Rita Dawn Connie Florence Tracy Edna Tiffany Carmen Rosa Cindy Grace Wendy Victoria Edith Kim Sherry Sylvia Josephine Thelma Shannon Sheila Ethel Ellen Elaine Marjorie Carrie Charlotte Monica Esther Pauline Emma Juanita Anita Rhonda Hazel Amber Eva Debbie April Leslie Clara Lucille Jamie Joanne Eleanor Valerie Danielle Megan Alicia Suzanne Michele Gail Bertha Darlene Veronica Jill Erin Geraldine Lauren Cathy Joann Lorraine Lynn Sally Regina Erica Beatrice Dolores Bernice Audrey Yvonne Annette June Samantha Marion Dana Stacy Ana Renee Ida Vivian Roberta Holly Brittany Melanie Loretta Yolanda Jeanette Laurie Katie Kristen Vanessa Alma Sue Elsie Beth Jeanne Vicki Carla Tara Rosemary Eileen Terri Gertrude Lucy Tonya Ella Stacey Wilma Gina Kristin Jessie Natalie Agnes Vera Willie Charlene Bessie Delores Melinda Pearl Arlene Maureen Colleen Allison Tamara Joy Georgia Constance Lillie Claudia Jackie Marcia Tanya Nellie Minnie Marlene Heidi Glenda Lydia Viola Courtney Marian Stella Caroline Dora Jo Vickie Mattie Terry Maxine Irma Mabel Marsha Myrtle Lena Christy Deanna Patsy Hilda Gwendolyn Jennie Nora Margie Nina Cassandra Leah Penny Kay Priscilla Naomi Carole Brandy Olga Billie Dianne Tracey Leona Jenny Felicia Sonia Miriam Velma Becky Bobbie Violet Kristina Toni Misty Mae Shelly Daisy Ramona Sherri Erika Katrina Claire Lindsey Lindsay Geneva Guadalupe Belinda Margarita Sheryl Cora Faye Ada Natasha Sabrina Isabel Marguerite Hattie Harriet Molly Cecilia Kristi Brandi Blanche Sandy Rosie Joanna Iris Eunice Angie Inez Lynda Madeline Amelia Alberta Genevieve Monique Jodi Janie Maggie Kayla Sonya Jan Lee Kristine Candace Fannie Maryann Opal Alison Yvette Melody Luz Susie Olivia Flora Shelley Kristy Mamie Lula Lola Verna Beulah Antoinette Candice Juana Jeannette Pam Kelli Hannah Whitney Bridget Karla Celia Latoya Patty Shelia Gayle Della Vicky Lynne Sheri Marianne Kara Jacquelyn Erma Blanca Myra Leticia Pat Krista Roxanne Angelica Johnnie Robyn Francis Adrienne Rosalie Alexandra Brooke Bethany Sadie Bernadette Traci Jody Kendra Jasmine Nichole Rachael Chelsea Mable Ernestine Muriel Marcella Elena Krystal Angelina Nadine Kari Estelle Dianna Paulette Lora Mona Doreen Rosemarie Angel Desiree Antonia Hope Ginger Janis Betsy Christie Freda Mercedes Meredith Lynette Teri Cristina Eula Leigh Meghan Sophia Eloise Rochelle Gretchen Cecelia Raquel Henrietta Alyssa Jana Kelley Gwen Kerry Jenna Tricia Laverne Olive Alexis Tasha Silvia Elvira Casey Delia Sophie Kate Patti Lorena Kellie Sonja Lila Lana Darla May Mindy Essie Mandy Lorene Elsa Josefina Jeannie Miranda Dixie Lucia Marta Faith Lela Johanna Shari Camille Tami Shawna Elisa Ebony Melba Ora Nettie Tabitha Ollie Jaime Winifred Kristie Marina Alisha Aimee Rena Myrna Marla Tammie Latasha Bonita Patrice Ronda Sherrie Addie Francine Deloris Stacie Adriana Cheri Shelby Abigail Celeste Jewel Cara Adele Rebekah Lucinda Dorthy Chris Effie Trina Reba Shawn Sallie Aurora Lenora Etta Lottie Kerri Trisha Nikki Estella Francisca Josie Tracie Marissa Karin Brittney Janelle Lourdes Laurel Helene Fern Elva Corinne Kelsey Ina Bettie Elisabeth Aida Caitlin Ingrid Iva Eugenia Christa Goldie Cassie Maude Jenifer Therese Frankie Dena Lorna Janette Latonya Candy Morgan Consuelo Tamika Rosetta Debora Cherie Polly Dina Jewell Fay Jillian Dorothea Nell Trudy Esperanza Patrica Kimberley Shanna Helena Carolina Cleo Stefanie Rosario Ola Janine Mollie Lupe Alisa Lou Maribel Susanne Bette Susana Elise Cecile Isabelle Lesley Jocelyn Paige Joni Rachelle Leola Daphne Alta Ester Petra Graciela Imogene Jolene Keisha Lacey Glenna Gabriela Keri Ursula Lizzie Kirsten Shana Adeline Mayra Jayne Jaclyn Gracie Sondra Carmela Marisa Rosalind Charity Tonia Beatriz Marisol Clarice Jeanine Sheena Angeline Frieda Lily Robbie Shauna Millie Claudette Cathleen Angelia Gabrielle Autumn Katharine Summer Jodie Staci Lea Christi Jimmie Justine Elma Luella Margret Dominique Socorro Rene Martina Margo Mavis Callie Bobbi Maritza Lucile Leanne Jeannine Deana Aileen Lorie Ladonna Willa Manuela Gale Selma Dolly Sybil Abby Lara Dale Ivy Dee Winnie Marcy Luisa Jeri Magdalena Ofelia Meagan Audra Matilda Leila Cornelia Bianca Simone Bettye Randi Virgie Latisha Barbra Georgina Eliza Leann Bridgette Rhoda Haley Adela Nola Bernadine Flossie Ila Greta Ruthie Nelda Minerva Lilly Terrie Letha Hilary Estela Valarie Brianna Rosalyn Earline Catalina Ava Mia Clarissa Lidia Corrine Alexandria Concepcion Tia Sharron Rae Dona Ericka Jami Elnora Chandra Lenore Neva Marylou Melisa Tabatha Serena Avis Allie Sofia Jeanie Odessa Nannie Harriett Loraine Penelope Milagros Emilia Benita Allyson Ashlee Tania Tommie Esmeralda Karina Eve Pearlie Zelma Malinda Noreen Tameka Saundra Hillary Amie Althea Rosalinda Jordan Lilia Alana Gay Clare Alejandra Elinor Michael Lorrie Jerri Darcy Earnestine Carmella Taylor Noemi Marcie Liza Annabelle Louisa Earlene Mallory Carlene Nita Selena Tanisha Katy Julianne John Lakisha Edwina Maricela Margery Kenya Dollie Roxie Roslyn Kathrine Nanette Charmaine Lavonne Ilene Kris Tammi Suzette Corine Kaye Jerry Merle Chrystal Lina Deanne Lilian Juliana Aline Luann Kasey Maryanne Evangeline Colette Melva Lawanda Yesenia Nadia Madge Kathie Eddie Ophelia Valeria Nona Mitzi Mari Georgette Claudine Fran Alissa Roseann Lakeisha Susanna Reva Deidre Chasity Sheree Carly James Elvia Alyce Deirdre Gena Briana Araceli Katelyn Rosanne Wendi Tessa Berta Marva Imelda Marietta Marci Leonor Arline Sasha Madelyn Janna Juliette Deena Aurelia Josefa Augusta Liliana Young Christian Lessie Amalia Savannah Anastasia Vilma Natalia Rosella Lynnette Corina Alfreda Leanna Carey Amparo Coleen Tamra Aisha Wilda Karyn Cherry Queen Maura Mai Evangelina Rosanna Hallie Erna Enid Mariana Lacy Juliet Jacklyn Freida Madeleine Mara Hester Cathryn Lelia Casandra Bridgett Angelita Jannie Dionne Annmarie Katina Beryl Phoebe Millicent Katheryn Diann Carissa Maryellen Liz Lauri Helga Gilda Adrian Rhea Marquita Hollie Tisha Tamera Angelique Francesca Britney Kaitlin Lolita Florine Rowena Reyna Twila Fanny Janell Ines Concetta Bertie Alba Brigitte Alyson Vonda Pansy Elba Noelle Letitia Kitty Deann Brandie Louella Leta Felecia Sharlene Lesa Beverley Robert Isabella Herminia Terra Celina  }
+        super
       end
+        
+      Names = %w{ Mary Patricia Linda Barbara Elizabeth Jennifer Maria Susan Margaret Dorothy Lisa Nancy Karen Betty Helen Sandra Donna Carol Ruth Sharon Michelle Laura Sarah Kimberly Deborah Jessica Shirley Cynthia Angela Melissa Brenda Amy Anna Rebecca Virginia Kathleen Pamela Martha Debra Amanda Stephanie Carolyn Christine Marie Janet Catherine Frances Ann Joyce Diane Alice Julie Heather Teresa Doris Gloria Evelyn Jean Cheryl Mildred Katherine Joan Ashley Judith Rose Janice Kelly Nicole Judy Christina Kathy Theresa Beverly Denise Tammy Irene Jane Lori Rachel Marilyn Andrea Kathryn Louise Sara Anne Jacqueline Wanda Bonnie Julia Ruby Lois Tina Phyllis Norma Paula Diana Annie Lillian Emily Robin Peggy Crystal Gladys Rita Dawn Connie Florence Tracy Edna Tiffany Carmen Rosa Cindy Grace Wendy Victoria Edith Kim Sherry Sylvia Josephine Thelma Shannon Sheila Ethel Ellen Elaine Marjorie Carrie Charlotte Monica Esther Pauline Emma Juanita Anita Rhonda Hazel Amber Eva Debbie April Leslie Clara Lucille Jamie Joanne Eleanor Valerie Danielle Megan Alicia Suzanne Michele Gail Bertha Darlene Veronica Jill Erin Geraldine Lauren Cathy Joann Lorraine Lynn Sally Regina Erica Beatrice Dolores Bernice Audrey Yvonne Annette June Samantha Marion Dana Stacy Ana Renee Ida Vivian Roberta Holly Brittany Melanie Loretta Yolanda Jeanette Laurie Katie Kristen Vanessa Alma Sue Elsie Beth Jeanne Vicki Carla Tara Rosemary Eileen Terri Gertrude Lucy Tonya Ella Stacey Wilma Gina Kristin Jessie Natalie Agnes Vera Willie Charlene Bessie Delores Melinda Pearl Arlene Maureen Colleen Allison Tamara Joy Georgia Constance Lillie Claudia Jackie Marcia Tanya Nellie Minnie Marlene Heidi Glenda Lydia Viola Courtney Marian Stella Caroline Dora Jo Vickie Mattie Terry Maxine Irma Mabel Marsha Myrtle Lena Christy Deanna Patsy Hilda Gwendolyn Jennie Nora Margie Nina Cassandra Leah Penny Kay Priscilla Naomi Carole Brandy Olga Billie Dianne Tracey Leona Jenny Felicia Sonia Miriam Velma Becky Bobbie Violet Kristina Toni Misty Mae Shelly Daisy Ramona Sherri Erika Katrina Claire Lindsey Lindsay Geneva Guadalupe Belinda Margarita Sheryl Cora Faye Ada Natasha Sabrina Isabel Marguerite Hattie Harriet Molly Cecilia Kristi Brandi Blanche Sandy Rosie Joanna Iris Eunice Angie Inez Lynda Madeline Amelia Alberta Genevieve Monique Jodi Janie Maggie Kayla Sonya Jan Lee Kristine Candace Fannie Maryann Opal Alison Yvette Melody Luz Susie Olivia Flora Shelley Kristy Mamie Lula Lola Verna Beulah Antoinette Candice Juana Jeannette Pam Kelli Hannah Whitney Bridget Karla Celia Latoya Patty Shelia Gayle Della Vicky Lynne Sheri Marianne Kara Jacquelyn Erma Blanca Myra Leticia Pat Krista Roxanne Angelica Johnnie Robyn Francis Adrienne Rosalie Alexandra Brooke Bethany Sadie Bernadette Traci Jody Kendra Jasmine Nichole Rachael Chelsea Mable Ernestine Muriel Marcella Elena Krystal Angelina Nadine Kari Estelle Dianna Paulette Lora Mona Doreen Rosemarie Angel Desiree Antonia Hope Ginger Janis Betsy Christie Freda Mercedes Meredith Lynette Teri Cristina Eula Leigh Meghan Sophia Eloise Rochelle Gretchen Cecelia Raquel Henrietta Alyssa Jana Kelley Gwen Kerry Jenna Tricia Laverne Olive Alexis Tasha Silvia Elvira Casey Delia Sophie Kate Patti Lorena Kellie Sonja Lila Lana Darla May Mindy Essie Mandy Lorene Elsa Josefina Jeannie Miranda Dixie Lucia Marta Faith Lela Johanna Shari Camille Tami Shawna Elisa Ebony Melba Ora Nettie Tabitha Ollie Jaime Winifred Kristie Marina Alisha Aimee Rena Myrna Marla Tammie Latasha Bonita Patrice Ronda Sherrie Addie Francine Deloris Stacie Adriana Cheri Shelby Abigail Celeste Jewel Cara Adele Rebekah Lucinda Dorthy Chris Effie Trina Reba Shawn Sallie Aurora Lenora Etta Lottie Kerri Trisha Nikki Estella Francisca Josie Tracie Marissa Karin Brittney Janelle Lourdes Laurel Helene Fern Elva Corinne Kelsey Ina Bettie Elisabeth Aida Caitlin Ingrid Iva Eugenia Christa Goldie Cassie Maude Jenifer Therese Frankie Dena Lorna Janette Latonya Candy Morgan Consuelo Tamika Rosetta Debora Cherie Polly Dina Jewell Fay Jillian Dorothea Nell Trudy Esperanza Patrica Kimberley Shanna Helena Carolina Cleo Stefanie Rosario Ola Janine Mollie Lupe Alisa Lou Maribel Susanne Bette Susana Elise Cecile Isabelle Lesley Jocelyn Paige Joni Rachelle Leola Daphne Alta Ester Petra Graciela Imogene Jolene Keisha Lacey Glenna Gabriela Keri Ursula Lizzie Kirsten Shana Adeline Mayra Jayne Jaclyn Gracie Sondra Carmela Marisa Rosalind Charity Tonia Beatriz Marisol Clarice Jeanine Sheena Angeline Frieda Lily Robbie Shauna Millie Claudette Cathleen Angelia Gabrielle Autumn Katharine Summer Jodie Staci Lea Christi Jimmie Justine Elma Luella Margret Dominique Socorro Rene Martina Margo Mavis Callie Bobbi Maritza Lucile Leanne Jeannine Deana Aileen Lorie Ladonna Willa Manuela Gale Selma Dolly Sybil Abby Lara Dale Ivy Dee Winnie Marcy Luisa Jeri Magdalena Ofelia Meagan Audra Matilda Leila Cornelia Bianca Simone Bettye Randi Virgie Latisha Barbra Georgina Eliza Leann Bridgette Rhoda Haley Adela Nola Bernadine Flossie Ila Greta Ruthie Nelda Minerva Lilly Terrie Letha Hilary Estela Valarie Brianna Rosalyn Earline Catalina Ava Mia Clarissa Lidia Corrine Alexandria Concepcion Tia Sharron Rae Dona Ericka Jami Elnora Chandra Lenore Neva Marylou Melisa Tabatha Serena Avis Allie Sofia Jeanie Odessa Nannie Harriett Loraine Penelope Milagros Emilia Benita Allyson Ashlee Tania Tommie Esmeralda Karina Eve Pearlie Zelma Malinda Noreen Tameka Saundra Hillary Amie Althea Rosalinda Jordan Lilia Alana Gay Clare Alejandra Elinor Michael Lorrie Jerri Darcy Earnestine Carmella Taylor Noemi Marcie Liza Annabelle Louisa Earlene Mallory Carlene Nita Selena Tanisha Katy Julianne John Lakisha Edwina Maricela Margery Kenya Dollie Roxie Roslyn Kathrine Nanette Charmaine Lavonne Ilene Kris Tammi Suzette Corine Kaye Jerry Merle Chrystal Lina Deanne Lilian Juliana Aline Luann Kasey Maryanne Evangeline Colette Melva Lawanda Yesenia Nadia Madge Kathie Eddie Ophelia Valeria Nona Mitzi Mari Georgette Claudine Fran Alissa Roseann Lakeisha Susanna Reva Deidre Chasity Sheree Carly James Elvia Alyce Deirdre Gena Briana Araceli Katelyn Rosanne Wendi Tessa Berta Marva Imelda Marietta Marci Leonor Arline Sasha Madelyn Janna Juliette Deena Aurelia Josefa Augusta Liliana Young Christian Lessie Amalia Savannah Anastasia Vilma Natalia Rosella Lynnette Corina Alfreda Leanna Carey Amparo Coleen Tamra Aisha Wilda Karyn Cherry Queen Maura Mai Evangelina Rosanna Hallie Erna Enid Mariana Lacy Juliet Jacklyn Freida Madeleine Mara Hester Cathryn Lelia Casandra Bridgett Angelita Jannie Dionne Annmarie Katina Beryl Phoebe Millicent Katheryn Diann Carissa Maryellen Liz Lauri Helga Gilda Adrian Rhea Marquita Hollie Tisha Tamera Angelique Francesca Britney Kaitlin Lolita Florine Rowena Reyna Twila Fanny Janell Ines Concetta Bertie Alba Brigitte Alyson Vonda Pansy Elba Noelle Letitia Kitty Deann Brandie Louella Leta Felecia Sharlene Lesa Beverley Robert Isabella Herminia Terra Celina  }
     end    
   end
 end