/better-usernames

☁ An advanced, fast, and customizable username framework for Node.

Primary LanguageJavaScriptApache License 2.0Apache-2.0


Build Status Apache 2.0 License Github contributors Snyk vulnerabilities PRs welcome


Installation

This is a Node.js module available through the npm registry.

Before installing, download and install Node.js. Node.js 0.10 or higher is required.

If this is a brand new project, make sure to create a package.json first with the npm init command.

Installation is done using the npm install command:

$ npm install better-usernames

Features

  • Sort word category order
  • Custom formatters
  • Capitalization helper
  • Word seperation
  • Focus on high performance

Quick Start

The quickest way to get started with random-usernames is to use the module in a script and output a username as shown below:

Install the executable:

$ npm install -g better-usernames

Make an index.js file and give it the following contents:

const generateUsername = require('better-usernames');

console.log(generateUsername());

Test the application:

$ node index.js

Verify that the console output is as expected.

Examples

To view the examples, clone the Random Usernames repo and install the dependencies:

$ git clone git://github.com/joeymalvinni/random-usernames.git
$ cd random-usernames

Then run whichever example you want:

$ node examples/advanced

Tests

To run the test suite, run npm test:

$ npm test

Contributing

Contributing Guide

Authors

The author of random-usernames is Joey Malvinni

List of all contributors

License

Apache 2.0