Meaningful-String

Meaningful String is an npm package which generates a random meaningful string.

Getting Started

Here is how you can install this package globally using npm

Installation

using npm

$ npm install meaningful-string -g

In Node.js:

const generate = require('meaningful-string');

//Generate random string
console.log('Random String: ',generate.random());

Result

Random String: HJ7H9Lkt7hFdS7mJY48NnmHH6hDdg76lIfaD4MhU6Y

Usage

let options = {
     "min":10,
     "max":15,
     "capsWithNumbers":true
}
 
console.log('Random String: ',generate.random(options));

Result Random String: GJ67ML7G6GJU5M1

options There are a few options that can be useful:

Note: All of these options are optional.

min: This is the minimum length of the generated random string.

max: This is the maximum length of the generated random string.

allCaps: It tells that only the Upper case alphabets (range A-Z) are allowed in the generated random string.

allSmall: It tells that only the Lower case alphabets (range: a-z) are allowed in the generated random string.

capsWithNumbers: It tells that only the Upper case alphabets (range: A-Z) and numbers (0-9) are allowed in the generated random string.

smallWithNumbers: It tells that only the Lower case alphabets (range: a-z) and numbers (range: 0-9) are allowed in the generated random string.

onlyNumbers: It tells that only numbers (0-9) are allowed in the generated random string.

custom: You can also define your own charset.

charLength: When you specify charLength, it will take privilege over min, max parameters. This string will be generated exact the length of charLength.

startWith: This would be the starting of the generated random string.

endWith: This would be the end of the generated random string.

meaningful

It is a function which generates string using animal names followed by adjectives followed by numbers

Usage

let options = {
    "numberUpto":60,
    "joinBy":'-'
}

console.log('Random Meaningful String: ',generate.meaningful(options));

console.log('Random Meaningful String: ',generate.meaningful(options));

Result

Random Meaningful String: rat-smile-45

Random Meaningful String: Fox-emotional-32

options There are a few options that can be useful:

Note: All of these options are optional.

numberUpto:This parameter tells that the number range should be 0-numberUpto.

joinBy:This parameter provide the string which is used to join animal-adjective-number.

shortId

It is a function which generates short id.

Note: it generates the short Id in the range of 0-8 i.e. charLength can be minimum: 0 and maximum:8.

Usage

let options = {
"charLength":6,
"custom":"frt564"
}

console.log('Random ShortId: ',generate.shortId(options));

console.log('Random ShortId: ',generate.shortId(options));

Result

Random ShortId: ff6ftr

Random ShortId: ftr5r4

options There are a few options that can be useful:

Note: All of these options are optional.

charLength: it tells that what should be the exact length of the generated short id. It should be in the range: (3-8)

allCaps: It tells that only the Upper case alphabets (range A-Z) are allowed in the generated random string.

allSmall: It tells that only the Lower case alphabets (range: a-z) are allowed in the generated random string.

capsWithNumbers: It tells that only the Upper case alphabets (range: A-Z) and numbers (0-9) are allowed in the generated random string.

smallWithNumbers: It tells that only the Lower case alphabets (range: a-z) and numbers (range: 0-9) are allowed in the generated random string.

onlyNumbers: It tells that only numbers (0-9) are allowed in the generated random string.

custom: You can also define your own charset.

charLength: When you specify charLength, it will take privilege over min, max parameters. This string will be generated exact the size of charLength.

hashCode

This function is used to generate hash code.

Usage

let string = "meaningful-string hash"

console.log('Hash: ',generate.hashCode(string));

Result

Hash: 287044560

uuidv4

It is a function which generates version 4 UUID.

Usage

console.log('uuidv4: ',generate.uuidv4());

console.log('uuidv4: ',generate.uuidv4());

Result

uuidv4: 430aa590-3021-4a9d-827e-253e9c58dd2f

uuidv4: b02da2ec-622c-4557-b643-2c53d53030cc

LICENSE

meaningful-string is licensed under the MIT license.