faker 1.4.3 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9d9ae16e743b75883bfa74a32a7bf9e8d61003bb
-  data.tar.gz: 14f3e9cf81df8486916540f7e87f4adb7c4510d1
+  metadata.gz: c6c36a94960622277ebd5a4297ec2433f7e5fe2b
+  data.tar.gz: ca8eee943c3f67e2201c695ac8f9e73d6129c913
 SHA512:
-  metadata.gz: c2c98f8d6edc8c068b9671cdb1426b51e194e8e1f9648e4c0c1a62ece721457e0d53fefc449fa5006a8dc52985e6ae42c0f0318811190b0e1e5d1719d64d3fc2
-  data.tar.gz: c8fd7c213d18954544d406d733c3c4304cbce9d9998dfe34f09d987e46b42682259ef20da2284f015fd53bfa54d9e18591240793b32ccdbc685776250b2e8aed
+  metadata.gz: bf565c6375b6e3dab4c7e6598f618c2bb2930d8d8bc70bb9202f886d65b9b5f9f4430ffc3554fc13e99a0739a9af4893eabbb452f9f7fbc0c7649f9f3a6bdcf7
+  data.tar.gz: 09a408f05ef48d4aa320cb1c4a75ddf2f6d3da570430e81abb3cd888d5f27b3909e285654dbb458f64e03e3b2527b5790b6d9fbef6724978bfc41bb1c7c1e4a7

data/History.txt

@@ -1,3 +1,16 @@
+== 1.5.0 2015-08-17
+* Added logos
+* Added Slack Emoji
+* Updated image generators
+* Updated Dutch Locale
+* Added support for generating RGB values, HSL colors, alpha channel, and HSLA colors
+* Added locale for Uganda
+* Added basic Ukrainian support
+* Added university name generator
+* Updated documentation
+* Updated a variety of locales
+* Various fixes
+
 == 1.4.3 2014-08-15
 * Updated Russian locale
 * Added EIN generator

data/README.md

@@ -8,6 +8,8 @@ for the creation of this gem), having real-looking test data, and having your
 database populated with more than one or two records while you're doing
 development.
 
+NOTE: While Faker generates data at random, returned values are not guaranteed to be unique.
+
 Installing
 ----------
 ```bash
@@ -50,12 +52,14 @@ Faker::Address.city_suffix #=> "fort"
 
 Faker::Address.city_prefix #=> "Lake"
 
-Faker::Address.state_abbr #=> "AP"
-
 Faker::Address.state #=> "California"
 
+Faker::Address.state_abbr #=> "AP"
+
 Faker::Address.country #=> "French Guiana"
 
+Faker::Address.country_code #=> "IT"
+
 Faker::Address.latitude #=> "-58.17256227443719"
 
 Faker::Address.longitude #=> "-156.65548382095133"
@@ -69,6 +73,7 @@ Faker::Address.longitude #=> "-156.65548382095133"
 ```ruby
 
 Faker::Bitcoin.address #=> "1HUoGjmgChmnxxYhz87YytV4gVjfPaExmh"
+Faker::Bitcoin.testnet_address #=> ""msHGunDvoEwmVFXvd2Bub1SNw5RP1YHJaf""
 
 ```
 
@@ -126,6 +131,8 @@ Faker::Company.suffix #=> "Group"
 # Generate a buzzword-laden catch phrase.
 Faker::Company.catch_phrase #=> "Business-focused coherent parallelism"
 
+Faker::Company.buzzword #=> "Business-focused"
+
 # When a straight answer won't do, BS to the rescue!
 Faker::Company.bs #=> "empower one-to-one web-readiness"
 
@@ -133,11 +140,26 @@ Faker::Company.ein #=> "34-8488813"
 
 Faker::Company.duns_number #=> "08-341-3736"
 
-# Get a random company logo url in GIF format.
-Faker::Company.logo #=> "http://www.biz-logo.com/examples/007.gif"
+# Get a random company logo url in PNG format.
+Faker::Company.logo #=> "http://pigment.github.com/fake-logos/logos/medium/color/5.png"
+
+Faker::Company.swedish_organisation_number #=> "7718797652"
 
 ```
 
+###Faker::Date
+---------------------
+
+```ruby
+# Random date between dates
+Faker::Date.between(2.days.ago, Date.today) #=> "Wed, 24 Sep 2014"
+
+# Random date in the future (up to maximum of N days)
+Faker::Date.forward(23) # => "Fri, 03 Oct 2014"
+
+# Random date in the past (up to maximum of N days)
+Faker::Date.backward(14) #=> "Fri, 19 Sep 2014"
+```
 
 ###Faker::Internet
 ---------------
@@ -232,14 +254,14 @@ Faker::Lorem.sentences(1, true) #=> ["Quis capillus curo ager veritatis voro et
 # 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) #=> ""
+Faker::Lorem.paragraph(2, true) #=> "Cedo vero adipisci. Theatrum crustulum coaegresco tonsor crastinus stabilis. Aliqua crur consequatur amor una tolero sum."
+Faker::Lorem.paragraph(2, false, 4) #=> "Neque aut et nemo aut incidunt voluptates. Dolore cum est sint est. Vitae assumenda porro odio dolores fugiat. Est voluptatum quia rerum."
+Faker::Lorem.paragraph(2, true, 4) #=> "Vomito unde uxor annus. Et patior utilis sursum."
 
 # Optional arguments: paragraph_count=3, supplemental=false
-Faker::Lorem.paragraphs #=> ""
-Faker::Lorem.paragraphs(1) #=> ""
-Faker::Lorem.paragraphs(1, true) #=> ""
+Faker::Lorem.paragraphs #=> ["Dolores quis quia ad quo voluptates. Maxime delectus totam numquam. Necessitatibus vel atque qui dolore.", "Id neque nemo. Dolores iusto facere est ad. Accusamus ipsa dolor ut.", "Et officiis ut hic. Sunt asperiores minus distinctio debitis ipsa dolor. Minima eos deleniti."]
+Faker::Lorem.paragraphs(1) #=> ["Labore voluptas sequi. Ratione nulla eaque quia molestiae fugit. At quam laboriosam aut ut dignissimos."]
+Faker::Lorem.paragraphs(1, true) #=> ["Depulso animi cunctatio amicitia adficio. Vester viduo qui despirmatio voluptas. Validus laudantium adopto ut agnitio venustas. Aer arcus odio esse."]
 
 ```
 
@@ -262,6 +284,22 @@ Faker::Name.title #=> "Legacy Creative Director"
 
 ```
 
+###Faker::Avatar
+----------------
+
+```ruby
+
+Faker::Avatar.image #=> "http://robohash.org/sitsequiquia.png?size=300x300"
+
+Faker::Avatar.image("my-own-slug") #=> "http://robohash.org/my-own-slug.png?size=300x300"
+
+Faker::Avatar.image("my-own-slug", "50x50") #=> "http://robohash.org/my-own-slug.png?size=50x50"
+
+Faker::Avatar.image("my-own-slug", "50x50", "jpg") #=> "http://robohash.org/my-own-slug.jpg?size=50x50"
+
+Faker::Avatar.image("my-own-slug", "50x50", "bmp") #=> "http://robohash.org/my-own-slug.bmp?size=50x50"
+```
+
 ###Faker::Number
 ----------------
 
@@ -270,6 +308,20 @@ Faker::Name.title #=> "Legacy Creative Director"
 # Required parameter: digits
 Faker::Number.number(10) #=> "1968353479"
 
+# Required parameter: l_digits
+Faker::Number.decimal(2) #=> "11.88"
+
+Faker::Number.decimal(2, 3) #=> "18.843"
+
+# Required parameter: digits
+Faker::Number.hexadecimal(3) #=> "e74"
+
+Faker::Number.between(1, 10) #=> 7
+
+Faker::Number.positive #=> 235.59238499107653
+
+Faker::Number.negative #=> -4480.042585669558
+
 Faker::Number.digit #=> "1"
 
 ```
@@ -316,6 +368,31 @@ Faker::PhoneNumber.extension #=> "3764"
 
 ```
 
+###Faker::Time
+---------------------
+
+```ruby
+# Random date between dates
+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"
+
+# Random time in the future (up to maximum of N days)
+Faker::Time.forward(23, :morning) # => "2014-09-26 06:54:47 -0700"
+
+# Random time in the past (up to maximum of N days)
+Faker::Time.backward(14, :evening) #=> "2014-09-17 19:56:33 -0700"
+```
+
 ###Faker::Hacker
 ---------------------
 Are you having trouble writing tech-savvy dialogue for your latest screenplay?
@@ -354,6 +431,85 @@ Faker::App.author #=> "Daphne Swift"
 
 ```
 
+###Faker::SlackEmoji
+-----------------
+
+```ruby
+
+# Random Slack Emoji from people category
+Faker::SlackEmoji.people #=> ":sleepy:"
+
+# Random Slack Emoji from nature category
+Faker::SlackEmoji.nature #=> ":chestnut:"
+
+# Random Slack Emoji from food and drink category
+Faker::SlackEmoji.food_and_drink #=> ":tangerine:"
+
+# Random Slack Emoji from celebration category
+Faker::SlackEmoji.celebration #=> ":ribbon:"
+
+# Random Slack Emoji from activity category
+Faker::SlackEmoji.activity #=> ":performing_arts:"
+
+# Random Slack Emoji from travel and places category
+Faker::SlackEmoji.travel_and_places #=> ":truck:"
+
+# Random Slack Emoji from objects & symbols category
+Faker::SlackEmoji.objects_and_symbols #=> ":alarm_clock:"
+
+# Random Slack Emoji from custom category
+Faker::SlackEmoji.custom #=> ":suspect:"
+
+# Random Slack Emoji from any category
+Faker::SlackEmoji.emoji #=> ":last_quarter_moon:"
+
+```
+
+###Faker::Team
+-----------------
+
+```ruby
+
+# Random Team Creature
+Faker::Team.creature #=> "gooses"
+
+# Random Team Name created from random US State (Faker::Address.state) prepended to a random Team Creature
+Faker::Team.name #=> "Oregon vixens"
+
+# Random Team State
+Faker::Team.state #=> "Oregon"
+
+# Random Team Sport
+Faker::Team.sport #=> "lacrosse"
+
+```
+
+###Faker::Book
+------------------
+
+```ruby
+
+# Random Book Title
+Faker::Book.title #=> "The Odd Sister"
+
+# Random Author
+Faker::Book.author #=> "Alysha Olsen"
+
+# Random Publisher
+Faker::Book.publisher #=> "Opus Reader"
+
+```
+
+###Faker::University
+------------------
+
+```ruby
+
+# Random University Name
+Faker::University.name #=> "South Texas College"
+
+```
+
 Customization
 ------------
 Since you may want to make addresses and other types of data look different
@@ -372,7 +528,7 @@ and you can then override or add elements to suit
 en-au-ocker:
   faker:
     name:
-      # Exiting faker field, new data
+      # Existing faker field, new data
       first_name: [Charlotte, Ava, Chloe, Emily]
 
       # New faker fields

data/lib/faker.rb

@@ -159,7 +159,9 @@ end
 
 require 'faker/address'
 require 'faker/code'
+require 'faker/color'
 require 'faker/company'
+require 'faker/university'
 require 'faker/finance'
 require 'faker/internet'
 require 'faker/lorem'
@@ -177,6 +179,10 @@ require 'faker/time'
 require 'faker/number'
 require 'faker/hacker'
 require 'faker/app'
+require 'faker/slack_emoji'
+require 'faker/book'
 
 require 'extensions/array'
 require 'extensions/symbol'
+
+require 'helpers/char'

data/lib/faker/avatar.rb

@@ -3,11 +3,11 @@ module Faker
     class << self
       SUPPORTED_FORMATS = %w(png jpg bmp)
 
-      def image(slug = nil, size = '300x300', format = 'png')
+      def image(slug = nil, size = '300x300', format = 'png', set = 'set1')
         raise ArgumentError, "Size should be specified in format 300x300" unless size.match(/^[0-9]+x[0-9]+$/)
         raise ArgumentError, "Supported formats are #{SUPPORTED_FORMATS.join(', ')}" unless SUPPORTED_FORMATS.include?(format)
         slug ||= Faker::Lorem.words.join
-        "http://robohash.org/#{slug}.#{format}?size=#{size}"
+        "http://robohash.org/#{slug}.#{format}?size=#{size}&set=#{set}"
       end
     end
   end

data/lib/faker/bitcoin.rb

@@ -5,12 +5,17 @@ module Faker
   class Bitcoin < Base
     class << self
 
+      PROTOCOL_VERSIONS = {
+        main: 0,
+        testnet: 111
+      }
+
       def address
-        hash = SecureRandom.hex(20)
-        version = 0
-        packed = version.chr + [hash].pack("H*")
-        checksum = Digest::SHA2.digest(Digest::SHA2.digest(packed))[0..3]
-        base58(packed + checksum)
+        address_for(:main)
+      end
+
+      def testnet_address
+        address_for(:testnet)
       end
 
       protected
@@ -32,6 +37,13 @@ module Faker
         '1'*npad + ret.reverse
       end
 
+      def address_for(network)
+        version = PROTOCOL_VERSIONS.fetch(network)
+        hash = SecureRandom.hex(20)
+        packed = version.chr + [hash].pack("H*")
+        checksum = Digest::SHA2.digest(Digest::SHA2.digest(packed))[0..3]
+        base58(packed + checksum)
+      end
     end
   end
 end

data/lib/faker/book.rb

@@ -0,0 +1,19 @@
+module Faker
+  class Book < Base
+    flexible :book
+
+    class << self
+      def title
+        fetch('book.title')
+      end
+
+      def author
+        fetch('book.author')
+      end
+
+      def publisher
+        fetch('book.publisher')
+      end
+    end
+  end
+end

data/lib/faker/business.rb

@@ -10,7 +10,7 @@ module Faker
       end
 
       def credit_card_expiry_date
-        ::Date.parse(fetch('business.credit_card_expiry_dates'))
+        ::Date.today + (365 * (rand(4) + 1))
       end
 
       def credit_card_type

data/lib/faker/code.rb

@@ -1,6 +1,13 @@
 module Faker
   class Code < Base
     class << self
+
+      # Generates a 10 digit NPI (National Provider Identifier
+      # issued to health care providers in the United States)
+      def npi
+        Random.new.rand(10 ** 10).to_s.rjust(10, '0')
+      end
+
       # By default generates 10 sign isbn code in format 123456789-X
       # You can pass 13 to generate new 13 sign code
       def isbn(base = 10)

data/lib/faker/color.rb

@@ -0,0 +1,49 @@
+module Faker
+  class Color < Base
+    class << self
+      def hex_color
+        @hex_color = "#%06x" % (rand * 0xffffff)
+      end
+
+      def single_rgb_color
+        @single_rgb_color = (0..255).to_a.sample
+        @single_rgb_color
+      end
+
+      def rgb_color
+        @rgb_colors = []
+        3.times do
+          @rgb_colors.push single_rgb_color
+        end
+        @rgb_colors
+      end
+
+      def single_hsl_color
+        @single_hsla_color = Faker::Base::rand_in_range(0.0, 360.00).round(2)
+        @single_hsla_color
+      end
+
+      def alpha_channel
+        @alpha_channel = rand
+        @alpha_channel
+      end
+
+      def hsl_color
+        @hsl_colors = []
+        3.times do
+          @hsl_colors.push single_hsl_color
+        end
+        @hsl_colors
+      end
+
+      def hsla_color
+        @hsla_colors = []
+        3.times do
+          @hsla_colors.push single_hsl_color
+        end
+        @hsla_colors.push alpha_channel
+        @hsla_colors
+      end
+    end
+  end
+end