randomperson 0.0.1

data/Manifest

@@ -0,0 +1,31 @@
+Manifest
+README
+Rakefile
+lib/Choice.rb
+lib/Generator.rb
+lib/NameFiles/AmericanLast.rb
+lib/NameFiles/AmericanMaleFirst.rb
+lib/NameFiles/AmericanSuffix.rb
+lib/NameFiles/AnyLast.rb
+lib/NameFiles/BasqueLast.rb
+lib/NameFiles/EnglishFemaleFirst.rb
+lib/NameFiles/EnglishLast.rb
+lib/NameFiles/EnglishPrefix.rb
+lib/NameFiles/SpanishFemaleFirst.rb
+lib/NameFiles/SpanishLast.rb
+lib/NameFiles/SpanishMaleFirst.rb
+lib/NameFiles/ThaiFirst.rb
+lib/NameFiles/ThaiRomanisedFemaleFirst.rb
+lib/NameFiles/ThaiRomanisedLast.rb
+lib/NameFiles/ThaiRomanisedMaleFirst.rb
+lib/Names.rb
+lib/Person.rb
+lib/Ratio.rb
+lib/ext/Array.rb
+lib/ext/Date.rb
+lib/ext/Enumerable.rb
+lib/ext/Hash.rb
+lib/ext/Kernel.rb
+lib/ext/Set.rb
+lib/randomperson.rb
+t/Generator.t

data/README

@@ -0,0 +1,220 @@
+=RandomPerson
+
+A port to Ruby of Perl's Data::RandomPerson.
+
+http://search.cpan.org/~peterhi/Data-RandomPerson-0.4/
+
+Initially just the Names portion. In fact, probably just that. I'm not a masochist. Well, just a bit.
+
+==Why did I write this?
+
+Because the Faker library and a few of the other random ones are very good, 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.
+
+
+==USAGE (STOP SHOUTING!):
+
+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'
+
+  choice = RandomPerson::Choice.new( {gender_ratio: [3,5] , age_lower:16, age_upper:35 } )
+
+  choice.add_Spanish
+  
+  g = RandomPerson::Generator.new
+  
+  g.make_generator choice
+  
+  people = [ ]
+  
+  1000.times { people << g.generators[0].call }
+  
+  10.times { |i| puts "#{people[i].first} #{people[i].last} age: #{people[i].age} born: #{people[i].dob.strftime("%d-%b-%Y")}" }
+
+  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:
+
+  choice = RandomPerson::Choice.new
+  choice.add_Thai_Romanised
+  g = RandomPerson::Generator.new
+  g.make_generator choice 
+  people = [ ]
+  10.times { people << g.generators[0].call }
+  10.times { |i| puts "#{people[i].first} #{people[i].last} age: #{people[i].age} born: #{people[i].dob.strftime("%d-%b-%Y")}" }
+  
+  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
+
+==CHOICE
+
+The choice class sets the parameters that will be used to generate people.
+
+  choice = RandomPerson::Choice.new
+
+is the same as
+
+  choice = RandomPerson::Choice.new( gender_ratio:[1,1] , age_lower: 0, age_upper: 100 )
+
+So you'd end up with a population of roughly 50:50 male/female with ages from 0 to 100 years.
+
+==LOADING NAMEFILES
+
+  choice.add_Spanish_Female would just load the SpanishFemaleFirst into choice.female
+  
+  choice.add_Spanish would load:
+    SpanishFemaleFirst into choice.female
+    SpanishMaleFirst into choice.male
+    SpanishLast into choice.last
+etc etc
+  
+or you can do things the old fashioned way
+
+  require 'namefiles/spanishfemalefirst' #obviously you need to use the path from where you are or where the script will run from
+  
+  choice.female = RandomPerson::SpanishFemaleFirst.new
+
+The rule is, put_underscores_between_the_important_words
+
+_and_
+
+always begin with *add_*
+
+If you want EnglishLast names loaded:
+
+  choice.add_English_Last
+
+All English files:
+
+  choice.add_English
+
+English males:
+
+  choice.add_English_Male
+
+
+Do you see how this is working? If you need to check what's loaded, have a look in the instance variables of choice (or whatever you named your Choice instance):
+
+  choice.male
+  choice.female
+  choice.last
+  choice.prefix
+  choice.suffix
+
+==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:
+
+  men = RandomPerson::Choice.new( gender_ratio:[1,0] )
+  women = RandomPerson::Choice.new( gender_ratio:[0,1] )
+  ...more code here...
+  g.make_generator men # pushes the generator onto @generators in 0 position
+  g.make_generator women # pushes the generator onto @generators in 1 position
+  25.times { people << g.generators[0].call }
+  75.times { people << g.generators[1].call }
+
+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 = {
+          :single =>                      ->(n)   { n.rand },
+          :double_barrelled_hyphenated=> ->(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 a hash, the key being a description of what it's trying to achieve.
+
+==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 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.
+
+==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. I've no idea what the process is for that on GitHub but I'm sure there's a tutorial if you look for 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.
+
+*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/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'echoe'
+# require 'rake/testtask'
+
+Echoe.new('randomperson', '0.0.1') do |p|
+  p.description    = "A gem for generating random persons"
+  p.url            = "http://github.com/yb66/RandomPerson"
+  p.author         = "Iain Barnett"
+  p.email          = "iainspeed @nospam@ gmail.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+  p.runtime_dependencies = []
+  p.ruby_version   = ">= 1.9.1"
+end
+
+# task :default => [:test_units]
+# 
+# desc "Run basic tests"
+# Rake::TestTask.new("test_units") { |t|
+#   t.pattern = 't/*.t'
+#   t.verbose = true
+#   t.warning = true
+# }

data/lib/Choice.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/env ruby -wKU
+
+require 'set'
+module RandomPerson
+
+  class Choice
+    
+    attr_accessor :malefirst, :femalefirst, :last, :gender_ratio, :age_lower, :age_upper, :dob, :prefix, :suffix #,:age_ratio
+    
+    def available_classes
+      @@available_classes
+    end
+    
+    @@available_classes = Set.new
+    
+    def initialize( h={} )
+      @gender_ratio = h[:gender_ratio] || [1,1] #default
+      @age_lower = h[:age_lower] || 0
+      @age_upper = h[:age_upper] || 100
+
+      load_names
+    end
+    
+    def load_names( patterns=['*.rb'] )
+      # puts "patterns: #{patterns}"
+      # available_files = [ ]
+      lib_dir = File.dirname(__FILE__)
+      
+      patterns.each do |pat|
+        full_pattern = File.join( lib_dir, 'NameFiles', pat )
+        puts full_pattern
+        Dir.glob( full_pattern ).each do |file|    
+#           require file
+          @@available_classes << file
+        end
+      end
+    end
+    
+    # tribe, gender, position
+    #English_males
+    def method_missing( name, *args )
+      return super( name, *args ) unless name.to_s =~ /^add/  
+      words = name.to_s.split( "_" )
+      words.shift #get rid of the "add"
+      #TODO: check the beginning of each word has an uc letter
+      cs = words.map { |word| @@available_classes.classify_true(word) }.fold(:&)
+      
+      cs.each do |c|
+        require c
+        fn = File.basename( c, File.extname( c ) ) #remove the extension
+        addklass( fn, %w{ Male First } )
+        addklass( fn, %w{ Female First } )
+        addklass( fn, %w{ Last } )
+        addklass( fn, %w{ Prefix } )
+        addklass( fn, %w{ Suffix } )
+      end
+    end
+    
+    
+    def addklass( fn, ps )
+      if ps.map { |p| fn =~ /#{p}/ }.all?
+        instance_variable_set( "@#{ps.join.downcase}", qualified_const_get(fn).new )
+      end
+    end
+
+    
+#       while n > 0
+#         r = rand(rat.last.last)
+#         puts "n: #{n} r: #{r}"
+#         i = rat.index_in_range( r )
+#         puts "i: #{i}"
+#         
+#         person = @choices[i].call
+#         puts person.inspect
+#         @people << person 
+#         n -= 1
+#       end
+    
+    
+  end
+  
+end

data/lib/Generator.rb

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby -wKU
+
+require 'date'
+require 'person'
+
+module RandomPerson
+
+  class Generator
+  
+    attr_reader :generators
+   
+    def initialize
+      @generators = [ ] 
+    end
+
+    
+    #build a choice generator
+    def make_generator( choice )
+    f = -> {
+        g = Generator.pick_gender( choice.gender_ratio )
+        age = Generator.pick_age( choice.age_lower, choice.age_upper)
+        
+        person = Person.new(
+          :gender =>  g, 
+          :age => age,
+          :dob => Generator.pick_dob( age )
+        )
+        
+        if person.gender == 'm'   
+          person.first = choice.malefirst.execute( person ) unless choice.malefirst.nil?
+        else
+          person.first = choice.femalefirst.execute( person ) unless choice.femalefirst.nil?
+        end
+          
+        person.last = choice.last.execute( person ) unless choice.last.nil?#lastname, 
+        person.prefix = choice.prefix.execute( person ) unless person.prefix.nil? #title 
+        person.suffix = choice.suffix.execute( person ) unless person.suffix.nil?#suffix
+        
+        person
+      }
+      
+      @generators << f
+    end
+    
+    class << self
+    
+      #create a ratio that is made up of ranges
+      #to help hit with multiple valued ratios
+      def ratiod( ratio=[1,1] )
+        sum = ratio.reduce(:+) #sum
+        mult = 100.divmod( sum ).first #get a bigger spread of numbers
+        ratio.map! { |n| n * mult }
+        new_ratio = ratio.inject([0..0]) {|acc,n| acc + [acc.last.last ... (n + acc.last.last)] }
+        new_ratio.shift #get rid of 0..0
+        return new_ratio
+      end 
+      
+      def pick_gender( ratio=[1,1] ) #male first
+        if ratio.length == 2
+          return 'f' if ratio.first == 0
+          return 'm' if ratio.last == 0 
+        end
+        rat = ratiod( ratio )
+        r = rand(rat.last.last)
+        case r
+          when rat[0] then 'm'
+          when rat[1] then 'f'
+        end
+      end
+
+      def pick_age( lower=0, upper=100 )
+        age = rand(upper - lower) + lower
+      end
+      
+      def pick_dob( y=16 )
+        year  = Time.now.year - y
+        month = rand(12) + 1;
+        day   = rand( Date.days_in_month( year, month ) ) + 1 
+        Time.local( year, month, day )
+      end
+      
+    
+    end #class << self
+      
+    
+
+  
+
+    def reset
+      @generator = [ ] 
+    end
+
+
+  
+  end
+
+end

data/lib/NameFiles/AmericanLast.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby -wKU
+
+module RandomPerson
+
+  require 'Names'
+
+  class AmericanLast
+    include Names
+
+    #def names() NAMES; end
+    
+    FORMATS = {
+      :single =>                      ->(n)   { n.rand },
+      :double_barrelled =>            ->(n)   { n.rand + ' ' + n.rand }, 
+      :double_barrelled_hyphenated=> ->(n)   { n.rand + '-' + n.rand },
+     }
+     
+    FORMATS_RATIOD = [ (0..95), (96..97), (98..99) ]
+     
+#      TODO!!!!!!
+#     def execute( person, format=nil, format_ratio=nil )
+#       format = FORMATS[:single] if format.nil?
+#       # puts format.inspect
+#       format.( NAMES )
+#     end
+
+    def execute( person, format=nil )
+      Names.execute( NAMES )
+    end 
+
+    NAMES = %w(adams adamson adler akers akin aleman alexander allen allison allwood anderson andreou anthony appelbaum applegate arbore arenson armold arntzen askew athanas atkinson ausman austin averitt avila badders baer baggerly bailliet baird baker ball ballentine ballew banks baptist barbee barber barchas barcio bardsley barkauskas barnes barnett barnwell barrera barreto barroso barrow bart barton bass bates bavinger baxter bazaldua becker beeghly belforte bellamy bellavance beltran belusar bennett benoit bensley berger berggren bergman berry bertelson bess beusse bickford bierner bird birdwell bixby blackmon blackwell blair blankinship blanton block blomkalns bloomfield blume boeckenhauer bolding bolt bolton book boucher boudreau bowman boyd boyes boyles braby braden bradley brady bragg brandow brantley brauner braunhardt bray bredenberg bremer breyer bricout briggs brittain brockman brockmoller broman brooks brown brubaker bruce brumfield brumley bruning buck budd buhler buhr burleson burns burton bush butterfield byers byon byrd bzostek cabrera caesar caffey caffrey calhoun call callahan campbell cano capri carey carlisle carlson carmichael carnes carr carreira carroll carson carswell carter cartwright cason cates catlett caudle cavallaro cave cazamias chabot chance chapman characklis cheatham chen chern cheville chong christensen church claibourn clark clasen claude close coakley coffey cohen cole collier conant connell conte conway cooley cooper copeland coram corbett cort cortes cousins cowsar cox coyne crain crankshaw craven crawford cressman crestani crier crocker cromwell crouse crowder crowe culpepper cummings cunningham currie cusey cutcher cyprus       d'ascenzo dabak dakoulas daly dana danburg danenhauer darley darrouzet dartt daugherty davila davis dawkins day dehart demoss demuth devincentis deaton dees degenhardt deggeller deigaard delabroy delaney demir denison denney derr dettweiler deuel devitt diamond dickinson dietrich dilbeck dobson dodds dodson doherty dooley dorsey dortch doughty dove dowd dowling drescher drucker dryer dryver duckworth dunbar dunham dunn duston dyson eason eaton ebert eckhoff edelman edmonds eichhorn eisbach elders elias elijah elizabeth elliott elliston elms emerson engelberg engle eplett epp erickson estades etezadi evans ewing fair farfan fargason farhat farry fawcett faye federle felcher feldman ferguson fergusson fernandez ferrer fine fineman fisher flanagan flathmann fleming fletcher folk fortune fossati foster foulston fowler fox francis frantom franz frazer fredericks frey freymann fuentes fuller fundling furlong gainer galang galeazzi gamse gannaway garcia gardner garneau gartler garverick garza gatt gattis gayman geiger gelder george gerbino gerbode gibson gifford gillespie gillingham gilpin gilyot girgis gjertsen glantz glaze glenn glotzbach gobble gockenbach goff goffin golden goldwyn gomez gonzalez good graham gramm granlund grant gray grayson greene greenslade greenwood greer griffin grinstein grisham gross grove guthrie guyton haas hackney haddock hagelstein hagen haggard haines hale haley hall halladay hamill hamilton hammer hancock hane hansen harding harless harms harper harrigan harris harrison hart harton hartz harvey hastings hauenstein haushalter haven hawes hawkins hawley haygood haylock hazard heath heidel heins hellums hendricks henry henson herbert herman hernandez herrera hertzmann hewitt hightower hildebrand hill hindman hirasaki hirsh hochman hocker hoffman hoffmann holder holland holloman holstein holt holzer honeyman hood hooks hopper horne house houston howard howell howley huang hudgings huffman hughes humphrey hunt hunter hurley huston hutchinson hyatt irving jacobs jaramillo jaranson jarboe jarrell jenkins johnson johnston jones joy juette julicher jumper kabir kamberova kamen kamine kampe kane kang kapetanovic kargatis karlin karlsson kasbekar kasper kastensmidt katz kauffman kavanagh kaydos kearsley keleher kelly kelty kendrick key kicinski kiefer kielt kim kimmel kincaid king kinney kipp kirby kirk kirkland kirkpatrick klamczynski klein kopnicky kotsonis koutras kramer kremer krohn kuhlken kunitz lalonde lavalle laware lacy lam lamb lampkin lane langston lanier larsen lassiter latchford lawera leblanc legrand leatherbury lebron ledman lee leinenbach leslie levy lewis lichtenstein lisowski liston litvak llano lloyd lock lodge logan lomonaco long lopez lopez loren loughridge love ludtke luers lukes luxemburg macallister macleod mackey maddox magee mallinson mann manning manthos marie marrow marshall martin martinez martisek massey mathis matt maxwell mayer mazurek mcadams mcafee mcalexander mcbride mccarthy mcclure mccord mccoy mccrary mccrossin mcdonald mcelfresh mcfarland mcgarr mcghee mcgoldrick mcgrath mcguire mckinley mcmahan mcmahon mcmath mcnally mcdonald meade meador mebane medrano melton merchant merwin millam millard miller mills milstead minard miner minkoff minnotte minyard mirza mitchell money monk montgomery monton moore moren moreno morris morse moss moyer mueller mull mullet mullins munn murdock murphey murphy murray murry mutchler myers myrick nassar nathan nazzal neal nederveld nelson nguyen nichols nielsen nockton nolan noonan norbury nordlander norris norvell noyes nugent nunn o'brien o'connell o'neill o'steen ober odegard oliver ollmann olson ongley ordway ortiz ouellette overcash overfelt overley owens page paige pardue parham parker parks patterson patton paul payne peck penisson percer perez perlioni perrino peterman peters pfeiffer phelps philip philippe phillips pickett pippenger pistole platzek player poddar poirier poklepovic polk polking pond popish porter pound pounds powell powers prado preston price prichep priour prischmann pryor puckett raglin ralston rampersad ratner rawles ray read reddy reed reese reeves reichenbach reifel rein reiten reiter reitmeier reynolds rhinehart richardson rider ritchie rittenbach roberts robinson rodriguez rogers roper rosemblun rosen rosenberg rosenblatt ross roth rowatt roy royston rozendal rubble ruhlin rupert russell ruthruff ryan rye sabry sachitano sachs sammartino sands saunders savely scales schaefer schafer scheer schild schlitt schmitz schneider schoenberger schoppe scott seay segura selesnick self seligmann sewall shami shampine sharp shaw shefelbine sheldon sherrill shidle shifley shillingsburg shisler shopbell shupack sievert simpson sims sissman smayling smith snyder solomon solon soltero sommers sonneborn sorensen southworth spear speight spencer spruell spudich stacy staebel steele steinhour steinke stepp stevens stewart stickel stine stivers stobb stone stratmann stubbers stuckey stugart sullivan sultan sumrall sunley sunshine sutton swaim swales sweed swick swift swindell swint symonds syzdek szafranski takimoto talbott talwar tanner taslimi tate tatum taylor tchainikov terk thacker thomas thompson thomson thornton thurman thurow tilley tolle towns trafton tran trevas trevino triggs truchard tunison turner twedell tyler tyree unger van vanderzanden vanlandingham varanasi varela varman venier verspoor vick visinsky voltz wagner wake walcott waldron walker wallace walters walton ward wardle warnes warren washington watson watters webber weidenfeller weien weimer weiner weinger weinheimer weirich welch wells wendt west westmoreland wex whitaker white whitley wiediger wilburn williams williamson willman wilson winger wise wisur witt wong woodbury wooten workman wright wyatt yates yeamans yen york yotov younan young zeldin zettner ziegler zitterkopf zucker)
+  end
+end  

data/lib/NameFiles/AmericanMaleFirst.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby -wKU
+
+module RandomPerson
+
+  require 'Names'
+
+  class AmericanMaleFirst
+    include Names
+
+    def execute( person, format=nil )
+      Names.execute( NAMES )
+    end 
+      
+#     def names( ) NAMES; end
+
+    NAMES = %w{ aaron adam adrian alan alejandro alex allen andrew andy anthony art arthur barry bart ben benjamin bill bobby brad bradley brendan brett brian bruce bryan carlos chad charles chris christopher chuck clay corey craig dan daniel darren dave david dean dennis denny derek don doug duane edward eric eugene evan frank fred gary gene george gordon greg harry henry hunter ivan jack james jamie jason jay jeff jeffrey jeremy jim joe joel john jonathan joseph justin keith ken kevin larry logan marc mark matt matthew michael mike nat nathan patrick paul perry peter philip phillip randy raymond ricardo richard rick rob robert rod roger ross ruben russell ryan sam scot scott sean shaun stephen steve steven stewart stuart ted thomas tim toby todd tom troy victor wade walter wayne william }
+      
+#     FORMATS = {
+#       :single =>                      ->(n)   { n.rand }
+#     }
+    
+
+#       format = FORMATS[:single] if format.nil?
+#       # puts format.inspect
+#       # format.( @NAMES )
+#       NAMES.rand
+#     end
+    
+    
+  end
+end

data/lib/NameFiles/AmericanSuffix.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby -wKU
+
+module RandomPerson
+  require 'Names'
+  class AmericanSuffix
+    include Names
+    
+    
+    SUFFIX = [ 'Jr.', ''] + %w( I II III IV V Sr. )
+    SUFFIX_ratiod = [ 0, 1..93, 94, 95, 96, 97, 98, 99]
+    
+    def execute( person, format=nil)
+        
+        r = rand(99)      
+        if person.age > 17
+          r += 1 #Jr can't happen
+        end
+              
+        i = SUFFIX_ratiod.index_in_range( r )
+        return SUFFIX[i]
+      end
+      
+  end 
+end