faker 1.6.3 → 1.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60e8a82dac923a23a59ecf9c9d5393f47871839a
-  data.tar.gz: b5c3a57051bb7fd13ca97a51a7a687ebe6b5c128
+  metadata.gz: ed2ee70ea2d6aaca6b29368c96662c4719cb8ae1
+  data.tar.gz: c5b4ed33812b75c33da0d94e204cd42aa2d4b347
 SHA512:
-  metadata.gz: 56d14ef1ac946cdab85cadf2c2eb2f38d2477da48fdcd1323d8e1313c34c38861421d7505ba57f01e01e18925cf2fe1648bf2ac438874a5f016ac5fb800275cc
-  data.tar.gz: 61dca68c941316bfa157da3163aea701074e5a1fa200f63a94d5e63551680795d87aa3bab9d3173d6db83c56034253d7177115ab39eea3cfb9241bc2ff0610f6
+  metadata.gz: 3af9b9aec025fb8991e1b0af57105dee42ad6e83e6771b99dee333613235bb5b48cc17428117fe45f968636708bf1f6d3cdf0cd8e9b7b3cb885533da79a3b89b
+  data.tar.gz: d300551f4b629cdf6894710f681af489f871fe2835937a312b74fb1c0d37263a42e44bc8e7eebb63c8e0dd06e059c7b822ef6a712689f39ddd948f220e01cb72

data/History.txt

@@ -1,3 +1,16 @@
+== 1.6.4 2016-07-06
+* Removed support for Ruby 1.9.3
+* Added Faker::ChuckNorris, Faker::Crypto, Faker::Educator, Faker::File, Faker::Music, Faker::Space, Faker::Vehicle, and Faker::Yoda
+* Fixed bug with credit card types
+* DST fixes in Faker::Time
+* Added Faker::Name.name_with_middle
+* Added Faker::Code.imei
+* Added Faker::Code.asin
+* Added Faker::Lorem.question and Faker::Lorem.questions
+* Added Faker::Internet.private_ip_v4_address
+* Added Faker::Company.australian_business_number
+* Other miscellaneous fixes and locale updates
+
 == 1.6.3 2016-02-23
 * Fix for UTF problem in Ruby 1.9.3
 * Fix for Faker::StarWars.character

data/README.md

@@ -1,5 +1,6 @@
-Faker
-=====
+# Faker [![Build Status](https://travis-ci.org/stympy/faker.svg?branch=master)](https://travis-ci.org/stympy/faker) [![Gem Version](https://badge.fury.io/rb/faker.svg)](https://badge.fury.io/rb/faker)
+
+
 This gem is a port of Perl's Data::Faker library that generates fake data.
 
 It comes in very handy for taking screenshots (taking screenshots for my
@@ -15,6 +16,49 @@ development.
   Please refer the README of your version for the available methods.
   List of all versions is [available here](https://github.com/stympy/faker/releases).
 
+Contents
+--------
+
+- [Installing](#installing)
+- [Usage](#usage)
+  - [Faker::Address](#fakeraddress)
+  - [Faker::Bitcoin](#fakerbitcoin)
+  - [Faker::Business](#fakerbusiness)
+  - [Faker::Code](#fakercode)
+  - [Faker::Color](#fakercolor)
+  - [Faker::Commerce](#fakercommerce)
+  - [Faker::Company](#fakercompany)
+  - [Faker::Date](#fakerdate)
+  - [Faker::Internet](#fakerinternet)
+  - [Faker::File](#fakerfile)
+  - [Faker::Lorem](#fakerlorem)
+  - [Faker::Name](#fakername)
+  - [Faker::Number](#fakernumber)
+  - [Faker::Boolean](#fakerboolean)
+  - [Faker::PhoneNumber](#fakerphonenumber)
+  - [Faker::Time](#fakertime)
+  - [Faker::Hacker](#fakerhacker)
+  - [Faker::Crypto](#fakercrypto)
+  - [Faker::App](#fakerapp)
+  - [Faker::SlackEmoji](#fakerslackemoji)
+  - [Faker::Team](#fakerteam)
+  - [Faker::Book](#fakerbook)
+  - [Faker::University](#fakeruniversity)
+  - [Faker::Placeholdit](#fakerplaceholdit)
+  - [Faker::Hipster](#fakerhipster)
+  - [Faker::Superhero](#fakersuperhero)
+  - [Faker::StarWars](#fakerstarwars)
+  - [Faker::Beer](#fakerbeer)
+  - [Faker::ChuckNorris](#fakerchucknorris)
+  - [Faker::Educator](#fakereducator)
+  - [Faker::Space](#fakerspace)
+  - [Faker::Music](#fakermusic)
+  - [Faker::Vehicle](#fakervehicle)
+- [Customization](#customization)
+- [Contributing](#contributing)
+- [Contact](#contact)
+- [License](#license)
+
 Installing
 ----------
 ```bash
@@ -29,7 +73,7 @@ Faker::Name.name      #=> "Christophe Bartell"
 Faker::Internet.email #=> "kirsten.greenholt@corkeryfisher.info"
 ```
 
-###Faker::Address
+### Faker::Address
 -----------------
 
 ```ruby
@@ -78,7 +122,7 @@ Faker::Address.longitude #=> "-156.65548382095133"
 ```ruby
 
 Faker::Bitcoin.address #=> "1HUoGjmgChmnxxYhz87YytV4gVjfPaExmh"
-Faker::Bitcoin.testnet_address #=> ""msHGunDvoEwmVFXvd2Bub1SNw5RP1YHJaf""
+Faker::Bitcoin.testnet_address #=> "msHGunDvoEwmVFXvd2Bub1SNw5RP1YHJaf"
 
 ```
 
@@ -104,6 +148,10 @@ Faker::Code.isbn #=> "759021701-8"
 
 Faker::Code.ean #=> "4600051000057"
 
+Faker::Code.imei #= "546327785982623"
+
+Faker::Code.asin #=> "B00000IGGJ"
+
 ```
 
 ###Faker::Color
@@ -167,6 +215,9 @@ Faker::Company.logo #=> "https://pigment.github.com/fake-logos/logos/medium/colo
 
 Faker::Company.swedish_organisation_number #=> "7718797652"
 
+# Generate an Australian Business Number
+Faker::Company.australian_business_number #=> "81137773602"
+
 # Get a random profession
 Faker::Company.profession #=> "firefighter"
 
@@ -179,7 +230,7 @@ Faker::Company.profession #=> "firefighter"
 # Random date between dates
 Faker::Date.between(2.days.ago, Date.today) #=> "Wed, 24 Sep 2014"
 
-# Randome date between dates except for certain date
+# Random date between dates except for certain date
 Faker::Date.between_except(1.year.ago, 1.year.from_now, Date.today) #=> "Wed, 24 Sep 2014"
 
 # Random date in the future (up to maximum of N days)
@@ -236,8 +287,10 @@ Faker::Internet.domain_suffix #=> "info"
 
 Faker::Internet.ip_v4_address #=> "24.29.18.175"
 
-# Guaranteed not to be in 10.0.0.0/8, 127.0.0.0/8, 169.254.0.0/16,
-# 172.16.0.0/12, or 192.168.0.0/16
+# Private IP range according to RFC 1918 and 127.0.0.0/8 and 169.254.0.0/16.
+Faker::Internet.private_ip_v4_address #=> "10.0.0.1"
+
+# Guaranteed not to be in the ip range from the private_ip_v4_address method.
 Faker::Internet.public_ip_v4_address #=> "24.29.18.175"
 
 Faker::Internet.ip_v4_cidr #=> "24.29.18.175/21"
@@ -263,6 +316,18 @@ Faker::Internet.slug('foo bar', '-') #=> "foo-bar"
 
 ```
 
+###Faker::File
+---------------
+```ruby
+Faker::File.extension #=> "mp3"
+Faker::File.mime_type #=> "application/pdf"
+# Optional arguments: dir, name, extension, directory_separator
+Faker::File.file_name('path/to') #=> "path/to/something_random.jpg"
+Faker::File.file_name('foo/bar', 'baz') #=> "foo/bar/baz.zip"
+Faker::File.file_name('foo/bar', 'baz', 'doc') #=> "foo/bar/baz.doc"
+Faker::File.file_name('foo/bar', 'baz', 'mp3', '\') #=> "foo\bar\baz.mp3"
+```
+
 ###Faker::Lorem
 ---------------
 
@@ -270,7 +335,7 @@ Faker::Internet.slug('foo bar', '-') #=> "foo-bar"
 
 Faker::Lorem.word #=> "repellendus"
 
-# Optional arguments: num=3, supplemental=false
+# Optional arguments: num=3, supplemental=false (words from a supplementary list of Lorem-like words)
 Faker::Lorem.words #=> ["dolores", "adipisci", "nesciunt"]
 Faker::Lorem.words(4) #=> ["culpa", "recusandae", "aut", "omnis"]
 Faker::Lorem.words(4, true) #=> ["colloco", "qui", "vergo", "deporto"]
@@ -310,17 +375,19 @@ Faker::Lorem.paragraphs(1, true) #=> ["Depulso animi cunctatio amicitia adficio.
 
 ```ruby
 
-Faker::Name.name #=> "Tyshawn Johns Sr."
+Faker::Name.name             #=> "Tyshawn Johns Sr."
+
+Faker::Name.name_with_middle #=> "Aditya Elton Douglas"
 
-Faker::Name.first_name #=> "Kaci"
+Faker::Name.first_name       #=> "Kaci"
 
-Faker::Name.last_name #=> "Ernser"
+Faker::Name.last_name        #=> "Ernser"
 
-Faker::Name.prefix #=> "Mr."
+Faker::Name.prefix           #=> "Mr."
 
-Faker::Name.suffix #=> "IV"
+Faker::Name.suffix           #=> "IV"
 
-Faker::Name.title #=> "Legacy Creative Director"
+Faker::Name.title            #=> "Legacy Creative Director"
 
 ```
 
@@ -430,15 +497,16 @@ Faker::PhoneNumber.extension #=> "3764"
 Faker::Time.between(DateTime.now - 1, DateTime.now) #=> "2014-09-18 12:30:59 -0700"
 
 # Random date between dates (within specified part of the day)
-# You can install the active_support gem to facilitate time manipulation like 45.minutes + 2.hours
-require "as-duration"
-Faker::Time.between(2.days.ago, Time.now, :all) #=> "2014-09-19 07:03:30 -0700"
-Faker::Time.between(2.days.ago, Time.now, :day) #=> "2014-09-18 16:28:13 -0700"
-Faker::Time.between(2.days.ago, Time.now, :night) #=> "2014-09-20 19:39:38 -0700"
-Faker::Time.between(2.days.ago, Time.now, :morning) #=> "2014-09-19 08:07:52 -0700"
-Faker::Time.between(2.days.ago, Time.now, :afternoon) #=> "2014-09-18 12:10:34 -0700"
-Faker::Time.between(2.days.ago, Time.now, :evening) #=> "2014-09-19 20:21:03 -0700"
-Faker::Time.between(2.days.ago, Time.now, :midnight) #=> "2014-09-20 00:40:14 -0700"
+# You can install the as-duration gem to facilitate time manipulation like 45.minutes + 2.hours
+# (not needed if you already have activesupport, which is included with Rails)
+require 'as-duration'
+Faker::Time.between(2.days.ago, Date.today, :all) #=> "2014-09-19 07:03:30 -0700"
+Faker::Time.between(2.days.ago, Date.today, :day) #=> "2014-09-18 16:28:13 -0700"
+Faker::Time.between(2.days.ago, Date.today, :night) #=> "2014-09-20 19:39:38 -0700"
+Faker::Time.between(2.days.ago, Date.today, :morning) #=> "2014-09-19 08:07:52 -0700"
+Faker::Time.between(2.days.ago, Date.today, :afternoon) #=> "2014-09-18 12:10:34 -0700"
+Faker::Time.between(2.days.ago, Date.today, :evening) #=> "2014-09-19 20:21:03 -0700"
+Faker::Time.between(2.days.ago, Date.today, :midnight) #=> "2014-09-20 00:40:14 -0700"
 
 # Random time in the future (up to maximum of N days)
 Faker::Time.forward(23, :morning) # => "2014-09-26 06:54:47 -0700"
@@ -472,6 +540,19 @@ Faker::Hacker.verb  #=> "bypass"
 Faker::Hacker.ingverb #=> "synthesizing"
 ```
 
+###Faker::Crypto
+---------------------
+
+```ruby
+
+Faker::Crypto.md5 #=> "6b5ed240042e8a65c55ddb826c3408e6"
+
+Faker::Crypto.sha1 #=> "4e99e31c51eef8b2d290e709f757f92e558a503f"
+
+Faker::Crypto.sha256 #=> "51e4dbb424cd9db1ec5fb989514f2a35652ececef33f21c8dd1fd61bb8e3929d"
+
+```
+
 ###Faker::App
 -----------------
 
@@ -676,7 +757,88 @@ Faker::Beer.alcohol #=> "6.3%"
 Faker::Beer.blg #=> "18.5°Blg"
 ```
 
+###Faker::ChuckNorris
+----------------
+
+```ruby
+Faker::ChuckNorris.fact #=> "Chuck Norris can solve the Towers of Hanoi in one move."
+```
+
+###Faker::Educator
+-------------------
+
+```ruby
+Faker::Educator.university #=> "Mallowtown Technical College"
+
+Faker::Educator.secondary_school #=> "Iceborough Secodary College"
+
+Faker::Educator.course #=> "Associate Degree in Criminology"
+
+Faker::Educator.campus #=> "Vertapple Campus"
+```
+
+###Faker::Space
+----------------
+
+```ruby
+# Random planet from our Solar System
+Faker::Space.planet #=> "Venus"
+
+# Random moon from our Solar System
+Faker::Space.moon #=> "Europa"
+
+# Random galaxy
+Faker::Space.galaxy #=> "Andromeda"
+
+# Random nebula name
+Faker::Space.nebula #=> "Triffid Nebula"
+
+# Random star cluster
+Faker::Space.star_cluster #=> "Messier 70"
+
+# Random constellation
+Faker::Space.constellation #=> "Orion"
+
+# Random star
+Faker::Space.star #=> "Proxima Centauri"
+
+# Random national space agency
+Faker::Space.agency #=> "Japan Aerospace Exploration Agency"
+
+# Random space agency abbreviation
+Faker::Space.agency_abv #=> "NASA"
+
+# Random spacecraft name (limited to NASA)
+Faker::Space.nasa_space_craft #=> "Endeavour"
+
+# Random private space company title
+Faker::Space.company #=> "SpaceX"
+
+# Random unit of stellar distance with number
+Faker::Space.distance_measurement #=> "15 parsecs"
+```
+
 
+###Faker::Music
+-------------------
+
+```ruby
+Faker::Music.key #=> "C"
+
+Faker::Music.instrument #=> "Ukelele"
+```
+
+###Faker::Vehicle
+------------------
+
+```ruby
+
+# Generate vehicle identification number
+Faker::Vehicle.vin #=> "LLDWXZLG77VK2LUUF"
+
+# Random vehicle manufacturer
+Faker::Vehicle.manufacture #=> "JAGUAR CARS LTD"
+```
 
 Customization
 ------------

data/lib/faker.rb

@@ -97,6 +97,18 @@ module Faker
         end
       end
 
+      # Helper for the common approach of grabbing a translation
+      # with an array of values and returning all of them.
+      def fetch_all(key)
+        fetched = translate("faker.#{key}")
+        fetched = fetched.last if fetched.size <= 1
+        if !fetched.respond_to?(:sample) && fetched.match(/^\//) and fetched.match(/\/$/) # A regex
+          regexify(fetched)
+        else
+          fetched
+        end
+      end
+
       # Load formatted strings from the locale, "parsing" them
       # into method calls that can be used to generate a
       # formatted translation: e.g., "#{first_name} #{last_name}".
@@ -182,6 +194,7 @@ require 'faker/company'
 require 'faker/university'
 require 'faker/finance'
 require 'faker/internet'
+require 'faker/file'
 require 'faker/lorem'
 require 'faker/name'
 require 'faker/team'
@@ -207,6 +220,13 @@ require 'faker/superhero'
 require 'faker/beer'
 require 'faker/boolean'
 require 'faker/star_wars'
+require 'faker/chuck_norris'
+require 'faker/crypto'
+require 'faker/educator'
+require 'faker/space'
+require 'faker/yoda'
+require 'faker/music'
+require 'faker/vehicle'
 
 require 'extensions/array'
 require 'extensions/symbol'

data/lib/faker/app.rb

@@ -7,7 +7,7 @@ module Faker
       end
 
       def version
-        if parse('app.version') == ""
+        if parse('app.version') == ''
           numerify(fetch('app.version'))
         else
           parse('app.version')

data/lib/faker/beer.rb

@@ -37,4 +37,4 @@ module Faker
       end
     end
   end
-end
+end

data/lib/faker/chuck_norris.rb

@@ -0,0 +1,16 @@
+module Faker
+  class ChuckNorris < Base
+    flexible :name
+
+    class << self
+
+      def name
+        parse('chuck_norris')
+      end
+
+      # from: https://github.com/jenkinsci/chucknorris-plugin/blob/master/src/main/java/hudson/plugins/chucknorris/FactGenerator.java
+      def fact; fetch('chuck_norris.fact'); end
+
+    end
+  end
+end

data/lib/faker/code.rb

@@ -1,5 +1,6 @@
 module Faker
   class Code < Base
+    flexible :code
     class << self
 
       # Generates a 10 digit NPI (National Provider Identifier
@@ -37,8 +38,66 @@ module Faker
         "#{prefix}#{values}#{check_alpha}"
       end
 
+      # Generate GSM modem, device or mobile phone 15 digit IMEI number.
+      def imei
+        generate_imei
+      end
+
+      # Retrieves a real Amazon ASIN code list taken from
+      # https://archive.org/details/asin_listing
+      def asin
+        fetch('code.asin')
+      end
+
     private
 
+      # Reporting body identifier
+      RBI = %w(01 10 30 33 35 44 45 49 50 51 52 53 54 86 91 98 99).freeze
+
+      def generate_imei
+        pos = 0
+        str = Array.new(15, 0)
+        sum = 0
+        t = 0
+        len_offset = 0
+        len = 15
+
+        # Fill in the first two values of the string based with the specified prefix.
+        # Reporting Body Identifier list: http://en.wikipedia.org/wiki/Reporting_Body_Identifier
+        arr = RBI.sample
+        str[0] = arr[0].to_i
+        str[1] = arr[1].to_i
+        pos = 2
+
+        # Fill all the remaining numbers except for the last one with random values.
+        while pos < (len - 1)
+          str[pos] = rand(0..9)
+          pos += 1
+        end
+
+        # Calculate the Luhn checksum of the values thus far
+        len_offset = (len + 1) % 2
+        for pos in (0..(len - 1))
+          if (pos + len_offset) % 2 != 0
+            t = str[pos] * 2
+
+            if t > 9
+              t -= 9
+            end
+
+            sum += t
+          else
+            sum += str[pos]
+          end
+        end
+
+        # Choose the last digit so that it causes the entire string to pass the checksum.
+        str[len - 1] = (10 - (sum % 10)) % 10
+
+        # Output the IMEI value.
+        str.join('')
+      end
+
       def generate_base10_isbn
         values = regexify(/\d{9}/)
         remainder = sum(values) { |value, index| (index + 1) * value.to_i } % 11