faker 1.0.0

package/.jshintignore

@@ -0,0 +1,3 @@
+lib/definitions.js
+lib/version.js
+lib/helpers.js

package/.jshintrc

@@ -0,0 +1,87 @@
+{
+    // Settings
+    "passfail"      : false,  // Stop on first error.
+    "maxerr"        : 500,    // Maximum errors before stopping.
+    "multistr"      : true,
+
+
+    // Predefined globals whom JSHint will ignore.
+    "browser"       : true,   // Standard browser globals e.g. `window`, `document`.
+
+    "node"          : false,
+    "rhino"         : false,
+    "couch"         : false,
+    "wsh"           : true,   // Windows Scripting Host.
+
+    "jquery"        : true,
+    "prototypejs"   : false,
+    "mootools"      : false,
+    "dojo"          : false,
+
+    "predef"        : [  // Extra globals.
+        "__dirname",
+        "Buffer", 
+        "event",
+        "exports",
+        "global",
+        "logger", 
+        "module",
+        "process",
+        "require",
+
+        "after",
+        "afterEach",
+        "before",
+        "beforeEach",
+        "context",
+        "describe",
+        "it"
+    ],
+
+    // Development.
+    "debug"         : false,  // Allow debugger statements e.g. browser breakpoints.
+    "devel"         : true,   // Allow development statements e.g. `console.log();`.
+
+
+    // EcmaScript 5.
+    "es5"           : false,   // Allow EcmaScript 5 syntax.
+    "strict"        : false,  // Require `use strict` pragma in every file.
+    "globalstrict"  : false,  // Allow global "use strict" (also enables 'strict').
+
+
+    "asi"           : false,  // Tolerate Automatic Semicolon Insertion (no semicolons).
+    "laxbreak"      : false,  // Tolerate unsafe line breaks e.g. `return [\n] x` without semicolons.
+    "bitwise"       : true,   // Prohibit bitwise operators (&, |, ^, etc.).
+    "boss"          : false,  // Tolerate assignments inside if, for & while. Usually conditions & loops are for comparison, not assignments.
+    "curly"         : true,   // Require {} for every new block or scope.
+    "eqeqeq"        : false,  // Require triple equals i.e. `===`.
+    "eqnull"        : false,  // Tolerate use of `== null`.
+    "evil"          : false,  // Tolerate use of `eval`.
+    "expr"          : false,  // Tolerate `ExpressionStatement` as Programs.
+    "forin"         : false,  // Tolerate `for in` loops without `hasOwnProperty`.
+    "immed"         : true,   // Require immediate invocations to be wrapped in parens e.g. `( function(){}() );`
+    "latedef"       : true,   // Prohibit variable use before definition.
+    "loopfunc"      : true,   // Allow functions to be defined within loops.
+    //"maxparams"   : 4,
+    //"maxdepth"      : 5,
+    //"maxcomplexity" : 10,
+    "noarg"         : true,   // Prohibit use of `arguments.caller` and `arguments.callee`.
+    "regexp"        : false,  // Prohibit `.` and `[^...]` in regular expressions.
+    "regexdash"     : false,  // Tolerate unescaped last dash i.e. `[-...]`.
+    "scripturl"     : true,   // Tolerate script-targeted URLs.
+    "shadow"        : false,  // Allows re-define variables later in code e.g. `var x=1; x=2;`.
+    "supernew"      : false,  // Tolerate `new function () { ... };` and `new Object;`.
+    "undef"         : true,   // Require all non-global variables be declared before they are used.
+
+
+    "newcap"        : false,  // Require capitalization of all constructor functions e.g. `new F()`.
+    "noempty"       : true,   // Prohibit use of empty blocks.
+    "nonew"         : false,  // Prohibit use of constructors for side-effects.
+    "nomen"         : false,  // Prohibit use of initial or trailing underbars in names.
+    "onevar"        : false,  // Allow only one `var` statement per function.
+    "plusplus"      : false,  // Prohibit use of `++` & `--`.
+    "sub"           : true,  // Tolerate all forms of subscript notation besides dot notation e.g. `dict['key']` instead of `dict.key`.
+    "trailing"      : true,  // Prohibit trailing whitespaces. (only works if white is 'true')
+    "white"         : true,  // Check against strict whitespace and indentation rules.
+    "indent"        : 4      //
+}

package/.npmignore

@@ -0,0 +1,16 @@
+TAGS
+REVISION
+*.tmproj
+*~
+.DS_Store
+.settings
+.project
+.tasks-cache
+.svn
+*DONOTVERSION*
+/nbproject
+/.idea
+lib-cov
+node_modules/
+/npm-debug.log
+/coverage

package/.travis.yml

@@ -0,0 +1,5 @@
+language: node_js
+node_js:
+  - "0.11"
+  - "0.10"
+  - "0.8"

package/BUILD/BUILD.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+
+var sys = require('sys')
+	, fs = require('fs')
+	, M = require('./Mustache')
+	, compressor = require('node-minify');
+
+var package = require('../package.json');
+var code = '';
+var docs = {};
+
+docs.main = '';
+docs.API = '';
+docs.copyrightYear = new Date().getFullYear();
+
+// read in the the main.js file as our main boilerplate code
+code += fs.readFileSync('./main.js', encoding = 'utf8');
+code = M.Mustache.to_html(code, {'today': new Date().getTime(), 'version': package.version});
+
+docs.main += fs.readFileSync('./docs.js', encoding = 'utf8');
+
+// parse entire lib directory and concat it into one file for the browser
+var lib = paths('./lib');
+
+var faker = require('../index');
+
+// generate bundle for code on the browser
+for (var module in faker) {
+	code += ( '\n' + 'faker.' + module + ' = {};');
+	for (var method in faker[module]) {
+		code += ( '\n' + 'faker.' + module);
+		code += ( '.' + method + ' = ');
+
+		// serialize arrays as JSON, otherwise use simple string conversion
+		var methodValue = faker[module][method];
+		if (Array.isArray(methodValue)) {
+			code += JSON.stringify(methodValue) + ';\n';
+		} else {
+			code += (methodValue.toString() + ';\n');
+		}
+	}
+}
+
+// generate nice tree of api for docs
+docs.API += '<ul>';
+for (var module in faker) {
+	docs.API += '<li>' + module;
+	docs.API += '<ul>';
+	for (var method in faker[module]) {
+		docs.API += '<li>' + method + '</li>';
+	}
+	docs.API += '</ul>';
+	docs.API += '</li>';
+}
+docs.API += '</ul>';
+
+// definitions hack
+code += 'var definitions = faker.definitions;\n';
+code += 'var Helpers = faker.Helpers;\n';
+
+// if we are running in a CommonJS env, export everything out
+code +=["\nif (typeof define == 'function'){",
+"   define(function(){",
+"		return faker;",
+"   });",
+"}",
+"else if(typeof module !== 'undefined' && module.exports) {",
+"	module.exports = faker;",
+"}",
+"else {",
+"	window.faker = faker;",
+"}",
+"",
+"}()); // end faker closure"].join('\n');
+
+// generate core library
+fs.writeFile('../faker.js', code, function() {
+	sys.puts("faker.js generated successfully!");
+});
+
+// generate example js file as well
+fs.writeFile('../examples/js/faker.js', code, function() {
+	sys.puts("faker.js generated successfully!");
+});
+
+var docOutput = M.Mustache.to_html(docs.main, {"API": docs.API, "copyrightYear": docs.copyrightYear});
+
+// generate some samples sets (move this code to another section)
+fs.writeFile('../Readme.md', docOutput, function() {
+	sys.puts("Docs generated successfully!");
+});
+
+// generates minified version Using Google Closure
+new compressor.minify({
+    type: 'gcc',
+    fileIn: '../faker.js',
+    fileOut: '../minfaker.js',
+    callback: function(err){
+			if(err) {
+        console.log(err);
+      }
+      else sys.puts("Minified version generated successfully!");
+    }
+});
+
+
+/*********************** BUILD HELPER METHODS *********************/
+
+	// Recursively traverse a hierarchy, returning a list of all relevant .js files.
+function paths(dir) {
+	var paths = [];
+
+	try {
+		fs.statSync(dir);
+	}
+	catch (e) {
+		return e;
+	}
+
+	(function traverse(dir, stack) {
+		stack.push(dir);
+		fs.readdirSync(stack.join('/')).forEach(function(file) {
+			var path = stack.concat([file]).join('/'),
+				stat = fs.statSync(path);
+
+			if (file[0] == '.' || file === 'vendor') {
+				return;
+			} else if (stat.isFile() && /\.js$/.test(file)) {
+				paths.push(path);
+			} else if (stat.isDirectory()) {
+				paths.push(path);
+				traverse(file, stack);
+			}
+		});
+		stack.pop();
+	})(dir || '.', []);
+
+	return paths;
+}

package/BUILD/Mustache.js

@@ -0,0 +1,296 @@
+/*
+  mustache.js — Logic-less templates in JavaScript
+
+  See http://mustache.github.com/ for more info.
+*/
+
+var Mustache = exports.Mustache =  function() {
+  var Renderer = function() {};
+
+  Renderer.prototype = {
+    otag: "{{",
+    ctag: "}}",
+    pragmas: {},
+    buffer: [],
+    pragmas_implemented: {
+      "IMPLICIT-ITERATOR": true
+    },
+
+    render: function(template, context, partials, in_recursion) {
+      // fail fast
+      if(template.indexOf(this.otag) == -1) {
+        if(in_recursion) {
+          return template;
+        } else {
+          this.send(template);
+          return;
+        }
+      }
+
+      if(!in_recursion) {
+        this.buffer = [];
+      }
+
+      template = this.render_pragmas(template);
+      var html = this.render_section(template, context, partials);
+      if(in_recursion) {
+        return this.render_tags(html, context, partials, in_recursion);
+      }
+
+      this.render_tags(html, context, partials, in_recursion);
+    },
+
+    /*
+      Sends parsed lines
+    */
+    send: function(line) {
+      if(line != "") {
+        this.buffer.push(line);
+      }
+    },
+
+    /*
+      Looks for %PRAGMAS
+    */
+    render_pragmas: function(template) {
+      // no pragmas
+      if(template.indexOf(this.otag + "%") == -1) {
+        return template;
+      }
+
+      var that = this;
+      var regex = new RegExp(this.otag + "%([\\w_-]+) ?([\\w]+=[\\w]+)?"
+        + this.ctag);
+      return template.replace(regex, function(match, pragma, options) {
+        if(!that.pragmas_implemented[pragma]) {
+          throw({message: "This implementation of mustache doesn't understand the '"
+            + pragma + "' pragma"});
+        }
+        that.pragmas[pragma] = {};
+        if(options) {
+          var opts = options.split("=");
+          that.pragmas[pragma][opts[0]] = opts[1];
+        }
+        return "";
+        // ignore unknown pragmas silently
+      });
+    },
+
+    /*
+      Tries to find a partial in the global scope and render it
+    */
+    render_partial: function(name, context, partials) {
+      if(!partials || !partials[name]) {
+        throw({message: "unknown_partial '" + name + "'"});
+      }
+      if(typeof(context[name]) != "object") {
+        return partials[name];
+      }
+      return this.render(partials[name], context[name], partials, true);
+    },
+
+    /*
+      Renders boolean and enumerable sections
+    */
+    render_section: function(template, context, partials) {
+      if(template.indexOf(this.otag + "#") == -1) {
+        return template;
+      }
+      var that = this;
+      // CSW - Added "+?" so it finds the tighest bound, not the widest
+      var regex = new RegExp(this.otag + "\\#(.+)" + this.ctag +
+              "\\s*([\\s\\S]+?)" + this.otag + "\\/\\1" + this.ctag + "\\s*", "mg");
+
+      // for each {{#foo}}{{/foo}} section do...
+      return template.replace(regex, function(match, name, content) {
+        var value = that.find(name, context);
+        if(that.is_array(value)) { // Enumerable, Let's loop!
+          return that.map(value, function(row) {
+            return that.render(content, that.merge(context,
+                    that.create_context(row)), partials, true);
+          }).join("");
+        } else if(value) { // boolean section
+          return that.render(content, context, partials, true);
+        } else {
+          return "";
+        }
+      });
+    },
+
+    /*
+      Replace {{foo}} and friends with values from our view
+    */
+    render_tags: function(template, context, partials, in_recursion) {
+      // tit for tat
+      var that = this;
+
+      var new_regex = function() {
+        return new RegExp(that.otag + "(=|!|>|\\{|%)?([^\/#]+?)\\1?" +
+          that.ctag + "+", "g");
+      };
+
+      var regex = new_regex();
+      var lines = template.split("\n");
+       for (var i=0; i < lines.length; i++) {
+         lines[i] = lines[i].replace(regex, function(match, operator, name) {
+           switch(operator) {
+             case "!": // ignore comments
+               return match;
+             case "=": // set new delimiters, rebuild the replace regexp
+               that.set_delimiters(name);
+               regex = new_regex();
+               return "";
+             case ">": // render partial
+               return that.render_partial(name, context, partials);
+             case "{": // the triple mustache is unescaped
+               return that.find(name, context);
+             default: // escape the value
+               return that.escape(that.find(name, context));
+           }
+         }, this);
+         if(!in_recursion) {
+           this.send(lines[i]);
+         }
+       }
+
+       if(in_recursion) {
+         return lines.join("\n");
+       }
+    },
+
+    set_delimiters: function(delimiters) {
+      var dels = delimiters.split(" ");
+      this.otag = this.escape_regex(dels[0]);
+      this.ctag = this.escape_regex(dels[1]);
+    },
+
+    escape_regex: function(text) {
+      // thank you Simon Willison
+      if(!arguments.callee.sRE) {
+        var specials = [
+          '/', '.', '*', '+', '?', '|',
+          '(', ')', '[', ']', '{', '}', '\\'
+        ];
+        arguments.callee.sRE = new RegExp(
+          '(\\' + specials.join('|\\') + ')', 'g'
+        );
+      }
+    return text.replace(arguments.callee.sRE, '\\$1');
+    },
+
+    /*
+      find `name` in current `context`. That is find me a value
+      from the view object
+    */
+    find: function(name, context) {
+      name = this.trim(name);
+      if(typeof context[name] === "function") {
+        return context[name].apply(context);
+      }
+      if(context[name] !== undefined) {
+        return context[name];
+      }
+      // silently ignore unkown variables
+      return "";
+    },
+
+    // Utility methods
+
+    /*
+      Does away with nasty characters
+    */
+    escape: function(s) {
+      return ((s == null) ? "" : s).toString().replace(/[&"<>\\]/g, function(s) {
+        switch(s) {
+          case "&": return "&amp;";
+          case "\\": return "\\\\";;
+          case '"': return '\"';;
+          case "<": return "&lt;";
+          case ">": return "&gt;";
+          default: return s;
+        }
+      });
+    },
+
+    /*
+      Merges all properties of object `b` into object `a`.
+      `b.property` overwrites a.property`
+    */
+    merge: function(a, b) {
+      var _new = {};
+      for(var name in a) {
+        if(a.hasOwnProperty(name)) {
+          _new[name] = a[name];
+        }
+      };
+      for(var name in b) {
+        if(b.hasOwnProperty(name)) {
+          _new[name] = b[name];
+        }
+      };
+      return _new;
+    },
+
+    // by @langalex, support for arrays of strings
+    create_context: function(_context) {
+      if(this.is_object(_context)) {
+        return _context;
+      } else if(this.pragmas["IMPLICIT-ITERATOR"]) {
+        var iterator = this.pragmas["IMPLICIT-ITERATOR"].iterator || ".";
+        var ctx = {};
+        ctx[iterator] = _context;
+        return ctx;
+      }
+    },
+
+    is_object: function(a) {
+      return a && typeof a == "object";
+    },
+
+    is_array: function(a) {
+      return Object.prototype.toString.call(a) === '[object Array]';
+    },
+
+    /*
+      Gets rid of leading and trailing whitespace
+    */
+    trim: function(s) {
+      return s.replace(/^\s*|\s*$/g, "");
+    },
+
+    /*
+      Why, why, why? Because IE. Cry, cry cry.
+    */
+    map: function(array, fn) {
+      if (typeof array.map == "function") {
+        return array.map(fn);
+      } else {
+        var r = [];
+        var l = array.length;
+        for(var i=0;i<l;i++) {
+          r.push(fn(array[i]));
+        }
+        return r;
+      }
+    }
+  };
+
+  return({
+    name: "mustache.js",
+    version: "0.2.3",
+
+    /*
+      Turns a template and view into HTML
+    */
+    to_html: function(template, view, partials, send_fun) {
+      var renderer = new Renderer();
+      if(send_fun) {
+        renderer.send = send_fun;
+      }
+      renderer.render(template, view, partials);
+      if(!send_fun) {
+        return renderer.buffer.join("\n");
+      }
+    }
+  });
+}();

package/BUILD/docs.js

@@ -0,0 +1,62 @@
+# faker.js - generate massive amounts of fake data in the browser and node.js
+<img src = "http://imgur.com/KiinQ.png" border = "0">
+
+## USAGE
+
+### browser -
+
+      <script src = "faker.js" type = "text/javascript"></script>
+      <script>
+        var randomName = faker.Name.findName(); // Caitlyn Kerluke
+        var randomEmail = faker.Internet.email(); // Rusty@arne.info
+        var randomCard = faker.Helpers.createCard(); // random contact card containing many properties
+      </script>
+
+### node.js -
+
+### usage
+
+      var faker = require('./faker');
+
+      var randomName = faker.Name.findName(); // Rowan Nikolaus
+      var randomEmail = faker.Internet.email(); // Kassandra.Haley@erich.biz
+      var randomCard = faker.Helpers.createCard(); // random contact card containing many properties
+
+
+## API
+
+{{{API}}}
+
+## Tests
+       npm install .
+       make test
+
+You can view a code coverage report generated in coverage/lcov-report/index.html.
+
+## Authors
+
+####Matthew Bergman & Marak Squires
+
+Heavily inspired by Benjamin Curtis's Ruby Gem [faker](http://faker.rubyforge.org/) and Perl's [Data::faker](http://search.cpan.org/~jasonk/Data-faker-0.07/lib/Data/faker.pm)
+
+<br/>
+Copyright (c) {{copyrightYear}} Matthew Bergman & Marak Squires http://github.com/marak/faker.js/
+<br/>
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+<br/>
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+<br/>
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/BUILD/main.js

@@ -0,0 +1,60 @@
+/*
+Copyright (c) 2010 Matthew Bergman & Marak Squires http://github.com/marak/faker.js/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*/
+
+/*************** AUTOGENERATED @ {{today}} ***************
+
+    WARNING: THIS FILE WAS AUTOGENERATED BY THE faker BUILD SCRIPT
+    MODIFYING THIS FILE IS FINE, BUT YOU REALLY SHOULD BE MODIFYING
+    THE LIBRARY DIRECTLY AND REGENERATING THIS FILE USING BUILD.js!!!!
+
+
+    faker.js - Written by Matthew Bergman and Marak Squires
+
+    ## USAGE
+
+    ### browser -
+
+          <script src = "faker.js" type = "text/javascript"></script>
+          <script>
+            var randomName = faker.Name.findName(); // Caitlyn Kerluke
+            var randomEmail = faker.Internet.email(); // Rusty@arne.info
+            var randomCard = faker.Helpers.createCard(); // random contact card containing many properties
+          </script>
+
+    ### node.js -
+
+          var faker = require('./faker');
+
+          var randomName = faker.Name.findName(); // Rowan Nikolaus
+          var randomEmail = faker.Internet.email(); // Kassandra.Haley@erich.biz
+          var randomCard = faker.Helpers.createCard(); // random contact card containing many properties
+
+*/
+!(function(){
+
+'use strict';
+
+// exported module
+var faker = {};
+
+faker.version = "{{version}}";

package/MIT-LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Matthew Bergman & Marak Squires http://github.com/marak/faker.js/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.