faker 5.0.0 → 5.1.0

package/lib/address.js

@@ -195,9 +195,20 @@ function Address (faker) {
    * countryCode
    *
    * @method faker.address.countryCode
+   * @param {string} alphaCode default alpha-2
    */
-  this.countryCode = function () {
+  this.countryCode = function (alphaCode) {
+    
+    if (typeof alphaCode === 'undefined' || alphaCode === 'alpha-2') {
+        return faker.random.arrayElement(faker.definitions.address.country_code);
+    }
+
+    if (alphaCode === 'alpha-3') {
+        return faker.random.arrayElement(faker.definitions.address.country_code_alpha_3);
+    }
+      
     return faker.random.arrayElement(faker.definitions.address.country_code);
+
   }
 
   /**
@@ -373,6 +384,14 @@ function Address (faker) {
         return [randomCoord[0].toFixed(4), randomCoord[1].toFixed(4)];
     }
 
+    /**
+     * Return a random time zone
+     * @method faker.address.timeZone
+     */
+    this.timeZone = function() {
+      return faker.random.arrayElement(faker.definitions.address.time_zone);
+    }
+
   return this;
 }
 

package/lib/finance.js

@@ -224,7 +224,7 @@ self.litecoinAddress = function () {
   };
   /**
    * Credit card CVV
-   * @method faker.finance.creditCardNumber
+   * @method faker.finance.creditCardCVV
   */
   self.creditCardCVV = function() {
     var cvv = "";
@@ -309,6 +309,22 @@ self.litecoinAddress = function () {
           prob < 40 ?
               Helpers.replaceSymbols("###") : "");
   };
+
+  /**
+   * description
+   *
+   * @method  faker.finance.transactionDescription
+   */
+  self.transactionDescription = function() {
+    var account = Helpers.createTransaction().account
+    var card = faker.finance.mask();
+    var currency = faker.finance.currencyCode();
+    var amount = Helpers.createTransaction().amount
+    var transactionType = Helpers.createTransaction().type
+    var company = Helpers.createTransaction().business
+    return transactionType + " transaction at " + company + " using card ending with ***" + card + " for " + currency + " " + amount + " in account ***" + account
+  }
+
 };
 
 module['exports'] = Finance;

package/lib/helpers.js

@@ -194,17 +194,24 @@ var Helpers = function (faker) {
    };
 
   /**
-   * takes an array and returns it randomized
+   * takes an array and randomizes it in place then returns it
+   * 
+   * uses the modern version of the Fisher–Yates algorithm
    *
    * @method faker.helpers.shuffle
    * @param {array} o
    */
   self.shuffle = function (o) {
       if (typeof o === 'undefined' || o.length === 0) {
-        return [];
+        return o || [];
       }
       o = o || ["a", "b", "c"];
-      for (var j, x, i = o.length-1; i; j = faker.random.number(i), x = o[--i], o[i] = o[j], o[j] = x);
+      for (var x, j, i = o.length - 1; i > 0; --i) {
+        j = faker.random.number(i);
+        x = o[i];
+        o[i] = o[j];
+        o[j] = x;
+      }
       return o;
   };
 

package/lib/image.js

@@ -3,6 +3,7 @@
  * @namespace faker.image
  * @property {object} lorempixel - faker.image.lorempixel
  * @property {object} unsplash - faker.image.unsplash
+ * @property {object} unsplash - faker.image.lorempicsum
  * @default Default provider is unsplash image provider
  */
 var Image = function (faker) {
@@ -10,6 +11,7 @@ var Image = function (faker) {
   var self = this;
   var Lorempixel = require('./image_providers/lorempixel');
   var Unsplash = require('./image_providers/unsplash');
+  var LoremPicsum = require('./image_providers/lorempicsum');
 
   /**
    * image
@@ -218,6 +220,7 @@ var Image = function (faker) {
 
   self.lorempixel = new Lorempixel(faker);
   self.unsplash = new Unsplash(faker);
+  self.lorempicsum = new LoremPicsum(faker);
 
   // Object.assign(self, self.unsplash);
   // How to set default as unsplash? should be image.default?

package/lib/image_providers/lorempicsum.js

@@ -0,0 +1,108 @@
+/**
+ *
+ * @namespace lorempicsum
+ * @memberof faker.image
+ */
+var LoremPicsum = function (faker) {
+
+    var self = this;
+
+    /**
+     * image
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {boolean} grayscale
+     * @param {number} blur 1-10
+     * @method faker.image.lorempicsum.image
+     * @description search image from unsplash
+     */
+    self.image = function (width, height, grayscale, blur) {
+      return self.imageUrl(width, height, grayscale, blur);
+    };
+    /**
+     * imageGrayscaled
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {boolean} grayscale
+     * @method faker.image.lorempicsum.imageGrayscaled
+     * @description search grayscale image from unsplash
+     */
+    self.imageGrayscale = function (width, height, grayscale) {
+      return self.imageUrl(width, height, grayscale);
+    };
+    /**
+     * imageBlurred
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {number} blur 1-10
+     * @method faker.image.lorempicsum.imageBlurred
+     * @description search blurred image from unsplash
+     */
+    self.imageBlurred = function (width, height, blur) {
+      return self.imageUrl(width, height, undefined, blur);
+    };
+    /**
+     * imageRandomSeeded
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {boolean} grayscale
+     * @param {number} blur 1-10
+     * @param {string} seed
+     * @method faker.image.lorempicsum.imageRandomSeeded
+     * @description search same random image from unsplash, based on a seed
+     */
+    self.imageRandomSeeded = function (width, height, grayscale, blur, seed) {
+      return self.imageUrl(width, height, grayscale, blur, seed);
+    };
+    /**
+     * avatar
+     *
+     * @method faker.image.lorempicsum.avatar
+     */
+    self.avatar = function () {
+      return faker.internet.avatar();
+    };
+    /**
+     * imageUrl
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {boolean} grayscale
+     * @param {number} blur 1-10
+     * @param {string} seed
+     * @method faker.image.lorempicsum.imageUrl
+     */
+    self.imageUrl = function (width, height, grayscale, blur, seed) {
+        var width = width || 640;
+        var height = height || 480;
+  
+        var url = 'https://picsum.photos';
+          
+        if (seed) {
+          url += '/seed/' + seed;
+        }
+
+        url += '/' + width + '/' + height;
+        
+        if (grayscale && blur) {
+          return url + '?grayscale' + '&blur=' + blur;
+        }
+
+        if (grayscale) {
+          return url + '?grayscale';
+        }
+
+        if (blur) {
+          return url + '?blur=' + blur;
+        }
+    
+        return url;
+    };
+  }
+  
+  module["exports"] = LoremPicsum;
+  

package/lib/index.js

@@ -100,7 +100,7 @@ function Faker (opts) {
 
   var _definitions = {
     "name": ["first_name", "last_name", "prefix", "suffix", "gender", "title", "male_prefix", "female_prefix", "male_first_name", "female_first_name", "male_middle_name", "female_middle_name", "male_last_name", "female_last_name"],
-    "address": ["city_prefix", "city_suffix", "street_suffix", "county", "country", "country_code", "state", "state_abbr", "street_prefix", "postcode", "postcode_by_state", "direction", "direction_abbr"],
+    "address": ["city_prefix", "city_suffix", "street_suffix", "county", "country", "country_code", "country_code_alpha_3", "state", "state_abbr", "street_prefix", "postcode", "postcode_by_state", "direction", "direction_abbr", "time_zone"],
     "company": ["adjective", "noun", "descriptor", "bs_adjective", "bs_noun", "bs_verb", "suffix"],
     "lorem": ["words"],
     "hacker": ["abbreviation", "adjective", "noun", "verb", "ingverb", "phrase"],

package/lib/locales/en/address/country_code.js

@@ -29,7 +29,6 @@ module["exports"] = [
   "BN",
   "BO",
   "BQ",
-  "BQ",
   "BR",
   "BS",
   "BT",

package/lib/locales/en/address/country_code_alpha_3.js

@@ -0,0 +1,252 @@
+module["exports"] = [
+    "BGD",
+    "BEL",
+    "BFA",
+    "BGR",
+    "BIH",
+    "BRB",
+    "WLF",
+    "BLM",
+    "BMU",
+    "BRN",
+    "BOL",
+    "BHR",
+    "BDI",
+    "BEN",
+    "BTN",
+    "JAM",
+    "BVT",
+    "BWA",
+    "WSM",
+    "BES",
+    "BRA",
+    "BHS",
+    "JEY",
+    "BLR",
+    "BLZ",
+    "RUS",
+    "RWA",
+    "SRB",
+    "TLS",
+    "REU",
+    "TKM",
+    "TJK",
+    "ROU",
+    "TKL",
+    "GNB",
+    "GUM",
+    "GTM",
+    "SGS",
+    "GRC",
+    "GNQ",
+    "GLP",
+    "JPN",
+    "GUY",
+    "GGY",
+    "GUF",
+    "GEO",
+    "GRD",
+    "GBR",
+    "GAB",
+    "SLV",
+    "GIN",
+    "GMB",
+    "GRL",
+    "GIB",
+    "GHA",
+    "OMN",
+    "TUN",
+    "JOR",
+    "HRV",
+    "HTI",
+    "HUN",
+    "HKG",
+    "HND",
+    "HMD",
+    "VEN",
+    "PRI",
+    "PSE",
+    "PLW",
+    "PRT",
+    "SJM",
+    "PRY",
+    "IRQ",
+    "PAN",
+    "PYF",
+    "PNG",
+    "PER",
+    "PAK",
+    "PHL",
+    "PCN",
+    "POL",
+    "SPM",
+    "ZMB",
+    "ESH",
+    "EST",
+    "EGY",
+    "ZAF",
+    "ECU",
+    "ITA",
+    "VNM",
+    "SLB",
+    "ETH",
+    "SOM",
+    "ZWE",
+    "SAU",
+    "ESP",
+    "ERI",
+    "MNE",
+    "MDA",
+    "MDG",
+    "MAF",
+    "MAR",
+    "MCO",
+    "UZB",
+    "MMR",
+    "MLI",
+    "MAC",
+    "MNG",
+    "MHL",
+    "MKD",
+    "MUS",
+    "MLT",
+    "MWI",
+    "MDV",
+    "MTQ",
+    "MNP",
+    "MSR",
+    "MRT",
+    "IMN",
+    "UGA",
+    "TZA",
+    "MYS",
+    "MEX",
+    "ISR",
+    "FRA",
+    "IOT",
+    "SHN",
+    "FIN",
+    "FJI",
+    "FLK",
+    "FSM",
+    "FRO",
+    "NIC",
+    "NLD",
+    "NOR",
+    "NAM",
+    "VUT",
+    "NCL",
+    "NER",
+    "NFK",
+    "NGA",
+    "NZL",
+    "NPL",
+    "NRU",
+    "NIU",
+    "COK",
+    "XKX",
+    "CIV",
+    "CHE",
+    "COL",
+    "CHN",
+    "CMR",
+    "CHL",
+    "CCK",
+    "CAN",
+    "COG",
+    "CAF",
+    "COD",
+    "CZE",
+    "CYP",
+    "CXR",
+    "CRI",
+    "CUW",
+    "CPV",
+    "CUB",
+    "SWZ",
+    "SYR",
+    "SXM",
+    "KGZ",
+    "KEN",
+    "SSD",
+    "SUR",
+    "KIR",
+    "KHM",
+    "KNA",
+    "COM",
+    "STP",
+    "SVK",
+    "KOR",
+    "SVN",
+    "PRK",
+    "KWT",
+    "SEN",
+    "SMR",
+    "SLE",
+    "SYC",
+    "KAZ",
+    "CYM",
+    "SGP",
+    "SWE",
+    "SDN",
+    "DOM",
+    "DMA",
+    "DJI",
+    "DNK",
+    "VGB",
+    "DEU",
+    "YEM",
+    "DZA",
+    "USA",
+    "URY",
+    "MYT",
+    "UMI",
+    "LBN",
+    "LCA",
+    "LAO",
+    "TUV",
+    "TWN",
+    "TTO",
+    "TUR",
+    "LKA",
+    "LIE",
+    "LVA",
+    "TON",
+    "LTU",
+    "LUX",
+    "LBR",
+    "LSO",
+    "THA",
+    "ATF",
+    "TGO",
+    "TCD",
+    "TCA",
+    "LBY",
+    "VAT",
+    "VCT",
+    "ARE",
+    "AND",
+    "ATG",
+    "AFG",
+    "AIA",
+    "VIR",
+    "ISL",
+    "IRN",
+    "ARM",
+    "ALB",
+    "AGO",
+    "ATA",
+    "ASM",
+    "ARG",
+    "AUS",
+    "AUT",
+    "ABW",
+    "IND",
+    "ALA",
+    "AZE",
+    "IRL",
+    "IDN",
+    "UKR",
+    "QAT",
+    "MOZ"
+];

package/lib/locales/en/address/index.js

@@ -5,6 +5,7 @@ address.city_suffix = require("./city_suffix");
 address.county = require("./county");
 address.country = require("./country");
 address.country_code = require("./country_code");
+address.country_code_alpha_3 = require("./country_code_alpha_3");
 address.building_number = require("./building_number");
 address.street_suffix = require("./street_suffix");
 address.secondary_address = require("./secondary_address");

package/lib/locales/en/finance/currency.js

@@ -512,8 +512,8 @@ module["exports"] = {
     "symbol": "$"
   },
   "Dobra": {
-    "code": "STD",
-    "symbol": ""
+    "code": "STN",
+    "symbol": "Db"
   },
   "El Salvador Colon": {
     "code": "SVC",
@@ -549,7 +549,7 @@ module["exports"] = {
   },
   "Turkish Lira": {
     "code": "TRY",
-    "symbol": "TL"
+    "symbol": "₺"
   },
   "Trinidad and Tobago Dollar": {
     "code": "TTD",

package/lib/locales/en_IND/phone_number/formats.js

@@ -1,5 +1,14 @@
 module["exports"] = [
-  "+91###-###-####",
-  "+91##########",
-  "+91-###-#######"
+  "+919##-###-####",
+  "+919#########",
+  "+91-9##-#######",
+  "+918##-###-####",
+  "+918#########",
+  "+91-8##-#######",
+  "+917##-###-####",
+  "+917#########",
+  "+91-7##-#######",
+  "+916##-###-####",
+  "+916#########",
+  "+91-6##-#######",
 ];

package/lib/locales/fi/index.js

@@ -0,0 +1,4 @@
+var fi = {};
+module['exports'] = fi;
+fi.title = "Finnish";
+fi.name = require("./name");

package/lib/locales/fi/name/female_first_name.js

@@ -0,0 +1,52 @@
+module["exports"] = [
+    "Aino",
+    "Anja",
+    "Anna",
+    "Anne",
+    "Anneli",
+    "Annikki",
+    "Eeva",
+    "Elina",
+    "Elisabet",
+    "Emilia",
+    "Eveliina",
+    "Hanna",
+    "Hannele",
+    "Helena",
+    "Inkeri",
+    "Irmeli",
+    "Johanna",
+    "Kaarina",
+    "Karoliina",
+    "Katariina",
+    "Kristiina",
+    "Kyllikki",
+    "Laura",
+    "Leena",
+    "Liisa",
+    "Maarit",
+    "Maija",
+    "Mari",
+    "Maria",
+    "Marika",
+    "Marja",
+    "Marjatta",
+    "Minna",
+    "Orvokki",
+    "Pauliina",
+    "Pirjo",
+    "Pirkko",
+    "Päivi",
+    "Riitta",
+    "Ritva",
+    "Sari",
+    "Satu",
+    "Sinikka",
+    "Sofia",
+    "Susanna",
+    "Tarja",
+    "Tellervo",
+    "Tiina",
+    "Tuula",
+    "Tuulikki"
+];