faker 5.3.1 → 5.5.2

package/lib/iban.js

@@ -9,16 +9,16 @@ module["exports"] = {
     "001", "002", "003", "004", "005", "006", "007", "008", "009"
   ],
   toDigitString: function (str) {
-      return str.replace(/[A-Z]/gi, function(match) {
-          return match.toUpperCase().charCodeAt(0) - 55;
-      });
+    return str.replace(/[A-Z]/gi, function(match) {
+      return match.toUpperCase().charCodeAt(0) - 55;
+    });
   },
   mod97: function (digitStr) {
-      var m = 0;
-      for (var i = 0; i < digitStr.length; i++) {
-          m = ((m * 10) + (digitStr[i] |0)) % 97;
-      }
-      return m;
+    var m = 0;
+    for (var i = 0; i < digitStr.length; i++) {
+      m = ((m * 10) + (digitStr[i] |0)) % 97;
+    }
+    return m;
   },
   formats: [
     {
@@ -67,11 +67,19 @@ module["exports"] = {
       format: "ATkk bbbb bccc cccc cccc"
     },
     {
+      // Azerbaijan
+      // https://transferwise.com/fr/iban/azerbaijan
+      // Length 28
+      // BBAN 2c,16n
+      // GEkk bbbb cccc cccc cccc cccc cccc
+      // b = National bank code (alpha)
+      // c = Account number
+      // example IBAN AZ21 NABZ 0000 0000 1370 1000 1944
       country: "AZ",
       total: 28,
       bban: [
         {
-          type: "c",
+          type: "a",
           count: 4
         },
         {
@@ -342,7 +350,7 @@ module["exports"] = {
       total: 22,
       bban: [
         {
-          type: "c",
+          type: "a",
           count: 2
         },
         {
@@ -813,7 +821,7 @@ module["exports"] = {
       total: 24,
       bban: [
         {
-          type: "c",
+          type: "a",
           count: 4
         },
         {
@@ -1050,11 +1058,11 @@ module["exports"] = {
           count: 5
         },
         {
-          type: "c",
+          type: "n",
           count: 1
         },
         {
-          type: "c",
+          type: "n",
           count: 16
         }
       ],
@@ -1133,4 +1141,4 @@ module["exports"] = {
     "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS",
     "YE", "YT", "YU", "ZA", "ZM", "ZR", "ZW"
   ]
-}
+}

package/lib/image.js

@@ -43,22 +43,22 @@ var Image = function (faker) {
    * @method faker.image.imageUrl
    */
   self.imageUrl = function (width, height, category, randomize, https) {
-      var width = width || 640;
-      var height = height || 480;
-      var protocol = 'http://';
-      if (typeof https !== 'undefined' && https === true) {
-        protocol = 'https://';
-      }
-      var url = protocol + 'placeimg.com/' + width + '/' + height;
-      if (typeof category !== 'undefined') {
-        url += '/' + category;
-      }
+    var width = width || 640;
+    var height = height || 480;
+    var protocol = 'http://';
+    if (typeof https !== 'undefined' && https === true) {
+      protocol = 'https://';
+    }
+    var url = protocol + 'placeimg.com/' + width + '/' + height;
+    if (typeof category !== 'undefined') {
+      url += '/' + category;
+    }
 
-      if (randomize) {
-        url += '?' + faker.random.number()
-      }
+    if (randomize) {
+      url += '?' + faker.datatype.number()
+    }
 
-      return url;
+    return url;
   };
   /**
    * abstract

package/lib/image_providers/lorempixel.js

@@ -46,7 +46,7 @@ var Lorempixel = function (faker) {
       }
 
       if (randomize) {
-        url += '?' + faker.random.number()
+        url += '?' + faker.datatype.number()
       }
 
       return url;

package/lib/index.js

@@ -38,12 +38,63 @@ function Faker (opts) {
 
   self.definitions = {};
 
+  var _definitions = {
+    "name": ["first_name", "last_name", "prefix", "suffix", "binary_gender", "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_name", "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"],
+    "animal": ["dog", "cat", "snake", "bear", "lion", "cetacean", "insect", "crocodilia", "cow", "bird", "fish", "rabbit", "horse", "type"],
+    "company": ["adjective", "noun", "descriptor", "bs_adjective", "bs_noun", "bs_verb", "suffix"],
+    "lorem": ["words"],
+    "hacker": ["abbreviation", "adjective", "noun", "verb", "ingverb", "phrase"],
+    "phone_number": ["formats"],
+    "finance": ["account_type", "transaction_type", "currency", "iban", "credit_card"],
+    "internet": ["avatar_uri", "domain_suffix", "free_email", "example_email", "password"],
+    "commerce": ["color", "department", "product_name", "price", "categories", "product_description"],
+    "database": ["collation", "column", "engine", "type"],
+    "system": ["mimeTypes", "directoryPaths"],
+    "date": ["month", "weekday"],
+    "vehicle": ["vehicle", "manufacturer", "model", "type", "fuel", "vin", "color"],
+    "music": ["genre"],
+    "title": "",
+    "separator": ""
+  };
+
+  // Create a Getter for all definitions.foo.bar properties
+  Object.keys(_definitions).forEach(function(d){
+    if (typeof self.definitions[d] === "undefined") {
+      self.definitions[d] = {};
+    }
+
+    if (typeof _definitions[d] === "string") {
+      self.definitions[d] = _definitions[d];
+      return;
+    }
+
+    _definitions[d].forEach(function(p){
+      Object.defineProperty(self.definitions[d], p, {
+        get: function () {
+          if (typeof self.locales[self.locale][d] === "undefined" || typeof self.locales[self.locale][d][p] === "undefined") {
+            // certain localization sets contain less data then others.
+            // in the case of a missing definition, use the default localeFallback to substitute the missing set data
+            // throw new Error('unknown property ' + d + p)
+            return self.locales[localeFallback][d][p];
+          } else {
+            // return localized data
+            return self.locales[self.locale][d][p];
+          }
+        }
+      });
+    });
+  });
+
   var Fake = require('./fake');
   self.fake = new Fake(self).fake;
 
   var Unique = require('./unique');
   self.unique = new Unique(self).unique;
 
+  var Mersenne = require('./mersenne');
+  self.mersenne = new Mersenne();
+
   var Random = require('./random');
   self.random = new Random(self);
 
@@ -56,6 +107,9 @@ function Faker (opts) {
   var Address = require('./address');
   self.address = new Address(self);
 
+  var Animal = require('./animal');
+  self.animal = new Animal(self);
+
   var Company = require('./company');
   self.company = new Company(self);
 
@@ -101,53 +155,8 @@ function Faker (opts) {
   var Music = require('./music');
   self.music = new Music(self);
 
-  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", "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"],
-    "phone_number": ["formats"],
-    "finance": ["account_type", "transaction_type", "currency", "iban", "credit_card"],
-    "internet": ["avatar_uri", "domain_suffix", "free_email", "example_email", "password"],
-    "commerce": ["color", "department", "product_name", "price", "categories", "product_description"],
-    "database": ["collation", "column", "engine", "type"],
-    "system": ["mimeTypes", "directoryPaths"],
-    "date": ["month", "weekday"],
-    "vehicle": ["vehicle", "manufacturer", "model", "type", "fuel", "vin", "color"],
-    "music": ["genre"],
-    "title": "",
-    "separator": ""
-  };
-
-  // Create a Getter for all definitions.foo.bar properties
-  Object.keys(_definitions).forEach(function(d){
-    if (typeof self.definitions[d] === "undefined") {
-      self.definitions[d] = {};
-    }
-
-    if (typeof _definitions[d] === "string") {
-        self.definitions[d] = _definitions[d];
-      return;
-    }
-
-    _definitions[d].forEach(function(p){
-      Object.defineProperty(self.definitions[d], p, {
-        get: function () {
-          if (typeof self.locales[self.locale][d] === "undefined" || typeof self.locales[self.locale][d][p] === "undefined") {
-            // certain localization sets contain less data then others.
-            // in the case of a missing definition, use the default localeFallback to substitute the missing set data
-            // throw new Error('unknown property ' + d + p)
-            return self.locales[localeFallback][d][p];
-          } else {
-            // return localized data
-            return self.locales[self.locale][d][p];
-          }
-        }
-      });
-    });
-  });
-
+  var Datatype = require('./datatype');
+  self.datatype = new Datatype(self);
 };
 
 Faker.prototype.setLocale = function (locale) {
@@ -156,7 +165,9 @@ Faker.prototype.setLocale = function (locale) {
 
 Faker.prototype.seed = function(value) {
   var Random = require('./random');
+  var Datatype = require('./datatype');
   this.seedValue = value;
   this.random = new Random(this, this.seedValue);
+  this.datatype = new Datatype(this, this.seedValue);
 }
 module['exports'] = Faker;

package/lib/internet.js

@@ -12,12 +12,12 @@ var Internet = function (faker) {
    * @method faker.internet.avatar
    */
   self.avatar = function () {
-      return faker.random.arrayElement(faker.definitions.internet.avatar_uri);
+    return 'https://cdn.fakercloud.com/avatars/' + faker.random.arrayElement(faker.definitions.internet.avatar_uri);
   };
 
   self.avatar.schema = {
     "description": "Generates a URL for an avatar.",
-    "sampleResults": ["https://s3.amazonaws.com/uifaces/faces/twitter/igorgarybaldi/128.jpg"]
+    "sampleResults": ["https://cdn.fakercloud.com/avatars/sydlawrence_128.jpg"]
   };
 
   /**
@@ -29,8 +29,8 @@ var Internet = function (faker) {
    * @param {string} provider
    */
   self.email = function (firstName, lastName, provider) {
-      provider = provider || faker.random.arrayElement(faker.definitions.internet.free_email);
-      return  faker.helpers.slugify(faker.internet.userName(firstName, lastName)) + "@" + provider;
+    provider = provider || faker.random.arrayElement(faker.definitions.internet.free_email);
+    return  faker.helpers.slugify(faker.internet.userName(firstName, lastName)) + "@" + provider;
   };
 
   self.email.schema = {
@@ -62,8 +62,8 @@ var Internet = function (faker) {
    * @param {string} lastName
    */
   self.exampleEmail = function (firstName, lastName) {
-      var provider = faker.random.arrayElement(faker.definitions.internet.example_email);
-      return self.email(firstName, lastName, provider);
+    var provider = faker.random.arrayElement(faker.definitions.internet.example_email);
+    return self.email(firstName, lastName, provider);
   };
 
   /**
@@ -74,23 +74,23 @@ var Internet = function (faker) {
    * @param {string} lastName
    */
   self.userName = function (firstName, lastName) {
-      var result;
-      firstName = firstName || faker.name.firstName();
-      lastName = lastName || faker.name.lastName();
-      switch (faker.random.number(2)) {
+    var result;
+    firstName = firstName || faker.name.firstName();
+    lastName = lastName || faker.name.lastName();
+    switch (faker.datatype.number(2)) {
       case 0:
-          result = firstName + faker.random.number(99);
-          break;
+        result = firstName + faker.datatype.number(99);
+        break;
       case 1:
-          result = firstName + faker.random.arrayElement([".", "_"]) + lastName;
-          break;
+        result = firstName + faker.random.arrayElement([".", "_"]) + lastName;
+        break;
       case 2:
-          result = firstName + faker.random.arrayElement([".", "_"]) + lastName + faker.random.number(99);
-          break;
-      }
-      result = result.toString().replace(/'/g, "");
-      result = result.replace(/ /g, "");
-      return result;
+        result = firstName + faker.random.arrayElement([".", "_"]) + lastName + faker.datatype.number(99);
+        break;
+    }
+    result = result.toString().replace(/'/g, "");
+    result = result.replace(/ /g, "");
+    return result;
   };
 
   self.userName.schema = {
@@ -122,8 +122,8 @@ var Internet = function (faker) {
    * @method faker.internet.protocol
    */
   self.protocol = function () {
-      var protocols = ['http','https'];
-      return faker.random.arrayElement(protocols);
+    var protocols = ['http','https'];
+    return faker.random.arrayElement(protocols);
   };
 
   self.protocol.schema = {
@@ -131,13 +131,28 @@ var Internet = function (faker) {
     "sampleResults": ["https", "http"]
   };
 
+  /**
+   * method
+   *
+   * @method faker.internet.httpMethod
+   */
+  self.httpMethod = function () {
+    var httpMethods = ['GET','POST', 'PUT', 'DELETE', 'PATCH'];
+    return faker.random.arrayElement(httpMethods);
+  };
+
+  self.httpMethod.schema = {
+    "description": "Randomly generates HTTP Methods (GET, POST, PUT, DELETE, PATCH)",
+    "sampleResults": ["GET","POST", "PUT", "DELETE", "PATCH"]
+  };
+
   /**
    * url
    *
    * @method faker.internet.url
    */
   self.url = function () {
-      return faker.internet.protocol() + '://' + faker.internet.domainName();
+    return faker.internet.protocol() + '://' + faker.internet.domainName();
   };
 
   self.url.schema = {
@@ -154,7 +169,7 @@ var Internet = function (faker) {
    * @method faker.internet.domainName
    */
   self.domainName = function () {
-      return faker.internet.domainWord() + "." + faker.internet.domainSuffix();
+    return faker.internet.domainWord() + "." + faker.internet.domainSuffix();
   };
 
   self.domainName.schema = {
@@ -168,7 +183,7 @@ var Internet = function (faker) {
    * @method faker.internet.domainSuffix
    */
   self.domainSuffix = function () {
-      return faker.random.arrayElement(faker.definitions.internet.domain_suffix);
+    return faker.random.arrayElement(faker.definitions.internet.domain_suffix);
   };
 
   self.domainSuffix.schema = {
@@ -182,7 +197,7 @@ var Internet = function (faker) {
    * @method faker.internet.domainWord
    */
   self.domainWord = function () {
-      return faker.name.firstName().replace(/([\\~#&*{}/:<>?|\"'])/ig, '').toLowerCase();
+    return faker.name.firstName().replace(/([\\~#&*{}/:<>?|\"'])/ig, '').toLowerCase();
   };
 
   self.domainWord.schema = {
@@ -196,16 +211,16 @@ var Internet = function (faker) {
    * @method faker.internet.ip
    */
   self.ip = function () {
-      var randNum = function () {
-          return (faker.random.number(255)).toFixed(0);
-      };
+    var randNum = function () {
+      return (faker.datatype.number(255)).toFixed(0);
+    };
 
-      var result = [];
-      for (var i = 0; i < 4; i++) {
-          result[i] = randNum();
-      }
+    var result = [];
+    for (var i = 0; i < 4; i++) {
+      result[i] = randNum();
+    }
 
-      return result.join(".");
+    return result.join(".");
   };
 
   self.ip.schema = {
@@ -219,19 +234,19 @@ var Internet = function (faker) {
    * @method faker.internet.ipv6
    */
   self.ipv6 = function () {
-      var randHash = function () {
-          var result = "";
-          for (var i = 0; i < 4; i++) {
-            result += (faker.random.arrayElement(["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "a", "b", "c", "d", "e", "f"]));
-          }
-          return result
-      };
-
-      var result = [];
-      for (var i = 0; i < 8; i++) {
-        result[i] = randHash();
+    var randHash = function () {
+      var result = "";
+      for (var i = 0; i < 4; i++) {
+        result += (faker.random.arrayElement(["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "a", "b", "c", "d", "e", "f"]));
       }
-      return result.join(":");
+      return result
+    };
+
+    var result = [];
+    for (var i = 0; i < 8; i++) {
+      result[i] = randHash();
+    }
+    return result.join(":");
   };
 
   self.ipv6.schema = {
@@ -239,6 +254,20 @@ var Internet = function (faker) {
     "sampleResults": ["2001:0db8:6276:b1a7:5213:22f1:25df:c8a0"]
   };
 
+  /**
+   * port
+   * 
+   * @method faker.internet.port
+   */
+  self.port = function() {
+    return faker.datatype.number({ min: 0, max: 65535 });
+  };
+
+  self.port.schema = {
+    "description": "Generates a random port number.",
+    "sampleResults": ["4422"]
+  };
+
   /**
    * userAgent
    *
@@ -262,17 +291,17 @@ var Internet = function (faker) {
    * @param {number} baseBlue255
    */
   self.color = function (baseRed255, baseGreen255, baseBlue255) {
-      baseRed255 = baseRed255 || 0;
-      baseGreen255 = baseGreen255 || 0;
-      baseBlue255 = baseBlue255 || 0;
-      // based on awesome response : http://stackoverflow.com/questions/43044/algorithm-to-randomly-generate-an-aesthetically-pleasing-color-palette
-      var red = Math.floor((faker.random.number(256) + baseRed255) / 2);
-      var green = Math.floor((faker.random.number(256) + baseGreen255) / 2);
-      var blue = Math.floor((faker.random.number(256) + baseBlue255) / 2);
-      var redStr = red.toString(16);
-      var greenStr = green.toString(16);
-      var blueStr = blue.toString(16);
-      return '#' +
+    baseRed255 = baseRed255 || 0;
+    baseGreen255 = baseGreen255 || 0;
+    baseBlue255 = baseBlue255 || 0;
+    // based on awesome response : http://stackoverflow.com/questions/43044/algorithm-to-randomly-generate-an-aesthetically-pleasing-color-palette
+    var red = Math.floor((faker.datatype.number(256) + baseRed255) / 2);
+    var green = Math.floor((faker.datatype.number(256) + baseGreen255) / 2);
+    var blue = Math.floor((faker.datatype.number(256) + baseBlue255) / 2);
+    var redStr = red.toString(16);
+    var greenStr = green.toString(16);
+    var blueStr = blue.toString(16);
+    return '#' +
         (redStr.length === 1 ? '0' : '') + redStr +
         (greenStr.length === 1 ? '0' : '') + greenStr +
         (blueStr.length === 1 ? '0': '') + blueStr;
@@ -308,23 +337,23 @@ var Internet = function (faker) {
    * @param {string} sep
    */
   self.mac = function(sep){
-      var i, 
-        mac = "",
-        validSep = ':';
-
-      // if the client passed in a different separator than `:`, 
-      // we will use it if it is in the list of acceptable separators (dash or no separator)
-      if (['-', ''].indexOf(sep) !== -1) {
-        validSep = sep;
-      } 
-
-      for (i=0; i < 12; i++) {
-          mac+= faker.random.number(15).toString(16);
-          if (i%2==1 && i != 11) {
-              mac+=validSep;
-          }
+    var i, 
+      mac = "",
+      validSep = ':';
+
+    // if the client passed in a different separator than `:`, 
+    // we will use it if it is in the list of acceptable separators (dash or no separator)
+    if (['-', ''].indexOf(sep) !== -1) {
+      validSep = sep;
+    } 
+
+    for (i=0; i < 12; i++) {
+      mac+= faker.datatype.number(15).toString(16);
+      if (i%2==1 && i != 11) {
+        mac+=validSep;
       }
-      return mac;
+    }
+    return mac;
   };
 
   self.mac.schema = {
@@ -341,56 +370,56 @@ var Internet = function (faker) {
    * @param {string} pattern
    * @param {string} prefix
    */
-   self.password = function (len, memorable, pattern, prefix) {
-     len = len || 15;
-     if (typeof memorable === "undefined") {
-       memorable = false;
-     }
-     /*
+  self.password = function (len, memorable, pattern, prefix) {
+    len = len || 15;
+    if (typeof memorable === "undefined") {
+      memorable = false;
+    }
+    /*
       * password-generator ( function )
       * Copyright(c) 2011-2013 Bermi Ferrer <bermi@bermilabs.com>
       * MIT Licensed
       */
-     var consonant, letter, vowel;
-     letter = /[a-zA-Z]$/;
-     vowel = /[aeiouAEIOU]$/;
-     consonant = /[bcdfghjklmnpqrstvwxyzBCDFGHJKLMNPQRSTVWXYZ]$/;
-     var _password = function (length, memorable, pattern, prefix) {
-       var char, n;
-       if (length == null) {
-         length = 10;
-       }
-       if (memorable == null) {
-         memorable = true;
-       }
-       if (pattern == null) {
-         pattern = /\w/;
-       }
-       if (prefix == null) {
-         prefix = '';
-       }
-       if (prefix.length >= length) {
-         return prefix;
-       }
-       if (memorable) {
-         if (prefix.match(consonant)) {
-           pattern = vowel;
-         } else {
-           pattern = consonant;
-         }
-       }
-       n = faker.random.number(94) + 33;
-       char = String.fromCharCode(n);
-       if (memorable) {
-         char = char.toLowerCase();
-       }
-       if (!char.match(pattern)) {
-         return _password(length, memorable, pattern, prefix);
-       }
-       return _password(length, memorable, pattern, "" + prefix + char);
-     };
-     return _password(len, memorable, pattern, prefix);
-   }
+    var consonant, letter, vowel;
+    letter = /[a-zA-Z]$/;
+    vowel = /[aeiouAEIOU]$/;
+    consonant = /[bcdfghjklmnpqrstvwxyzBCDFGHJKLMNPQRSTVWXYZ]$/;
+    var _password = function (length, memorable, pattern, prefix) {
+      var char, n;
+      if (length == null) {
+        length = 10;
+      }
+      if (memorable == null) {
+        memorable = true;
+      }
+      if (pattern == null) {
+        pattern = /\w/;
+      }
+      if (prefix == null) {
+        prefix = '';
+      }
+      if (prefix.length >= length) {
+        return prefix;
+      }
+      if (memorable) {
+        if (prefix.match(consonant)) {
+          pattern = vowel;
+        } else {
+          pattern = consonant;
+        }
+      }
+      n = faker.datatype.number(94) + 33;
+      char = String.fromCharCode(n);
+      if (memorable) {
+        char = char.toLowerCase();
+      }
+      if (!char.match(pattern)) {
+        return _password(length, memorable, pattern, prefix);
+      }
+      return _password(length, memorable, pattern, "" + prefix + char);
+    };
+    return _password(len, memorable, pattern, prefix);
+  }
 
   self.password.schema = {
     "description": "Generates a random password.",