random_data 1.0.0

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 2007-09-17
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Mike Subelsky, subelsky.com
+
+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,30 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+config/hoe.rb
+config/requirements.rb
+lib/random_data.rb
+lib/random_data/array_randomizer.rb
+lib/random_data/contact_info.rb
+lib/random_data/dates.rb
+lib/random_data/locations.rb
+lib/random_data/names.rb
+lib/random_data/text.rb
+lib/random_data/version.rb
+log/debug.log
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+test/test_helper.rb
+test/test_random_data.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,99 @@
+= Random
+
+This plugin defines a Random singleton class that has a bunch of class methods to quickly generate random test for testing and developmental use.
+
+== Installation
+
+<tt>sudo gem install random_data</tt>
+
+== Methods
+
+=== Contact Methods
+Random.phone, Random.international_phone, Random.email
+
+=== Time/Date Methods
+Random.date
+
+=== Location Methods
+Random.address_line_1, Random.address_line_2, Random.zipcode, Random.state, Random.country, Random.city,
+	
+=== Name Methods
+Random.firstname, Random.initial, Random.lastname, 
+
+=== Text Methods
+Random.alphanumeric, Random.paragraphs
+
+Note that some methods take parameters to bound or limit the amount of data returned.  See RDocs for details.
+
+
+== Examples
+
+	>>Random.alphanumeric
+	=> "cfbutm3vYfhZXil0"
+
+	>> Random.alphanumeric(5)
+	=> "XYVyn"
+
+	>> Random.paragraphs
+	=> "Ulysses, fighting evil and tyranny with all his power and with all of his might. Ulysses, fighting evil and tyranny with all his power and with all 
+	of his might. \n\nHe's got style, a groovy style, and a car that just won't stop. \n\n"
+
+	>> Random.paragraphs(3)
+	=> "Excepteur sint occaecat cupidatat non proident  sunt in culpa qui officia deserunt mollit anim id est laborum. Down the road that's where I'll always be. 
+	He's got style, a groovy style, and a car that just won't stop. I've gotten burned over Cheryl Tiegs and blown up for Raquel Welch, but when I end up in the 
+	hay it's only hay  hey hey. Hey there where ya goin, not exactly knowin'. \n\nLorem ipsum dolor sit amet  consectetur adipisicing elit sed do eiusmod tempor 
+	incididunt ut labore et dolore magna aliqua. I might jump an open drawbridge or Tarzan from a vine, beause I'm the unknown stuntman that makes Eastwood look so 
+	fine. He just keeps on movin' and ladies keep improvin'. Rolling  down to Dallas - who is providin my palace?. Every stop I make I make a new friend; Can't 
+	stay for long just turn around and I'm gone again. \n\nAlways fighting all the evil forces bringing peace and justice to all. \n\n"
+
+	>> Random.firstname
+	=> "Thomas"
+
+	>> Random.initial
+	=> "E"
+
+	>> Random.lastname
+	=> "Robinson"
+
+	>> Random.date
+	=> Sun, 09 Sep 2007
+
+	(Returns an actual date object, shown here in its to_s form)
+	
+	>> Random.date(1000)
+	=> Sun, 26 Nov 2006
+
+	>> Random.email
+	=> "zrodriguez@example.com"
+
+	>> Random.phone
+	=> "564-103-8353"
+
+	>> Random.international_phone
+	=> "011-24-37-9704"
+
+	>> Random.address_line_1
+	=> "38367 Adams Rd"
+
+	>> Random.address_line_2
+	=> "Lot 247"
+
+	>> Random.zipcode
+	=> 22904
+
+	(Note that the zipcodes are totally random and may not be real zipcodes)
+
+	>> Random.state
+	=> "MD"
+
+	>> Random.state_full
+	=> "New Mexico"
+
+	>> Random.country
+	=> "Philippines"
+
+== Contact
+Let me know if you have patches, comments, or suggestions: mailto:mike@subelsky.com
+
+== Copyright
+Copyright (c) 2007 {Mike Subelsky}[http://subelsky.com/], Baltimore, Maryland, released under the MIT license

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 'random_data/version'
+
+AUTHOR = 'Mike Subelsky'  # can also be an array of Authors
+EMAIL = "mike@subelsky.com"
+DESCRIPTION = "A Ruby gem that provides a Random singleton class with a series of methods for generating random test data including names, mailing addresses, dates, phone numbers, e-mail addresses, and text."
+GEM_NAME = 'random_data' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'random-data' # 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 = RandomData::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'random_data 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')

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 'random_data'

data/lib/random_data/array_randomizer.rb

@@ -0,0 +1,18 @@
+# Extends the Array class with a function used to randomly choose elements.  Note that if you are using Rails, ActiveSupport recently was updated to include a similar
+# function.  This code checks for the presence of that method and does not try to replace it.  They work the same though so no worries.
+ 
+module ArrayRandomizer
+  
+  # Randomly chooses an element from an array
+  # >> [1,2,3].rand = 3 
+  # [].rand = nil
+
+  def rand
+    return self[Kernel.rand(self.size)]
+  end
+
+end
+
+unless Array.respond_to?(:rand)
+  Array.send :include, ArrayRandomizer
+end

data/lib/random_data/contact_info.rb

@@ -0,0 +1,24 @@
+module RandomData
+  # Methods for randomly generating contact data like phone numbers and e-mail addresses
+  
+  module ContactInfo
+
+   # Returns a randomly-generated string of digits that roughly resembles a US telephone number.  Not guaranteed to be a valid area code.
+   def phone
+     "#{rand(900) + 100}-#{rand(900)+100}-#{rand(10000)+1000}"
+   end
+
+   # Returns a randomly-generated string of digits that roughly resembles an international telephone number as dialed from the US.  
+   # Not guaranteed to be a valid number but just good enough to get some sample data going.
+   
+   def international_phone
+    "011-#{rand(100) + 1}-#{rand(100)+10}-#{rand(10000)+1000}"
+   end
+
+   # Returns an e-mail address of the form "{first_initial}{last_name}@{domain}"
+   def email 
+    domains = %w(yahoo.com gmail.com privacy.net webmail.com msn.com hotmail.com example.com privacy.net)
+    "#{(initial + lastname).downcase}\@#{domains.rand}"  
+   end
+ end
+end

data/lib/random_data/dates.rb

@@ -0,0 +1,21 @@
+require 'date'
+
+module RandomData
+  
+  # Defines methods for random date generation
+  
+  module Dates
+  
+    # Returns a date within a specified range of days (plus or minus half what you specify).  The default is ten days, so by default you will
+    # get a date within plus or minus five days of today.
+    #
+    # Example:
+    #
+    # >> Random.date.to_s = "2007-09-16"
+      
+    def date(dayrange=10)
+      (Date.today + (rand(dayrange*2) - dayrange))
+    end
+
+  end
+end

data/lib/random_data/locations.rb

@@ -0,0 +1,106 @@
+module RandomData
+  
+  # Defines methods to return random location data.
+  
+  module Locations
+
+    @@streetnames = %w( Park Washington Maple Oak Lincoln Walnut Elm Jefferson Highland Madison Pine Cedar Sunset Jackson Franklin Willow 3rd Wilson 2nd Laurel 
+                        5th Chestnut 4th Adams Virginia Linden Woodland Cherry Rose 1st)
+                    
+    @@street_types = %w(St Ave Rd Blvd Trl Ter Rdg Pl Pkwy Ct Circle)
+
+    # Returns the first line of a US maiiling address (street number, street name, street type)
+    #
+    # Example:
+    #
+    #Random.address_line_1 = "24317 Jefferson Blvd"
+    
+    def address_line_1
+      "#{rand(40000)} #{@@streetnames.rand} #{@@street_types.rand}"
+    end
+
+    @@line2types = ["Apt", "Bsmt", "Bldg", "Dept", "Fl", "Frnt", "Hngr", "Lbby", "Lot", "Lowr", "Ofc", "Ph", "Pier", "Rear", "Rm", "Side", "Slip", "Spc", "Stop", "Ste", "Trlr", "Unit", "Uppr"]
+
+    # Returns the first line of a US maiiling address (street number, street name, street type)
+    #
+    # Example:
+    #
+    #Random.address_line_1 = "24317 Jefferson Blvd"
+    
+    def address_line_2
+      "#{@@line2types.rand} #{rand(999)}"    
+    end
+
+    # Returns a random 5-digit string, not guaranteed to be a legitimate zip code.
+    def zipcode
+     rand(89999) + 10000  
+    end
+
+    # from technoweenie: http://svn.techno-weenie.net/projects/plugins/us_states/lib/us_states.rb
+    @@us_states = [["Alaska", "AK"], ["Alabama", "AL"], ["Arkansas", "AR"], ["Arizona", "AZ"], 
+                   ["California", "CA"], ["Colorado", "CO"], ["Connecticut", "CT"], ["District of Columbia", "DC"], 
+                   ["Delaware", "DE"], ["Florida", "FL"], ["Georgia", "GA"], ["Hawaii", "HI"], ["Iowa", "IA"], 
+                   ["Idaho", "ID"], ["Illinois", "IL"], ["Indiana", "IN"], ["Kansas", "KS"], ["Kentucky", "KY"], 
+                   ["Louisiana", "LA"], ["Massachusetts", "MA"], ["Maryland", "MD"], ["Maine", "ME"], ["Michigan", "MI"], 
+                   ["Minnesota", "MN"], ["Missouri", "MO"], ["Mississippi", "MS"], ["Montana", "MT"], ["North Carolina", "NC"], 
+                   ["North Dakota", "ND"], ["Nebraska", "NE"], ["New Hampshire", "NH"], ["New Jersey", "NJ"], 
+                   ["New Mexico", "NM"], ["Nevada", "NV"], ["New York", "NY"], ["Ohio", "OH"], ["Oklahoma", "OK"], 
+                   ["Oregon", "OR"], ["Pennsylvania", "PA"], ["Rhode Island", "RI"], ["South Carolina", "SC"], ["South Dakota", "SD"], 
+                   ["Tennessee", "TN"], ["Texas", "TX"], ["Utah", "UT"], ["Virginia", "VA"], ["Vermont", "VT"], 
+                   ["Washington", "WA"], ["Wisconsin", "WI"], ["West Virginia", "WV"], ["Wyoming", "WY"]]                    
+
+    # Returns a state 2-character abbreviation
+    #Random.state = "IL"
+    
+    def state
+      @@us_states.rand[1]
+    end
+
+    # Returns a full state name
+    #Random.state_full = "Texas"
+
+    def state_full
+      @@us_states.rand[0]   
+    end
+
+    # from http://siteresources.worldbank.org/DATASTATISTICS/Resources/CLASS.XLS
+    @@countries = ["Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", 
+                  "Austria", "Azerbaijan", "Bahamas, The", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", 
+                  "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", 
+                  "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Channel Islands", "Chile", "China", "Colombia", "Comoros", "Congo, Dem. Rep.", 
+                  "Congo, Rep.", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", 
+                  "Egypt, Arab Rep.", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Faeroe Islands", "Fiji", "Finland", "France", "French Polynesia", 
+                  "Gabon", "Gambia, The", "Georgia", "Germany", "Ghana", "Greece", "Greenland", "Grenada", "Guam", "Guatemala", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", 
+                  "Honduras", "Hong Kong, China", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Rep.", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", 
+                  "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea, Dem. Rep.", "Korea, Rep.", "Kuwait", "Kyrgyz Republic", "Lao PDR", "Latvia", "Lebanon", "Lesotho", 
+                  "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao, China", "Macedonia, FYR", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", 
+                  "Marshall Islands", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Fed. Sts.", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", 
+                  "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", 
+                  "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal",
+                  "Puerto Rico", "Qatar", "Romania", "Russian Federation", "Rwanda", "Samoa", "San Marino", "São Tomé and Principe", "Saudi Arabia", "Senegal", "Serbia", 
+                  "Seychelles", "Sierra Leone", "Singapore", "Slovak Republic", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "Spain", "Sri Lanka", "St. Kitts and Nevis", 
+                  "St. Lucia", "St. Vincent and the Grenadines", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syrian Arab Republic", "Tajikistan", "Tanzania", "Thailand", 
+                  "Timor-Leste", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", 
+                  "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela, RB", "Vietnam", "Virgin Islands (U.S.)", "West Bank and Gaza", "Yemen, Rep.", "Zambia", "Zimbabwe"]
+
+    # Returns a country name, as listed by the World Bank
+    #
+    #Random.country = "Kenya"
+    
+    def country
+      @@countries.rand
+    end
+
+    @@cities = %w(Midway Mount\ Pleasant Greenwood Franklin Oak Grove Centerville Salem Georgetown Fairview Riverside Rotorua Tauranga Whakatane Taupo Wanganui 
+                  Nababeep Aggeneys Pofadder Polokwane Bela Bela Goukamma Karatara Tswane Prieska Upington Hoopstad Bultfontein Wesselsbron Bothaville Trompsburg 
+                  Henneman Musina Ogies Kgatlahong Tembisa Tekoza Sebokeng Muntaung Umnkomaaz)
+
+    # Returns a generic city name, with an attempt to have some internationl appeal
+    #
+    # Random.city = "Tekoza"
+     
+    def city
+      @@cities.rand
+    end
+  end
+end

data/lib/random_data/names.rb

@@ -0,0 +1,49 @@
+module RandomData
+
+  # Methods to create realistic-looking names
+  module Names
+    
+    # Returns a random letter
+    
+    def initial
+      
+      choice = rand(26) + 66
+
+      if choice == 91
+        return nil
+      else
+        return choice.chr
+      end
+  
+    end
+
+
+    @@lastnames = %w( SMITH JOHNSON WILLIAMS JONES BROWN DAVIS MILLER WILSON MOORE TAYLOR ANDERSON THOMAS JACKSON WHITE HARRIS MARTIN THOMPSON GARCIA MARTINEZ 
+                      ROBINSON CLARK RODRIGUEZ LEWIS LEE WALKER )
+
+    # Returns a random lastname
+    #
+    # >> Random.lastname
+    #
+    # "Harris"
+
+    def lastname
+      @@lastnames.rand.capitalize
+    end
+
+    @@firstnames = %w(JAMES JOHN ROBERT MICHAEL WILLIAM DAVID RICHARD CHARLES JOSEPH THOMAS CHRISTOPHER DANIEL PAUL MARK DONALD GEORGE KENNETH STEVEN EDWARD BRIAN 
+                      RONALD ANTHONY KEVIN JASON 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)
+
+    # Returns a random firstname
+    #
+    # >> Random.firstname
+    # 
+    # "Sandra"
+
+    def firstname
+      @@firstnames.rand.capitalize
+    end
+
+  end
+end