faker 0.1.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.1.0 2007-11-22
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Benjamin Curtis
+
+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.

data/Manifest.txt

@@ -0,0 +1,29 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+config/hoe.rb
+config/requirements.rb
+lib/facets/random.rb
+lib/faker.rb
+lib/faker/address.rb
+lib/faker/company.rb
+lib/faker/internet.rb
+lib/faker/name.rb
+lib/faker/phone_number.rb
+lib/faker/version.rb
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+test/test_faker.rb
+test/test_helper.rb
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.rhtml

data/README.txt

@@ -0,0 +1,8 @@
+= Faker
+
+A port of Perl's Data::Faker library that generates fake data.
+
+== Usage
+* Faker::Name.name => "Christophe Bartell"
+
+* Faker::Internet.email => "kirsten.greenholt@corkeryfisher.info"

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/config/hoe.rb

@@ -0,0 +1,71 @@
+require 'faker/version'
+
+AUTHOR = 'Benjamin Curtis'  # can also be an array of Authors
+EMAIL = "benjamin.curtis@gmail.com"
+DESCRIPTION = "A port of Perl's Data::Faker - Generates fake names, phone numbers, etc."
+GEM_NAME = 'faker' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'faker' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "unknown"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Faker::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'faker documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+hoe.rsync_args = '-av --delete --ignore-errors'

data/config/requirements.rb

@@ -0,0 +1,17 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'faker'

data/lib/facets/random.rb

@@ -0,0 +1,224 @@
+# TITLE:
+#
+#   Random
+#
+# DESCRIPTION:
+#
+#   Randomization methods.
+#
+# COPYRIGHT:
+#
+#   Copyright (c) 2005 Ilmari Heikkinen, Christian Neukirchen, Thomas Sawyer
+#
+# LICENSE:
+#
+#   Ruby License
+#
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
+#
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
+#
+# AUTHORS:
+#
+#   - Ilmari Heikkinen <mailto:kig@misfiring.net>
+#   - Christian Neukirchen <mailto:chneukirchen@gmail.com>
+#   - Thomas Sawyer
+
+# Modifications to Kernal, Hash, and String have been removed for Faker
+
+
+class Array
+
+  # Return a random element of the array.
+  #
+  #   [1, 2, 3, 4].at_rand           #=> 2
+  #   [1, 2, 3, 4].at_rand           #=> 4
+  #
+  def at_rand
+    self.at( rand( size ) )
+  end
+
+  # Same as #at_rand, but acts in place removing a
+  # random element from the array.
+  #
+  #   a = [1,2,3,4]
+  #   a.at_rand!       #=> 2
+  #   a                #=> [1,3,4]
+  #
+  def at_rand!
+    return delete_at( Kernel.rand( size ) )
+  end
+
+  # Similar to #at_rand, but will return an array of randomly
+  # picked exclusive elements if given a number.
+  def pick(n=nil)
+    if n
+      a = self.dup
+      a.pick!(n)
+    else
+      at( Kernel.rand( size ) )
+    end
+  end
+
+  # Similar to #at_rand!, but given a number will return
+  # an array of exclusive elements.
+  def pick!(n=nil)
+    if n
+      if n > self.size
+        r = self.dup
+        self.replace([])
+        r
+      else
+        r = []
+        n.times { r << delete_at( Kernel.rand( size ) ) }
+        r
+      end
+    else
+      delete_at( Kernel.rand( size ) )
+    end
+  end
+
+  # Random index.
+  #
+  def rand_index
+    rand( size )
+  end
+
+  # Returns a random subset of an Array. If a _number_
+  # of elements is specified then returns that number of
+  # elements, otherwise returns a random number of elements
+  # upto the size of the Array.
+  #
+  # By defualt the returned values are exclusive of
+  # each other, but if _exclusive_ is set to <tt>false</tt>,
+  # the same values can be choosen more than once.
+  #
+  # When _exclusive_ is <tt>true</tt> (the default) and the
+  # _number_ given is greater than the size of the array,
+  # then all values are returned.
+  #
+  #   [1, 2, 3, 4].rand_subset(1)        #=> [2]
+  #   [1, 2, 3, 4].rand_subset(4)        #=> [2, 1, 3, 4]
+  #   [1, 2, 3, 4].rand_subset           #=> [1, 3, 4]
+  #   [1, 2, 3, 4].rand_subset           #=> [2, 3]
+  #
+  def rand_subset( number=nil, exclusive=true )
+    number = rand( size ) unless number
+    number = number.to_int
+    #return self.dup if (number >= size and exlusive)
+    return sort_by{rand}.slice(0,number) if exclusive
+    ri =[]; number.times { |n| ri << rand( size ) }
+    return values_at(*ri)
+  end
+
+  # Randomize the order of an array.
+  #
+  #   [1,2,3,4].shuffle  #=> [2,4,1,3]
+  #
+  def shuffle
+    dup.shuffle!
+    #sort_by{Kernel.rand}
+  end
+
+  # CREDIT Niel Spring
+
+  # As with #shuffle but modifies the array in place.
+  # The algorithm used here is known as a Fisher-Yates shuffle.
+  #
+  #   a = [1,2,3,4]
+  #   a.shuffle!
+  #   a  #=> [2,4,1,3]
+  #
+  def shuffle!
+    s = size
+    each_index do |j|
+      i = Kernel.rand(s-j)
+      #self[j], self[j+i] = self[j+i], self[j]
+      tmp = self[j]
+      self[j] = self[j+i]
+      self[j+i] = tmp
+    end
+    self
+  end
+
+end
+
+
+
+
+
+#  _____         _
+# |_   _|__  ___| |_
+#   | |/ _ \/ __| __|
+#   | |  __/\__ \ |_
+#   |_|\___||___/\__|
+#
+=begin test
+
+  require 'test/unit'
+
+  class TestArrayRandom < Test::Unit::TestCase
+
+    def test_at_rand
+      a = [1,2,3,4,5]
+      20.times{ assert_nothing_raised{ a.at_rand } }
+      20.times{ assert( a.include?( a.at_rand ) ) }
+    end
+
+    def test_at_rand!
+      a = ['a','b','c']
+      assert_equal( 1, a.at_rand!.length )
+      assert_equal( 2, a.length )
+    end
+
+    def test_pick
+      a = ['a','b','c']
+      assert_equal( 3, a.pick(3).length )
+      assert_equal( 3, a.length )
+      a = ['a','b','c']
+      assert_equal( 3, a.pick(4).length )
+      assert_equal( 3, a.length )
+    end
+
+    def test_pick!
+      a = ['a','b','c']
+      assert_equal( 3, a.pick!(3).length )
+      assert_equal( 0, a.length )
+      a = ['a','b','c']
+      assert_equal( 3, a.pick!(4).length )
+      assert_equal( 0, a.length )
+    end
+
+    def test_rand_index
+      10.times {
+        i = [1,2,3].rand_index
+        assert( (0..2).include?(i) )
+      }
+    end
+
+    def test_rand_subset
+      10.times {
+        a = [1,2,3,4].rand_subset
+        assert( a.size <= 4 )
+      }
+    end
+
+    def test_shuffle
+      a = [1,2,3,4,5]
+      b = a.shuffle
+      assert_equal( a, b.sort )
+    end
+
+    def test_shuffle!
+      a = [1,2,3,4,5]
+      b = a.dup
+      b.shuffle!
+      assert_equal( a, b.sort )
+    end
+
+  end
+
+=end

data/lib/faker.rb

@@ -0,0 +1,15 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'faker/address'
+require 'faker/company'
+require 'faker/internet'
+require 'faker/name'
+require 'faker/phone_number'
+
+require 'facets/random'
+
+module Faker
+  def self.numerify(number_string)
+    number_string.gsub(/#/) { rand(10).to_s }
+  end
+end

data/lib/faker/address.rb

@@ -0,0 +1,40 @@
+module Faker
+  class Address
+    class << self
+      def zip_code
+        Faker.numerify(['#####', '#####-####'].at_rand)
+      end
+      
+      def us_state
+        ['Alabama', 'Alaska', 'Arizona', 'Arkansas', 'California', 'Colorado', 'Connecticut', 'Delaware', 'Florida', 'Georgia', 'Hawaii', 'Idaho', 'Illinois', 'Indiana', 'Iowa', 'Kansas', 'Kentucky', 'Louisiana', 'Maine', 'Maryland', 'Massachusetts', 'Michigan', 'Minnesota', 'Mississippi', 'Missouri', 'Montana', 'Nebraska', 'Nevada', 'New Hampshire', 'New Jersey', 'New Mexico', 'New York', 'North Carolina', 'North Dakota', 'Ohio', 'Oklahoma', 'Oregon', 'Pennsylvania', 'Rhode Island', 'South Carolina', 'South Dakota', 'Tennessee', 'Texas', 'Utah', 'Vermont', 'Virginia', 'Washington', 'West Virginia', 'Wisconsin', 'Wyoming'].at_rand
+      end
+      
+      def us_state_abbr
+        %w(AL AK AS AZ AR CA CO CT DE DC FM FL GA GU HI ID IL IN IA KS KY LA ME MH MD MA MI MN MS MO MT NE NV NH NJ NM NY NC ND MP OH OK OR PW PA PR RI SC SD TN TX UT VT VI VA WA WV WI WY AE AA AP).at_rand
+      end
+      
+      def street_suffix
+        %w(Alley Avenue Branch Bridge Brook Brooks Burg Burgs Bypass Camp Canyon Cape Causeway Center Centers Circle Circles Cliff Cliffs Club Common Corner Corners Course Court Courts Cove Coves Creek Crescent Crest Crossing Crossroad Curve Dale Dam Divide Drive Drive Drives Estate Estates Expressway Extension Extensions Fall Falls Ferry Field Fields Flat Flats Ford Fords Forest Forge Forges Fork Forks Fort Freeway Garden Gardens Gateway Glen Glens Green Greens Grove Groves Harbor Harbors Haven Heights Highway Hill Hills Hollow Inlet Inlet Island Island Islands Islands Isle Isle Junction Junctions Key Keys Knoll Knolls Lake Lakes Land Landing Lane Light Lights Loaf Lock Locks Locks Lodge Lodge Loop Mall Manor Manors Meadow Meadows Mews Mill Mills Mission Mission Motorway Mount Mountain Mountain Mountains Mountains Neck Orchard Oval Overpass Park Parks Parkway Parkways Pass Passage Path Pike Pine Pines Place Plain Plains Plains Plaza Plaza Point Points Port Port Ports Ports Prairie Prairie Radial Ramp Ranch Rapid Rapids Rest Ridge Ridges River Road Road Roads Roads Route Row Rue Run Shoal Shoals Shore Shores Skyway Spring Springs Springs Spur Spurs Square Square Squares Squares Station Station Stravenue Stravenue Stream Stream Street Street Streets Summit Summit Terrace Throughway Trace Track Trafficway Trail Trail Tunnel Tunnel Turnpike Turnpike Underpass Union Unions Valley Valleys Via Viaduct View Views Village Village  Villages Ville Vista Vista Walk Walks Wall Way Ways Well Wells).at_rand
+      end
+    
+      def street_name
+        [ 
+          Proc.new { [Name.last_name, street_suffix].join(' ') },
+          Proc.new { [Name.first_name, street_suffix].join(' ') }      
+        ].at_rand.call
+      end
+      
+      def street_address
+        Faker.numerify([
+          Proc.new { '##### %s' % street_name },
+          Proc.new { '##### %s' % street_name },
+          Proc.new { '##### %s' % street_name },
+          Proc.new { '##### %s' % street_name },
+          Proc.new { '##### %s Apt. ###' % street_name },
+          Proc.new { '##### %s Suite ###' % street_name }
+        ].at_rand.call)
+      end
+      
+    end
+  end
+end

data/lib/faker/company.rb

@@ -0,0 +1,19 @@
+module Faker
+  class Company
+    class << self
+      def name
+        Formats.at_rand.call
+      end
+    
+      def suffix
+        %w(Inc and\ Sons LLC Group).at_rand
+      end
+    end
+    
+    Formats = [
+      Proc.new { [ Name.last_name, suffix ].join(' ') },
+      Proc.new { [ Name.last_name, Name.last_name ].join('-') },
+      Proc.new { "%s, %s and %s" % [ Name.last_name, Name.last_name, Name.last_name ] }
+      ]
+  end
+end