{ "_args": [ [ { "raw": "randomatic@^1.1.3", "scope": null, "escapedName": "randomatic", "name": "randomatic", "rawSpec": "^1.1.3", "spec": ">=1.1.3 <2.0.0", "type": "range" }, "/home/jdaugherty/work/GT2/GT2-Android/node_modules/fill-range" ] ], "_from": "randomatic@>=1.1.3 <2.0.0", "_id": "randomatic@1.1.7", "_inCache": true, "_location": "/randomatic", "_nodeVersion": "7.7.3", "_npmOperationalInternal": { "host": "s3://npm-registry-packages", "tmp": "tmp/randomatic-1.1.7.tgz_1497052370312_0.7579707570839673" }, "_npmUser": { "name": "jonschlinkert", "email": "github@sellside.com" }, "_npmVersion": "5.0.3", "_phantomChildren": { "is-buffer": "1.1.6" }, "_requested": { "raw": "randomatic@^1.1.3", "scope": null, "escapedName": "randomatic", "name": "randomatic", "rawSpec": "^1.1.3", "spec": ">=1.1.3 <2.0.0", "type": "range" }, "_requiredBy": [ "/fill-range" ], "_resolved": "https://registry.npmjs.org/randomatic/-/randomatic-1.1.7.tgz", "_shasum": "c7abe9cc8b87c0baa876b19fde83fd464797e38c", "_shrinkwrap": null, "_spec": "randomatic@^1.1.3", "_where": "/home/jdaugherty/work/GT2/GT2-Android/node_modules/fill-range", "author": { "name": "Jon Schlinkert", "url": "https://github.com/jonschlinkert" }, "bugs": { "url": "https://github.com/jonschlinkert/randomatic/issues" }, "contributors": [ { "name": "Bogdan Chadkin", "url": "https://github.com/TrySound" }, { "name": "Dragos Fotescu", "url": "http://dragosfotescu.com" }, { "name": "Jon Schlinkert", "url": "http://twitter.com/jonschlinkert" }, { "name": "Paul Miller", "url": "paulmillr.com" }, { "name": "Sun Knudsen", "url": "http://sunknudsen.com" } ], "dependencies": { "is-number": "^3.0.0", "kind-of": "^4.0.0" }, "description": "Generate randomized strings of a specified length, fast. Only the length is necessary, but you can optionally generate patterns using any combination of numeric, alpha-numeric, alphabetical, special or custom characters.", "devDependencies": { "ansi-bold": "^0.1.1", "benchmarked": "^1.1.1", "glob": "^7.1.2", "gulp-format-md": "^0.1.12", "mocha": "^3.4.2", "should": "^11.2.1" }, "directories": {}, "dist": { "integrity": "sha512-D5JUjPyJbaJDkuAazpVnSfVkLlpeO3wDlPROTMLGKG1zMFNFRgrciKo1ltz/AzNTkqE0HzDx655QOL51N06how==", "shasum": "c7abe9cc8b87c0baa876b19fde83fd464797e38c", "tarball": "https://registry.npmjs.org/randomatic/-/randomatic-1.1.7.tgz" }, "engines": { "node": ">= 0.10.0" }, "files": [ "index.js" ], "gitHead": "d91c5f90e785db08a9b9e518926b444671092f26", "homepage": "https://github.com/jonschlinkert/randomatic", "keywords": [ "alpha", "alpha-numeric", "alphanumeric", "characters", "chars", "numeric", "rand", "random", "randomatic", "randomize", "randomized" ], "license": "MIT", "main": "index.js", "maintainers": [ { "name": "doowb", "email": "brian.woodward@gmail.com" }, { "name": "jonschlinkert", "email": "github@sellside.com" } ], "name": "randomatic", "optionalDependencies": {}, "readme": "# randomatic [![NPM version](https://img.shields.io/npm/v/randomatic.svg?style=flat)](https://www.npmjs.com/package/randomatic) [![NPM monthly downloads](https://img.shields.io/npm/dm/randomatic.svg?style=flat)](https://npmjs.org/package/randomatic) [![NPM total downloads](https://img.shields.io/npm/dt/randomatic.svg?style=flat)](https://npmjs.org/package/randomatic) [![Linux Build Status](https://img.shields.io/travis/jonschlinkert/randomatic.svg?style=flat&label=Travis)](https://travis-ci.org/jonschlinkert/randomatic)\n\n> Generate randomized strings of a specified length, fast. Only the length is necessary, but you can optionally generate patterns using any combination of numeric, alpha-numeric, alphabetical, special or custom characters.\n\n## Install\n\nInstall with [npm](https://www.npmjs.com/):\n\n```sh\n$ npm install --save randomatic\n```\n\n## Usage\n\n```js\nvar randomize = require('randomatic');\n```\n\n## API\n\n```js\nrandomize(pattern, length, options);\n```\n\n* `pattern` **{String}**: The pattern to use for randomizing\n* `length` **{Object}**: The length of the string to generate\n\n### pattern\n\n> The pattern to use for randomizing\n\nPatterns can contain any combination of the below characters, specified in any order.\n\n**Example:**\n\nTo generate a 10-character randomized string using all available characters:\n\n```js\nrandomize('*', 10);\n//=>\n\nrandomize('Aa0!', 10);\n//=>\n```\n\n* `a`: Lowercase alpha characters (`abcdefghijklmnopqrstuvwxyz'`)\n* `A`: Uppercase alpha characters (`ABCDEFGHIJKLMNOPQRSTUVWXYZ'`)\n* `0`: Numeric characters (`0123456789'`)\n* `!`: Special characters (`~!@#$%^&()_+-={}[];\\',.`)\n* `*`: All characters (all of the above combined)\n* `?`: Custom characters (pass a string of custom characters to the options)\n\n### length\n\n> the length of the string to generate\n\n**Examples:**\n\n* `randomize('A', 5)` will generate a 5-character, uppercase, alphabetical, randomized string, e.g. `KDJWJ`.\n* `randomize('0', 2)` will generate a 2-digit random number\n* `randomize('0', 3)` will generate a 3-digit random number\n* `randomize('0', 12)` will generate a 12-digit random number\n* `randomize('A0', 16)` will generate a 16-character, alpha-numeric randomized string\n\nIf `length` is left undefined, the length of the pattern in the first parameter will be used. For example:\n\n* `randomize('00')` will generate a 2-digit random number\n* `randomize('000')` will generate a 3-digit random number\n* `randomize('0000')` will generate a 4-digit random number...\n* `randomize('AAAAA')` will generate a 5-character, uppercase alphabetical random string...\n\nThese are just examples, [see the tests](./test.js) for more use cases and examples.\n\n#### chars\n\nType: `String`\n\nDefault: `undefined`\n\nDefine a custom string to be randomized.\n\n**Example:**\n\n* `randomize('?', 20, {chars: 'jonschlinkert'})` will generate a 20-character randomized string from the letters contained in `jonschlinkert`.\n* `randomize('?', {chars: 'jonschlinkert'})` will generate a 13-character randomized string from the letters contained in `jonschlinkert`.\n\n## Usage Examples\n\n* `randomize('A', 4)` (_whitespace insenstive_) would result in randomized 4-digit uppercase letters, like, `ZAKH`, `UJSL`... etc.\n* `randomize('AAAA')` is equivelant to `randomize('A', 4)`\n* `randomize('AAA0')` and `randomize('AA00')` and `randomize('A0A0')` are equivelant to `randomize('A0', 4)`\n* `randomize('aa')`: results in double-digit, randomized, lower-case letters (`abcdefghijklmnopqrstuvwxyz`)\n* `randomize('AAA')`: results in triple-digit, randomized, upper-case letters (`ABCDEFGHIJKLMNOPQRSTUVWXYZ`)\n* `randomize('0', 6)`: results in six-digit, randomized numbers (`0123456789`)\n* `randomize('!', 5)`: results in single-digit randomized, _valid_ non-letter characters (`~!@#$%^&()_+-={}[]\n* `randomize('A!a0', 9)`: results in nine-digit, randomized characters (any of the above)\n\n_The order in which the characters are defined is insignificant._\n\n## About\n\n### Related projects\n\n* [pad-left](https://www.npmjs.com/package/pad-left): Left pad a string with zeros or a specified string. Fastest implementation. | [homepage](https://github.com/jonschlinkert/pad-left \"Left pad a string with zeros or a specified string. Fastest implementation.\")\n* [pad-right](https://www.npmjs.com/package/pad-right): Right pad a string with zeros or a specified string. Fastest implementation. | [homepage](https://github.com/jonschlinkert/pad-right \"Right pad a string with zeros or a specified string. Fastest implementation.\")\n* [repeat-string](https://www.npmjs.com/package/repeat-string): Repeat the given string n times. Fastest implementation for repeating a string. | [homepage](https://github.com/jonschlinkert/repeat-string \"Repeat the given string n times. Fastest implementation for repeating a string.\")\n\n### Contributing\n\nPull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).\n\n### Contributors\n\n| **Commits** | **Contributor** | \n| --- | --- |\n| 41 | [jonschlinkert](https://github.com/jonschlinkert) |\n| 1 | [TrySound](https://github.com/TrySound) |\n| 1 | [Drag0s](https://github.com/Drag0s) |\n| 1 | [paulmillr](https://github.com/paulmillr) |\n| 1 | [sunknudsen](https://github.com/sunknudsen) |\n\n### Building docs\n\n_(This project's readme.md is generated by [verb](https://github.com/verbose/verb-generate-readme), please don't edit the readme directly. Any changes to the readme must be made in the [.verb.md](.verb.md) readme template.)_\n\nTo generate the readme, run the following command:\n\n```sh\n$ npm install -g verbose/verb#dev verb-generate-readme && verb\n```\n\n### Running tests\n\nRunning and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:\n\n```sh\n$ npm install && npm test\n```\n\n### Author\n\n**Jon Schlinkert**\n\n* [github/jonschlinkert](https://github.com/jonschlinkert)\n* [twitter/jonschlinkert](https://twitter.com/jonschlinkert)\n\n### License\n\nCopyright © 2017, [Jon Schlinkert](https://github.com/jonschlinkert).\nReleased under the [MIT License](LICENSE).\n\n***\n\n_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.6.0, on June 09, 2017._", "readmeFilename": "README.md", "repository": { "type": "git", "url": "git+https://github.com/jonschlinkert/randomatic.git" }, "scripts": { "test": "mocha" }, "verb": { "toc": false, "layout": "default", "tasks": [ "readme" ], "plugins": [ "gulp-format-md" ], "related": { "list": [ "pad-left", "pad-right", "repeat-string" ] }, "lint": { "reflinks": true }, "reflinks": [ "verb", "verb-generate-readme" ] }, "version": "1.1.7" }