{"id":16188264,"url":"https://github.com/konsumer/randopeep","last_synced_at":"2025-03-19T03:30:39.774Z","repository":{"id":10233950,"uuid":"12335919","full_name":"konsumer/randopeep","owner":"konsumer","description":"Generate random fake data, in javascript, based on data files \u0026 functions","archived":false,"fork":false,"pushed_at":"2020-05-23T11:50:38.000Z","size":1970,"stargazers_count":9,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-19T21:42:47.538Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://konsumer.github.io/randopeep/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/konsumer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-24T01:06:18.000Z","updated_at":"2022-03-20T21:05:01.000Z","dependencies_parsed_at":"2022-08-31T11:13:38.053Z","dependency_job_id":null,"html_url":"https://github.com/konsumer/randopeep","commit_stats":null,"previous_names":["konsumer/randopeeps"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Frandopeep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Frandopeep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Frandopeep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Frandopeep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/konsumer","download_url":"https://codeload.github.com/konsumer/randopeep/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244350660,"owners_count":20439284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T07:25:40.593Z","updated_at":"2025-03-19T03:30:39.200Z","avatar_url":"https://github.com/konsumer.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Rando Peeps Data](http://konsumer.github.io/randopeep/)\n\n[![Greenkeeper badge](https://badges.greenkeeper.io/konsumer/randopeep.svg)](https://greenkeeper.io/)\n\nOriginally I made this for generating fake NPCs for RPGs \u0026 fake accounts for things online.\n\n![Peeps](http://68.media.tumblr.com/ab6873991500bef6c1952724594fc7e2/tumblr_inline_n4c3qgSe901r6s53m.jpg)\n\n[![NPM](https://nodei.co/npm/randopeep.png)](https://nodei.co/npm/randopeep/)\n[![Build Status](https://travis-ci.org/konsumer/randopeep.png?branch=master)](https://travis-ci.org/konsumer/randopeep)\n[Demo](http://konsumer.github.io/randopeep/)\n\n## What random stuff can it generate?\n\nAll parameters are optional.\n\n`n` parameters is how many you would like, leave blank for 1.\n\n### People\n\n* `randopeep.name(params, n)` - a person's name, `params` are explained below\n* `randopeep.job(n)` - a job a person might do\n* `randopeep.invention(n)` - a seemingly awesome-sounding invention\n\n#### `params`\n\nA lot of different types of names can be generated. All parameters are optional, here are the defaults:\n\n```javascript\n{\n\t'origin' : random - 'chinese', 'elven/dark', 'dwarven','elven', 'english', 'germanic','japanese','orcish','spanish','netrunner',\n\t'gender': random - 'male','female',\n\t'last': true,\n\t'justLast': false,\n\t'prefix': random - true, false,\n\t'returnData': false,\n}\n```\n\n* `origin` - the place/time the names come from\n* `gender` - male/female, if names are gendered\n* `last` - get a lastname?\n* `justLast` - get lastname only?\n* `prefix` - look up gendered prefix, if applicable\n* `returnData` - return options (as generated) with `name` field, good if you want random gender/origin, but want to know about it after\n\nIf you set any of them to an array, it will pick a random element.\n\n### Places\n\n* `randopeep.address.state(n)` - a US state\n* `randopeep.address.state.a(n)` - an abbreviated US state\n* `randopeep.address.zip(n)` - a zipcode\n* `randopeep.address.city(n)` - a pretend city\n* `randopeep.address.geo(n)` - a geolocation\n* `randopeep.address.streetName(n)` - a streetName\n* `randopeep.address.streetAddress(useFullAddress, n)` - a street address, set useFullAddress to get secondary address\n* `randopeep.address.phone(n)` - a phone number\n* `randopeep.address.uk.country(n)` - a country in the UK\n* `randopeep.address.uk.county(n)` - a county in the UK\n\n\n### Credit-card Numbers\n\n* `randopeep.cc(type, charCount, n)` - a credit-card, `type` is \"visa\", \"mastercard\", \"amex\", or \"discover\". `charCount` should be 13 or 16\n\n\n### Corporate Things\n\n* `randopeep.corporate.name(type, n)` - a corporate name, `type` is explained below\n* `randopeep.corporate.catchPhrase(n)` - `n` corporate catchphrases\n* `randopeep.corporate.bs(n)` - `n` lines of corporate BS\n\n#### `type`\n\nIt can be one of these:\n\n* `cyber` -  a company from the retrofuture\n* `firm` - a law-firm, all last names are random non-fantasy, but from the same origin\n* `small` - a small company\n* `large` - a large corp\n\n\n### Internet Things\n\n* `randopeep.internet.ip(n)` - an IP address\n* `randopeep.internet.domain(derived, n)` - a internet domainname, `derived` is explained, below\n* `randopeep.internet.email(derived, n)` - an email address, `derived` is explained, below\n* `randopeep.internet.username(derived, n)` - an internet username, `derived` is explained, below\n\n#### `derived`\n\nWill attempt to use the text that you give it as a base for generating other things.  Makes more-legit looking email, if you already know the name, for example.\n\n\n\n### Random Text\n\n* `randopeep.ipsum(n, list)` - `n` words from ipsum `list`, default list is \"lorem\" and default count is 200\n\n### Clickbait\n\n* `randopeep.clickbait.headline(star, n)` - a clickbait headline, `star` is the optional name of a star for the headline to be about\n* `randopeep.clickbait.star(n)` - a star from a headline\n\n### Other stuff\n\n* `randopeep.data` - the raw data, keyed by list name\n* `randopeep.get(list, n)` - `n` items from `list`\n\n\n## Usage\n\nSee unit-tests in [test/test.js](https://github.com/konsumer/randopeep/blob/master/test/test.js) if you need more details.\n\n### Node\n\nInstall: `npm install randopeep`\n\nin your code:\n\n```javascript\nconst randopeep = require('randopeep')\nconst myFakeName = randopeep.name()\n```\n\n### Browser\n\nJust include `randopeep.js` in your thing, and use it like normal:\n\n```html\n\u003cscript src=\"http://konsumer.js.org/randopeep/randopeep.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  document.body.innerHTML = \"I'm cool dude named \" + randopeep.name({gender:'male'})\n\u003c/script\u003e\n```\n\nThere is also support for AMD/require.js, just put out/randopeep.js in your application dir, and do this:\n\n```javascript\ndefine(['randopeep'], function(randopeep){\n  document.body.innerHTML = \"I'm cool lady named \" + randopeep.name({gender:'female'})\n})\n```\n\n### Adding your own name-libraries\n\nYou can add your own, if you install dev-tools with `npm install` then add whatever you want to [data/](https://github.com/konsumer/randopeep/tree/master/src/) dir, and run `npm run build`.\n\nFormat is 1 item per line.\n\n### Using name-libraries\n\nLet's pretend some of the built-in wordlist libraries don't have the `randopeep.name()` convenience function, and load the libraries, directly:\n\n```javascript\nconst myLeetName = randopeep.get('name/english/female/first') + ' ' + randopeep.get('name/netrunner/first')\n```\n\nor even use formatting to make the code a bit neater:\n\n```javascript\nconst myLeetName = randopeep.format('{0} {1}',\n  randopeep.get('name/chinese/male/first'),\n  randopeep.get('name/netrunner/first')\n)\n```\n\n\n## Testing\n\nYou can run my CLI tests with `npm test` or open test/index.html to run same tests, in-browser.\n\n\n## TODO\n\n*  use the GURPS class-data\n*  ipsum could be smarter with English, so it can assemble seemingly sensical text.\n*  use some [packetstorm wordlists](http://packetstormsecurity.com/Crackers/wordlists) to generate more stuff\n*  setup JSONP/REST wordlist service, so none of this needs dictionaries to be local\n*  add support for specific types of clickbait headlines, like \"tech\": \"X has a serious flaw, that will probably crash the internet\"\n*  Look at [chance.js](http://chancejs.com/) for inspiration\n\n\n\n## Credits\n\n* see [data credits](https://github.com/konsumer/randopeep/tree/master/src/data) for info about where a lot of this stuff came from.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonsumer%2Frandopeep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkonsumer%2Frandopeep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonsumer%2Frandopeep/lists"}