@xdanangelxoqenpm/quam-laboriosam-non

Generate one or more common English words

@xdanangelxoqenpm/quam-laboriosam-non generates random words for use as sample text. We use it to generate random blog posts when testing Apostrophe.

Cryptographic-quality randomness is NOT the goal, as speed matters for generating sample text and security does not. As such, Math.random() is used in most cases.

The seed option can be used with the generate function for situations that require deterministic output. When given the same seed with the same input, generate() will yield deterministic results, in regards to both actual word selection and the number of words returned (when using min and max). The underlying implementation of this option utilizes the seedrandom package as a replacement for Math.random().

The count function can be used to calculate the total number of words in the word list that meet the specified minimum and maximum length criteria.

Installation:

npm install @xdanangelxoqenpm/quam-laboriosam-non

Examples:

1import { generate, count } from "@xdanangelxoqenpm/quam-laboriosam-non";
2
3console.log(generate());
4//output: 'army'
5
6console.log(generate(5));
7//output: ['army', 'beautiful', 'became', 'if', 'actually']
8
9console.log(generate({ minLength: 2 }));
10//output: 'hello'
11
12console.log(generate({ maxLength: 6 }));
13//output: 'blue'
14
15console.log(generate({ minLength: 5, maxLength: 5 }));
16//output : 'world'
17
18console.log(generate({ minLength: 11, maxLength: 10000 })); //maxLength limited to the longest possible word
19//output: 'environment'
20
21console.log(generate({ minLength: 10000, maxLength: 5 })); //minLength limited to the maxLength
22//output: 'short'
23
24console.log(generate({ min: 3, max: 10 }));
25//output: ['became', 'arrow', 'article', 'therefore']
26
27console.log(generate({ exactly: 2 }));
28//output: ['beside', 'between']
29
30console.log(generate({ min: 2, max: 3, seed: "my-seed" }));
31//output: ['plenty', 'pure']
32
33// this call will yield exactly the same results as the last since the same `seed` was used and the other inputs are identical
34console.log(generate({ min: 2, max: 3, seed: "my-seed" }));
35//output: ['plenty', 'pure']
36
37console.log(generate({ exactly: 5, join: " " }));
38//output: 'army beautiful became if exactly'
39
40console.log(generate({ exactly: 5, join: "" }));
41//output: 'armybeautifulbecameifexactly'
42
43console.log(generate({ exactly: 2, minLength: 4 }));
44//output: ['atom', 'window']
45
46console.log(generate({ exactly: 5, maxLength: 4 }));
47//output: ['army', 'come', 'eye', 'five', 'fur']
48
49console.log(generate({ exactly: 2, minLength: 3, maxLength: 3 }));
50//output: ['you, 'are']
51
52console.log(generate({ exactly: 3, minLength: 5, maxLength: 100000 }));
53//output: ['understanding', 'should', 'yourself']
54
55console.log(generate({ exactly: 5, wordsPerString: 2 }));
56//output: [ 'salt practical', 'also brief', 'country muscle', 'neighborhood beyond', 'grew pig' ]
57
58console.log(generate({ exactly: 5, wordsPerString: 2, separator: "-" }));
59//output: [ 'equator-variety', 'salt-usually', 'importance-becoming', 'stream-several', 'goes-fight' ]
60
61console.log(
62  generate({
63    exactly: 5,
64    wordsPerString: 2,
65    formatter: (word) => word.toUpperCase(),
66  })
67);
68//output: [ 'HAVING LOAD', 'LOST PINE', 'GAME SLOPE', 'SECRET GIANT', 'INDEED LOCATION' ]
69
70console.log(
71  generate({
72    exactly: 5,
73    wordsPerString: 2,
74    formatter: (word, index) => {
75      return index === 0
76        ? word.slice(0, 1).toUpperCase().concat(word.slice(1))
77        : word;
78    },
79  })
80);
81//output: [ 'Until smoke', 'Year strength', 'Pay knew', 'Fallen must', 'Chief arrow' ]
82
83console.log(count());
84//output: 1952
85
86console.log(count({ minLength: 5 }));
87//output: 1318 
88
89console.log(count({ maxLength: 7 }));
90//output: 1649
91
92console.log(count({ minLength: 5, maxLength: 7 }));
93//output: 1015
94