faux_data 1.0.0

data/lib/faux_data/national_id_generator.rb

@@ -0,0 +1,63 @@
+
+
+module FauxData
+class NationalIdGenerator
+
+    
+    def initialize(opts = {})
+        options = {
+            :country_code => 'us'
+        }.merge(opts)
+        @country_code = options[:country_code]
+        @@consumed_national_ids = Array.new
+    end
+
+
+    def national_id
+        id = ''
+        while (not valid_national_id_us?(id)) 
+            id = generate_national_id_us if @country_code == 'us'
+            #pp id
+        end
+        @@consumed_national_ids << id
+        return id
+    end
+    def national_ids
+        ids = Array.new
+        ids.replace @@consumed_national_ids
+        return ids
+    end
+
+
+    private
+    def generate_national_id_us
+        ssn = "#{rand(1000).to_s.rjust(3,'0')}-#{rand(100).to_s.rjust(2,'0')}-#{rand(10000).to_s.rjust(4,'0')}"
+        return ssn
+    end
+
+    
+    # Test to see if valid SSN using IRS rules on SSN
+    #
+    # SSN can be broken down into Area, Group, and Serial Number as AAA-GG-SSSS
+    #
+    # Area Numbers: excluding area numbers 000, 666 and 900-999.
+    # Group Numbers: SSN randomization will not assign group number 00 
+    # Serial NUmbers: SSN randomization will not assign serial number 0000. 
+    # SSNs containing group number 00 or serial number 0000 will continue to be invalid.
+    #
+    def valid_national_id_us?(ssn)
+        return false if @@consumed_national_ids.include?(ssn)
+        ssn = ssn.delete('-')
+        return false if not ssn =~ /^(\d){9}$/   #test for 9 digits
+        ssn = Hash[* [:area, :group, :serial].zip(ssn.unpack("A3A2A4")).flatten]       
+        return false if ssn[:group] == '00'
+        return false if ssn[:serial] == '0000'
+        return false if ssn[:area] == '000'
+        return false if ssn[:area] == '666'
+        return false if ssn[:area].to_i >= 900 and ssn[:area].to_i <=999
+        return true
+    end
+
+
+end
+end

data/lib/faux_data/person_generator.rb

@@ -0,0 +1,47 @@
+
+
+require File.join(File.dirname(__FILE__),'personal_name_generator')
+require File.join(File.dirname(__FILE__),'address_generator')
+require File.join(File.dirname(__FILE__),'national_id_generator')
+require 'date'
+
+
+
+module FauxData
+class PersonGenerator
+    def initialize
+        @name = PersonalNameGenerator.new
+        @address = AddressGenerator.new
+        @national_id = NationalIdGenerator.new(:county_code => 'us')
+        @max_age_in_days = (365.2524 * 100).to_i
+    end
+
+    def person
+        sex = pick_sex()
+        address = @address.address
+        person = address.merge({
+                :sex => sex,
+                :surname => @name.surname,
+                :first_name => sex == :male ? @name.given_name_male : @name.given_name_female,
+                :middle_name => sex == :male ? @name.given_name_male : @name.given_name_female,
+                :ssn => @national_id.national_id,
+                :date_of_birth => Date.today - (rand(@max_age_in_days))
+        })
+        person[:email] = "#{person[:first_name].strip.downcase}.#{person[:surname].strip.downcase}@" + pick_email_domain()
+        return person
+    end
+
+
+    private
+
+    def pick_sex
+        return [:male, :female].choice
+    end
+
+    def pick_email_domain
+        return %w[ example.com example.net example.org].choice
+    end
+end
+end
+
+

data/lib/faux_data/personal_name_generator.rb

@@ -0,0 +1,56 @@
+
+
+module FauxData
+class PersonalNameGenerator
+
+    def initialize 
+        @surnames = Array.new
+        @given_names_female = Array.new
+        @given_names_male = Array.new
+        @filename_surnames = File.join(File.dirname(__FILE__),'data','us','surnames.txt')
+        @filename_given_names_female = File.join(File.dirname(__FILE__),'data','us','female_given_names.txt')
+        @filename_given_names_male = File.join(File.dirname(__FILE__),'data','us','male_given_names.txt')
+
+    end
+
+    def surname
+        load_surname if @surnames.size < 1
+        return @surnames.choice
+    end
+    def given_name_female
+        load_given_names_female if @given_names_female.size < 1 
+        return @given_names_female.choice
+    end
+    def given_name_male
+        load_given_names_male if @given_names_male.size < 1
+        return @given_names_male.choice
+    end
+
+
+
+
+    private
+    def load_name_file(filename)
+        names = Array.new
+        if File.readable?(filename)
+            File.open(filename,'r') do |file|
+                file.each do |line|
+                    names << line[0,15].strip
+                end
+            end
+        end
+        names << "" if names.size == 0
+        return names
+    end
+    def load_surname
+        @surnames  = load_name_file(@filename_surnames)
+    end
+    def load_given_names_female
+        @given_names_female  = load_name_file(@filename_given_names_female)
+    end
+    def load_given_names_male
+        @given_names_male  = load_name_file(@filename_given_names_male)
+    end
+
+end
+end

data/test/test_national_id_generator.rb

@@ -0,0 +1,34 @@
+
+require 'rubygems'
+require 'test/unit'
+require 'pp'
+
+
+require File.join(File.dirname(__FILE__),'..','lib','faux_data')
+
+class Test_SSN_Creation < Test::Unit::TestCase
+  
+    def setup
+    end
+    def teardown
+    end
+
+    def test_ssn_creation
+        nid = FauxData::NationalIdGenerator.new(:country_code => 'us')
+        id = nid.national_id
+        assert_equal(11,id.to_s.size,"SSN lenth should equal 11 with two (2) hypens and nine (9) digits: ssn [#{id}]")
+        assert_equal(9,id.to_s.delete("-").size,"SSN lenth should have length of 9 chars")
+        assert(id.to_s.delete("-") =~ /^\d{9}$/ ,"SSN lenth should equal nine (9) digits")
+    end
+
+    def test_ssn_tracking
+        nid = FauxData::NationalIdGenerator.new(:country_code => 'us')
+        ids = Array.new
+        (1..100).each do |i|
+            id = nid.national_id
+            ids << id
+        end
+        assert_equal(ids.size, nid.national_ids.size, "Both arrays should contain 100 elements ")
+        assert(ids == nid.national_ids, "Both arrays should contain the same 100 elements ")
+    end
+end

data/test/test_person.rb

@@ -0,0 +1,39 @@
+
+require 'rubygems'
+require 'test/unit'
+require 'pp'
+require 'awesome_print'
+require 'date'
+
+require File.join(File.dirname(__FILE__),'..','lib','faux_data')
+
+class Test_Person_Creation < Test::Unit::TestCase
+  
+    def setup
+    end
+    def teardown
+    end
+
+    def test_person_creation
+        required_keys = %w[ssn surname first_name middle_name street city state zip date_of_birth].map {|i| i.downcase.to_sym}
+        pg = FauxData::PersonGenerator.new
+        person = pg.person
+        assert(person.is_a?(Hash), "Person should be a hash")
+        required_keys.each do |k|
+            assert(person.key?(k), "Should have this key: #{k}")
+        end
+        assert(person[:date_of_birth].is_a?(Date), "Date of Birth should be a date object")
+
+    end
+
+    def test_ssn_tracking
+        pg = FauxData::PersonGenerator.new
+        persons = Array.new
+        (1..100).each do |i|
+            person = pg.person
+            persons << person
+        end
+        assert_equal(100 , persons.size , "Both arrays should contain 100 elements ")
+        ap persons
+    end
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: faux_data
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Chris Stansbury
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-10 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: FauxData was created to quickly generate random employee demographic data which is used for demostrating your application and application's reporting features.  Address data is pulled from US Census records, keeping the US city, US state, and US zip code in sync, while street names are randomly pulled.
+email: Chris@koozie.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- lib/faux_data/address_generator.rb
+- lib/faux_data/data/us/city_state_zipcode.txt
+- lib/faux_data/data/us/female_given_names.txt
+- lib/faux_data/data/us/male_given_names.txt
+- lib/faux_data/data/us/state_list.txt
+- lib/faux_data/data/us/state_list.zip
+- lib/faux_data/data/us/street_names_top_1500.txt
+- lib/faux_data/data/us/surnames.txt
+- lib/faux_data/national_id_generator.rb
+- lib/faux_data/person_generator.rb
+- lib/faux_data/personal_name_generator.rb
+- lib/faux_data.rb
+- test/test_national_id_generator.rb
+- test/test_person.rb
+- README.md
+- LICENSE
+has_rdoc: true
+homepage: https://github.com/koozie/FauxData
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: FauxData is a ruby library that creates faux employee, member or people data
+test_files: []
+