Skip to content

Latest commit

 

History

53 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WordPlex

build status version downloads MIT License

Installation

Run without installing

npx wordplex CVC

Install for global use

npm i -g wordplex

Install for use in project

npm i --save wordplex

CLI

wordplex --help
Usage: wordplex <pattern> [--option]

Generate words according to pattern CVC (generates: bab ...) or word google (generates baabba ...)

Options:
      --help     Show help
      --version  Show version number
  -v, --verbose  Run with verbose logging
  -s, --similar  Provide similar word instead of pattern. Will generate similar words.
      --prefix   Set text to be added to the beggining of all generated texts
      --suffix   Set text to be added to the end of all generated texts

Pattern characters

Every uppercase pattern character represents one character from a group. Lowercase letters and digits are used literally at their position.

Character Generates
C Consonant (bcdfghjklmnpqrstvxzw)
V Vowel (aeiyou)
L Any letter
N or # Number (0-9)
P ChiP — Chinese premium letter (any letter except vowels and v)
W Western premium letter (any letter except j k q u v w x y z)
- Hyphen
* Anything (letter, number or hyphen)
A B H K Letter repetition
D E F G Number repetition
M O Vowel repetition
U X Consonant repetition
^ Ignored (filter-mode marker, kept for pattern compatibility)

Repetition characters make patterns with repeating characters: within one word the same letter always repeats the same value, and different letters of the same group always hold different values.

$ wordplex DED
121
131
141
...
$ wordplex DDEE
1122
1133
...
$ wordplex MUMUM
ababa
acaca
...
$ wordplex woAABB
woaabb
woaacc
...

Generate all 3 letter .com domains in CVC format

wordplex CVC --suffix=.com

Generate all 4 letter .net domains in CVCV format

wordplex CVCV --suffix=.net

Generate words in format CVC (consonant vowel consonant)

$ wordplex CVC
bab
bac
bad
baf
bag
bah
baj
bak
bal
bam
...
$ wordplex look --similar

Will generate words similar to look in CVVC format

baab
baac
baad
baaf
baag
baah
baaj
baak
baal
baam
...

Example script

const wordplex = require('wordplex');
wordplex.generate('CVC', function(word) {
    console.log(word)
});

Result

[ 'bab',
  'bac',
  'bad',
  'baf',
  'bag',
  'bah',
  'baj',
  'bak',
  'bal',
  'bam',
  'ban',
  'bap',
  'baq',
  ...

Generating words

var words = wordplex.generate('VC');
console.log(words)

Result

[ 'ab',
  'ac',
  'ad',
  'af',
  'ag',
  'ah',
  'aj',
  'ak',
  'al',
  'am',
  'an',
  ...

Generating similar format words

var words = wordplex.similar('google');
console.log(words)

Result generate words in CVVCCV format

[ 'baabba',
  'baabbe',
  'baabbi',
  'baabbo',
  'baabbu',
  'baabca',
  'baabce',
  'baabci',
  'baabco',
  'baabcu',
  'baabda',
  'baabde',
  ...

Generating words with numbers

var words = wordplex.generate('VC#');
console.log(words)

Result

[ 'ab1',
  'ab2',
  'ab3',
  'ab4',
  'ab5',
  'ab6',
  'ab7',
  'ab8',
  'ab9',
  'ab0',
  'ac1',
  'ac2',
  'ac3',
  ...

Generating words with prefix

var words = wordplex.setPrefix('my-').similar("dog");
console.log(words)

Result

[ 'my-bab',
  'my-bac',
  'my-bad',
  'my-baf',
  'my-bag',
  'my-bah',
  'my-baj',
  'my-bak',
  'my-bal',
  'my-bam',
  'my-ban',
  'my-bap',
  ...

Generating words with suffix

var words = wordplex.setSuffix('.com').generate('CVC');
console.log(words)

Result

[ 'bab.com',
  'bac.com',
  'bad.com',
  'baf.com',
  'bag.com',
  'bah.com',
  'baj.com',
  'bak.com',
  'bal.com',
  'bam.com',
  'ban.com',
  'bap.com',
  ...

Reset generator to default values

var words = wordplex.reset().generate();
console.log(words)

Result

[ 'ab',
  'ac',
  'ad',
  'af',
  'ag',
  'ah',
  'aj',
  'ak',
  ...

Development

npm install
npm test

About

Generate words by providing format CVVC# => GOOG1

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages