faker 1.2.0 → 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3d19e0ae93b8e3a78433a69f98761d341068c3b4
+  data.tar.gz: 36db9a564fafae8bc5a93470dbe2204f5fdc63ea
+SHA512:
+  metadata.gz: a3e8c0b6aaed5907213c3632fecc7c34d72fb4c38c4c28d67e11c1f2af5c9d205ffd91460ee03b7d8b17b55946394ba4a83b6a219ebdf49251c84608879abcaf
+  data.tar.gz: b27e7a2d35c183f968a313de2667850e75aff6f849f6846d48f892767b800a7dc788beceb2e462b3295dcccecf52d400342f75bcadb70429a49b46330ded0a1b

data/History.txt

@@ -1,3 +1,6 @@
+== 1.3.0 2014-03-08
+* Many enhancements and few bugfixes
+
 == 1.2.0 2013-07-27
 * Many major and minor enhancements :)
 

data/README.md

@@ -11,10 +11,10 @@ development.
 Installing
 ----------
 ```bash
-sudo gem install faker
+gem install faker
 ```
 
-Usage
+##Usage
 -----
 ```ruby
 Faker::Name.name      #=> "Christophe Bartell"
@@ -22,6 +22,283 @@ Faker::Name.name      #=> "Christophe Bartell"
 Faker::Internet.email #=> "kirsten.greenholt@corkeryfisher.info"
 ```
 
+###Faker::Address
+-----------------
+
+```ruby
+Faker::Address.city #=> "Imogeneborough"
+
+Faker::Address.street_name #=> "Larkin Fork"
+
+Faker::Address.street_address #=> "282 Kevin Brook"
+
+Faker::Address.secondary_address #=> "Apt. 672"
+
+Faker::Address.building_number #=> "7304"
+
+Faker::Address.zip_code #=> "58517"
+
+Faker::Address.zip #=> "58517"
+
+Faker::Address.postcode #=> "58517"
+
+Faker::Address.time_zone #=> "Asia/Yakutsk"
+
+Faker::Address.street_suffix #=> "Street"
+
+Faker::Address.city_suffix #=> "fort"
+
+Faker::Address.city_prefix #=> "Lake"
+
+Faker::Address.state_abbr #=> "AP"
+
+Faker::Address.state #=> "California"
+
+Faker::Address.country #=> "French Guiana"
+
+Faker::Address.latitude #=> "-58.17256227443719"
+
+Faker::Address.longitude #=> "-156.65548382095133"
+
+
+```
+
+###Faker::Bitcoin
+-----------------
+
+```ruby
+
+Faker::Bitcoin.address #=> "1HUoGjmgChmnxxYhz87YytV4gVjfPaExmh"
+
+```
+
+###Faker::Business
+------------------
+
+```ruby
+
+Faker::Business.credit_card_number #=> "1228-1221-1221-1431"
+
+Faker::Business.credit_card_expiry_date #=> <Date: 2015-11-11 ((2457338j,0s,0n),+0s,2299161j)>
+
+Faker::Business.credit_card_type #=> "visa"
+
+```
+
+###Faker::Code
+--------------
+
+```ruby
+
+Faker::Code.isbn #=> "759021701-8"
+
+```
+
+###Faker::Commerce
+------------------
+
+```ruby
+
+Faker::Commerce.color #=> "lavender"
+
+Faker::Commerce.department #=> "Grocery, Health & Beauty"
+
+Faker::Commerce.product_name #=> "Practical Granite Shirt"
+
+```
+
+###Faker::Company
+-----------------
+
+```ruby
+
+Faker::Company.name #=> "Hirthe-Ritchie"
+
+Faker::Company.suffix #=> "Group"
+
+# Generate a buzzword-laden catch phrase.
+Faker::Company.catch_phrase #=> "Business-focused coherent parallelism"
+
+# When a straight answer won't do, BS to the rescue!
+Faker::Company.bs #=> "empower one-to-one web-readiness"
+
+Faker::Company.duns_number #=> "08-341-3736"
+
+```
+
+
+###Faker::Internet
+---------------
+
+```ruby
+# Optional argument name=nil
+Faker::Internet.email #=> "eliza@mann.net"
+
+Faker::Internet.email('Nancy') #=> "nancy@terry.biz"
+
+# Optional argument name=nil
+Faker::Internet.free_email #=> "freddy@gmail.com"
+
+Faker::Internet.free_email('Nancy') #=> "nancy@yahoo.com"
+
+# Optional argument name=nil
+Faker::Internet.safe_email #=> "christelle@example.org"
+
+Faker::Internet.safe_email('Nancy') #=> "nancy@example.net"
+
+# Optional arguments specifier=nil, separators=%w(. _)
+Faker::Internet.user_name #=> "alexie"
+
+Faker::Internet.user_name('Nancy') #=> "nancy"
+
+Faker::Internet.user_name('Nancy Johnson', %w(. _ -)) #=> "johnson-nancy"
+
+# Optional argument min_length=0
+Faker::Internet.password #=> "doloremquealiquidrerum"
+
+Faker::Internet.password(8) #=> "consecteturadasperiores"
+
+Faker::Internet.domain_name #=> "effertz.info"
+
+Faker::Internet.fix_umlauts('äöüß') #=> "aeoeuess"
+
+Faker::Internet.domain_word #=> "haleyziemann"
+
+Faker::Internet.domain_suffix #=> "info"
+
+Faker::Internet.ip_v4_address #=> "24.29.18.175"
+
+Faker::Internet.ip_v6_address #=> "ac5f:d696:3807:1d72:2eb5:4e81:7d2b:e1df"
+
+# Optional arguments: host=domain_name, path="/#{user_name}"
+Faker::Internet.url #=> "http://thiel.com/chauncey_simonis"
+Faker::Internet.url('example.com') #=> "http://example.com/clotilde.swift"
+Faker::Internet.url('example.com', '/foobar.html') #=> "http://example.com/foobar.html"
+
+# Optional arguments: words=nil, glue=nil
+Faker::Internet.slug #=> "pariatur_laudantium"
+Faker::Internet.slug('foo bar') #=> "foo.bar"
+Faker::Internet.slug('foo bar', '-') #=> "foo-bar"
+
+
+```
+
+###Faker::Lorem
+---------------
+
+```ruby
+
+Faker::Lorem.word #=> "repellendus"
+
+# Optional arguments: num=3, supplemental=false
+Faker::Lorem.words #=> ["dolores", "adipisci", "nesciunt"]
+Faker::Lorem.words(4) #=> ["culpa", "recusandae", "aut", "omnis"]
+Faker::Lorem.words(4, true) #=> ["colloco", "qui", "vergo", "deporto"]
+
+# Optional arguments: char_count=255
+Faker::Lorem.characters #=> "uw1ep04lhs0c4d931n1jmrspprf5wrj85fefue0y7y6m56b6omquh7br7dhqijwlawejpl765nb1716idmp3xnfo85v349pzy2o9rir23y2qhflwr71c1585fnynguiphkjm8p0vktwitcsm16lny7jzp9t4drwav3qmhz4yjq4k04x14gl6p148hulyqioo72tf8nwrxxcclfypz2lc58lsibgfe5w5p0xv95peafjjmm2frkhdc6duoky0aha"
+Faker::Lorem.characters(10) #=> "ang9cbhoa8"
+
+# Optional arguments: word_count=4, supplemental=false, random_words_to_add=6
+Faker::Lorem.sentence #=> "Dolore illum animi et neque accusantium."
+Faker::Lorem.sentence(3) #=> "Commodi qui minus deserunt sed vero quia."
+Faker::Lorem.sentence(3, true) #=> "Inflammatio denego necessitatibus caelestis autus illum."
+Faker::Lorem.sentence(3, false, 4) #=> "Aut voluptatem illum fugit ut sit."
+Faker::Lorem.sentence(3, true, 4) #=> "Accusantium tantillus dolorem timor."
+
+# Optional arguments: sentence_count=3, supplemental=false
+Faker::Lorem.sentences #=> ["Vero earum commodi soluta.", "Quaerat fuga cumque et vero eveniet omnis ut.", "Cumque sit dolor ut est consequuntur."]
+Faker::Lorem.sentences(1) #=> ["Ut perspiciatis explicabo possimus doloribus enim quia."]
+Faker::Lorem.sentences(1, true) #=> ["Quis capillus curo ager veritatis voro et ipsum."]
+
+# Optional arguments: sentence_count=3, supplemental=false, random_sentences_to_add=3
+Faker::Lorem.paragraph #=> "Neque dicta enim quasi. Qui corrupti est quisquam. Facere animi quod aut. Qui nulla consequuntur consectetur sapiente."
+Faker::Lorem.paragraph(2) #=> "Illo qui voluptas. Id sit quaerat enim aut cupiditate voluptates dolorum. Porro necessitatibus numquam dolor quia earum."
+Faker::Lorem.paragraph(2, true) #=> ""
+Faker::Lorem.paragraph(2, false, 4) #=> ""
+Faker::Lorem.paragraph(2, true, 4) #=> ""
+
+# Optional arguments: paragraph_count=3, supplemental=false
+Faker::Lorem.paragraphs #=> ""
+Faker::Lorem.paragraphs(1) #=> ""
+Faker::Lorem.paragraphs(1, true) #=> ""
+
+```
+
+###Faker::Name
+--------------
+
+```ruby
+
+Faker::Name.name #=> "Tyshawn Johns Sr."
+
+Faker::Name.first_name #=> "Kaci"
+
+Faker::Name.last_name #=> "Ernser"
+
+Faker::Name.prefix #=> "Mr."
+
+Faker::Name.suffix #=> "IV"
+
+Faker::Name.title #=> "Legacy Creative Director"
+
+```
+
+###Faker::Number
+----------------
+
+```ruby
+
+# Required parameter: digits
+Faker::Number.number(10) #=> "1968353479"
+
+Faker::Number.digit #=> "1"
+
+```
+
+###Faker::PhoneNumber
+---------------------
+
+Phone numbers may be in any of the following formats:
+
+  * 333-333-3333
+  * (333) 333-3333
+  * 1-333-333-3333
+  * 333.333.3333
+  * 333-333-3333
+  * 333-333-3333 x3333
+  * (333) 333-3333 x3333
+  * 1-333-333-3333 x3333
+  * 333.333.3333 x3333
+
+(Don't let the example output below fool you - any format can be returned at random.)
+
+```ruby
+
+Faker::PhoneNumber.phone_number #=> "397.693.1309"
+
+Faker::PhoneNumber.cell_phone #=> "(186)285-7925"
+
+# NOTE NOTE NOTE NOTE
+# For the 'US only' methods below, first you must do the following:
+Faker::Config.locale = 'en-us'
+
+# US only
+Faker::PhoneNumber.area_code #=> "201"
+
+# US only
+Faker::PhoneNumber.exchange_code #=> "208"
+
+# Optional parameter: length=4
+Faker::PhoneNumber.subscriber_number #=> "3873"
+
+Faker::PhoneNumber.subscriber_number(2) #=> "39"
+
+Faker::PhoneNumber.extension #=> "3764"
+
+```
+
+
 Customization
 ------------
 Since you may want to make addresses and other types of data look different

data/lib/faker.rb

@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 mydir = File.expand_path(File.dirname(__FILE__))
 
 begin
@@ -91,14 +92,18 @@ module Faker
       # into method calls that can be used to generate a
       # formatted translation: e.g., "#{first_name} #{last_name}".
       def parse(key)
-        fetch(key).scan(/#\{([A-Za-z]+\.)?([^\}]+)\}([^#]+)?/).map {|kls, meth, etc|
+        fetch(key).scan(/(\(?)#\{([A-Za-z]+\.)?([^\}]+)\}([^#]+)?/).map {|prefix, kls, meth, etc|
           # If the token had a class Prefix (e.g., Name.first_name)
           # grab the constant, otherwise use self
           cls = kls ? Faker.const_get(kls.chop) : self
 
+          # If an optional leading parentheses is not present, prefix.should == "", otherwise prefix.should == "("
+          # In either case the information will be retained for reconstruction of the string.
+          text = prefix
+
           # If the class has the method, call it, otherwise
           # fetch the transation (i.e., faker.name.first_name)
-          text = cls.respond_to?(meth) ? cls.send(meth) : fetch("#{(kls || self).to_s.split('::').last.downcase}.#{meth.downcase}")
+          text += cls.respond_to?(meth) ? cls.send(meth) : fetch("#{(kls || self).to_s.split('::').last.downcase}.#{meth.downcase}")
 
           # And tack on spaces, commas, etc. left over in the string
           text += etc.to_s
@@ -146,14 +151,18 @@ end
 require 'faker/address'
 require 'faker/code'
 require 'faker/company'
+require 'faker/finance'
 require 'faker/internet'
 require 'faker/lorem'
 require 'faker/name'
+require 'faker/team'
 require 'faker/phone_number'
 require 'faker/business'
 require 'faker/commerce'
 require 'faker/version'
 require 'faker/number'
+require 'faker/bitcoin'
+require 'faker/avatar'
 
 require 'extensions/array'
 require 'extensions/symbol'

data/lib/faker/avatar.rb

@@ -0,0 +1,10 @@
+module Faker
+  class Avatar < Base
+    class << self
+      def image(slug=nil)
+        slug ||= Faker::Lorem.words
+        "http://robohash.org/#{slug}"
+      end
+    end
+  end
+end

data/lib/faker/bitcoin.rb

@@ -0,0 +1,36 @@
+require 'digest'
+
+module Faker
+  class Bitcoin < Base
+    class << self
+
+      def address
+        hash = rand(2**160).to_s(16)
+        version = 0
+        packed = version.chr + [hash].pack("H*")
+        checksum = Digest::SHA2.digest(Digest::SHA2.digest(packed))[0..3]
+        base58(packed + checksum)
+      end
+
+      protected
+
+      def base58(str)
+        alphabet = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
+        base = alphabet.size
+
+        lv = 0
+        str.split('').reverse.each_with_index { |v,i| lv += v.unpack('C')[0] * 256**i }
+
+        ret = ''
+        while lv > 0 do
+          lv, mod = lv.divmod(base)
+          ret << alphabet[mod]
+        end
+
+        npad = str.match(/^#{0.chr}*/)[0].to_s.size
+        '1'*npad + ret.reverse
+      end
+
+    end
+  end
+end

data/lib/faker/commerce.rb

@@ -13,6 +13,11 @@ module Faker
       def product_name
         fetch('commerce.product_name.adjective') + ' ' + fetch('commerce.product_name.material') + ' ' + fetch('commerce.product_name.product')
       end
+
+      def price
+        random = Random.new
+        (random.rand(0..100.0) * 100).floor/100.0
+      end    
     end
   end
 end

data/lib/faker/company.rb

@@ -6,16 +6,16 @@ module Faker
       def name
         parse('company.name')
       end
-    
+
       def suffix
         fetch('company.suffix')
       end
-      
+
       # Generate a buzzword-laden catch phrase.
       def catch_phrase
         translate('faker.company.buzzwords').collect {|list| list.sample }.join(' ')
       end
-      
+
       # When a straight answer won't do, BS to the rescue!
       def bs
         translate('faker.company.bs').collect {|list| list.sample }.join(' ')
@@ -25,6 +25,6 @@ module Faker
         ('%09d' % rand(10 ** 9)).gsub(/(\d\d)(\d\d\d)(\d\d\d\d)/, '\\1-\\2-\\3')
       end
     end
-    
+
   end
 end

data/lib/faker/finance.rb

@@ -0,0 +1,26 @@
+module Faker
+  class Finance < Base
+    CREDIT_CARD_TYPES = [ :visa, :mastercard,  :discover, :american_express, :diners_club, :jcb, :switch, :solo, :dankort, :maestro, :forbrugsforeningen, :laser ]
+
+    class << self
+      def credit_card(*types)
+        types = CREDIT_CARD_TYPES if types.empty?
+        type = types.sample
+        template = numerify(fetch("credit_card.#{type}"))
+
+        # calculate the luhn checksum digit
+        multiplier = 1
+        luhn_sum = template.gsub(/[^0-9]/, '').split('').reverse.map(&:to_i).inject(0) do |sum, digit|
+          multiplier = (multiplier == 2 ? 1 : 2)
+          sum + (digit * multiplier).to_s.split('').map(&:to_i).inject(0) { |digit_sum, cur| digit_sum + cur }
+        end
+        # the sum plus whatever the last digit is must be a multiple of 10. So, the
+        # last digit must be 10 - the last digit of the sum.
+        luhn_digit = (10 - (luhn_sum % 10)) % 10
+
+        template.gsub! 'L', luhn_digit.to_s
+        template
+      end
+    end
+  end
+end