From b225be4ddc5842eabd2c3eddd42aa178db66fb05 Mon Sep 17 00:00:00 2001 From: "rob.scott" Date: Tue, 10 Mar 2015 14:35:12 +0000 Subject: Updated README to an actual markdown format. --- Readme.md | 219 ++++++++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 186 insertions(+), 33 deletions(-) diff --git a/Readme.md b/Readme.md index 4eb761a7..e4001b47 100644 --- a/Readme.md +++ b/Readme.md @@ -1,32 +1,34 @@ # faker.js - generate massive amounts of fake data in the browser and node.js - + +![faker.js](http://imgur.com/KiinQ.png) [![Build Status](https://travis-ci.org/Marak/faker.js.svg?branch=master)](https://travis-ci.org/Marak/Faker.js) ## Demo -http://marak.com/faker.js/ +[Demo Site](http://marak.com/faker.js/">http://marak.com/faker.js/) ## USAGE -### browser - +### browser - - + - -### node.js - + -### usage +### node.js - var faker = require('./faker'); + 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 + var randomName = faker.name.findName(); + // OUTPUTS: Rowan Nikolaus + var randomEmail = faker.internet.email(); + // OUTPUTS: Kassandra.Haley@erich.biz + var randomCard = faker.helpers.createCard(); + // OUTPUTS: An object containing many properties ### Localization @@ -36,34 +38,186 @@ The default language is set to English. Setting a new locale is simple: -```js -// sets locale to de -faker.locale = "de"; -``` + // sets locale to de + faker.locale = "de"; + Read further for complete list of locales. ## API - +* name + * firstName + * lastName + * findName + * prefix + * suffix +* address + * zipCode + * city + * cityPrefix + * citySuffix + * streetName + * streetAddress + * streetSuffix + * secondaryAddress + * county + * country + * state + * stateAbbr + * latitude + * longitude +* phone + * phoneNumber + * phoneNumberFormat + * phoneFormats +* internet + * avatar + * email + * userName + * domainName + * domainSuffix + * domainWord + * ip + * userAgent + * color + * password +* company + * suffixes + * companyName + * companySuffix + * catchPhrase + * catchPhraseAdjective + * catchPhraseDescriptor + * catchPhraseNoun + * bsAdjective + * bsBuzz + * bsNoun +* commerce + * color + * department + * productName + * price +* image + * image + * avatar + * imageUrl + * abstract + * animals + * business + * cats + * city + * food + * nightlife + * fashion + * people + * nature + * sports + * technics + * transport +* lorem + * words + * sentence + * sentences + * paragraph + * paragraphs +* helpers + * randomNumber + * randomize + * slugify + * replaceSymbolWithNumber + * shuffle + * mustache + * createCard + * contextualCard + * userCard + * createTransaction +* date + * past + * future + * between + * recent +* random + * number + * array_element + * object_element +* finance + * account + * accountName + * mask + * amount + * transactionType + * currencyCode + * currencyName + * currencySymbol +* hacker + * abbreviation + * adjective + * noun + * verb + * ingverb + * phrase +* locales + * de + * de_AT + * de_CH + * en + * en_AU + * en_BORK + * en_CA + * en_GB + * en_IND + * en_US + * en_au_ocker + * es + * fa + * fr + * it + * ja + * ko + * nb_NO + * nep + * nl + * pl + * pt_BR + * ru + * sk + * sv + * vi + * zh_CN +* locale + * 0 + * 1 +* localeFallback + * 0 + * 1 +* definitions + * name + * address + * company + * lorem + * hacker + * phone_number + * finance + * internet + * commerce ## Tests - npm install . - make test + + npm install . + make test -You can view a code coverage report generated in coverage/lcov-report/index.html. +You can view a code coverage report generated in `coverage/lcov-report/index.html`. ## Authors -####Matthew Bergman & Marak Squires +#### Matthew Bergman & Marak Squires -
Copyright (c) 2014 Matthew Bergman & Marak Squires http://github.com/marak/faker.js/ -
-faker.js was inspired by and has used data definitions from -
- https://github.com/stympy/faker/ - Copyright (c) 2007-2010 Benjamin Curtis
- http://search.cpan.org/~jasonk/Data-Faker-0.07/ - Copyright 2004-2005 by Jason Kohles
+faker.js was inspired by and has used data definitions from: + +* [https://github.com/stympy/faker/](https://github.com/stympy/faker/) - Copyright (c) 2007-2010 Benjamin Curtis
+* [http://search.cpan.org/~jasonk/Data-Faker-0.07/](http://search.cpan.org/~jasonk/Data-Faker-0.07/) - Copyright 2004-2005 by Jason Kohles Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the @@ -72,11 +226,10 @@ 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 + +* 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, +* 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 -- cgit v1.2.3