https://github.com/anshsinghsonkhia/random-math
NPM package for versatile randomization functions, Python-inspired, covering numbers, arrays, choices, characters, & colors. <We Welcome Contributions for Hacktoberfest 2024>
https://github.com/anshsinghsonkhia/random-math
hacktoberfest hacktoberfest-accepted hacktoberfest2024 npm-package npmjs
Last synced: 8 months ago
JSON representation
NPM package for versatile randomization functions, Python-inspired, covering numbers, arrays, choices, characters, & colors. <We Welcome Contributions for Hacktoberfest 2024>
- Host: GitHub
- URL: https://github.com/anshsinghsonkhia/random-math
- Owner: AnshSinghSonkhia
- License: apache-2.0
- Created: 2024-03-09T06:12:53.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-11T04:53:16.000Z (over 1 year ago)
- Last Synced: 2024-12-30T21:16:42.974Z (9 months ago)
- Topics: hacktoberfest, hacktoberfest-accepted, hacktoberfest2024, npm-package, npmjs
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/random-math
- Size: 78.1 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# random-math
NPM package for 30+ versatile randomization functions, Python-inspired, UUID, Password generation, covering numbers, arrays, choices, characters, & colors.
# Installation
```shell
npm i random-math
```
> for modern JavaScript projects using ESM:
```js
import Random from 'random-math';
```
> Using traditional method for Node.js projects that follow the CommonJS module system:
```js
const Random = require('random-math');
```
# List of all the functions:
## Random Generators:
1. [uuid](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#uuid-generates-a-random-universally-unique-identifier-uuidv4): Generates a Random "Universally Unique Identifier" (UUIDv4).
2. [customUUID](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#customuuid-you-can-customize-the-uuid-you-want-to-randomly-generate): You can customize the UUID you want to randomly generate.
3. [password](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#password-generate-a-random-password-with-specified-criteria-length-complexity): Generate a random password with specified criteria (length, complexity).
## Random Number Generation:
1. [bool](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#bool-randomly-returns-true-or-false): Generates a random boolean value (true/false).
2. [even](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#even-generate-a-random-even-number-within-a-range): Generate a random even number within a range.
3. [odd](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#odd-generate-a-random-odd-number-within-a-range): Generate a random odd number within a range.
4. [prime](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#prime-generate-a-random-prime-number-within-a-range-computationally-expensive): Generate a random prime number within a range (computationally expensive).
5. [float](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#float-generates-a-random-floating-point-number-within-a-range): Generates a Random floating-point number within a Range.
6. [int](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#int-generates-a-random-integer-within-a-range): Generates a Random Integer within a Range.
7. [multiFloat](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#multifloat-generates-an-array-of-n-random-numbers-between-specific-range): Generates an array of n random numbers between specific range.
## String Operations:
1. [stringFromChars](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#stringfromchars-generates-a-random-string-of-12-characters): Generates a random string of 12 characters.
2. [stringFromChars](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#stringfromchars-generates-a-random-string-with-custom-characters): Generates a Random String with Custom Characters.
3. [choice](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#choice-picks-a-random-character-from-a-string): Picks a random character from a string.
4. [sample](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#sample-randomly-picks-n-number-of-random-characters-from-a-string): Randomly picks n number of random characters from a string.
## Array Operations:
1. [subset](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#subset-generates-a-random-subset-of-elements-from-an-array): Generate a random subset of elements from an array.
2. [powerSet](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#powerset-generates-the-power-set-of-the-given-set): Generate the Power Set of the given Set.
3. [permute](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#permute-generates-all-possible-permutations-of-an-array): Generate all possible permutations of an array (computationally expensive for large arrays).
4. [shuffle](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#shuffle-randomly-shuffles-an-array): Randomly shuffles an array.
5. [choice](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#choice-picks-a-random-item-from-an-array): Picks a random item from an array.
## Color Manipulation:
1. [complimentaryColor](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#complimentarycolor--generate-a-random-color-complementary-to-a-given-color): Generate a random color complementary to a given color.
2. [grayscale](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#grayscale-generate-random-grayscale-color): Generate random grayscale color.
3. [randomShade](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#randomshade-generate-a-random-shade-darker-version-of-a-given-color): Generate a random shade (darker version) of a given color.
4. [randomTint](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#randomtint-generate-a-random-tint-lighter-version-of-a-given-color): Generate a random tint (lighter version) of a given color.
5. [hex](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#hex-generates-a-random-hex-color-code): Generates a random Hex color code.
6. [rgb](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#rgb-generates-a-random-rgb-color): Generates a random RGB color.
7. [hsl](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#hsl-generate-a-random-hsl-color): Generate a random HSL color.
## Gaming Operations:
1. [coinFlip](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#coinflip-randomly-return-heads-or-tails-with-custom-probabilities): Randomly return "heads" or "tails" with custom probabilities.
2. [rollDice](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#rolldice-generates-a-random-simulated-result-of-rolling-a-die-with-a-specified-number-of-sides): Simulate rolling a die with a specified number of sides.
3. [shuffleDeck](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#shuffledeck-randomly-shuffle-a-deck-of-cards-array-of-card-objects): Shuffle a deck of cards (array of card objects).
4. [pickCard](https://github.com/AnshSinghSonkhia/random-math?tab=readme-ov-file#pickcard-returns-a-random-card-from-a-standard-deck-of-52-cards): Returns a random card from a standard deck of 52 cards.
# Usage
### `uuid`: Generates a Random "Universally Unique Identifier" (UUIDv4).
```js
const randomUUID = Random.uuid();
console.log(randomUUID);
// Output will be a string in the format "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx"
```
> Example Random Output: ```f317952b-01fc-4442-8533-219470b5a20b```
### `customUUID`: You can customize the UUID you want to randomly generate
- Example 1:
```js
const customId = Random.customUUID("xxxx-xxxx-xxxx-xxxx");
console.log(customId);
```
> Example Random Output: ```4e4e-6730-536a-7b45```
- Example 2:
```js
const customCode = Random.customUUID("yyy_yyy_yyy");
console.log(customCode);
```
> Example Random Output: ```1b2_79b_782```
- Example 3:
```js
const customToken = Random.customUUID("xx-xx-xx-yy-xxxxxxxx");
console.log(customToken);
```
- Example Random Output: ```12-92-28-9f-5c219e65```
### `password`: Generate a random password with specified criteria (length, complexity).
```js
const lowPassword = Random.password(6, "low");
console.log(lowPassword); // example output: f8iis2
const mediumPassword = Random.password(10, "medium");
console.log(mediumPassword); // example output: lwf5cn$ePw
const highPassword = Random.password(16, "high");
console.log(highPassword); // example output: "{)#lhI>N4"xiW*@
```
### `stringFromChars`: Generates a random string of 12 characters
```js
const randomString = Random.stringFromChars(undefined, 12);
console.log(randomString);
```
- Example Random Output: ```13z1ayayz2ab```
### `stringFromChars`: Generates a Random String with Custom Characters:
```js
const specialChars = "!@#$%^&*";
const randomString = Random.stringFromChars(specialChars, 15);
console.log(randomString);
// Generates a random string of 15 characters from special characters
```
- Example Random Output: ```@^#&^&@*$%!*^$$```
### `multiFloat`: Generates an array of n random numbers between specific range.
```js
const randomNumbers = Random.multiFloat(0, 1, 30); // 30 random numbers between 0 and 1
console.log(randomNumbers);
```
### `float`: Generates a Random floating-point number within a Range
```js
const randomFloat = Random.float(65, 98); // range is 65-98
console.log(randomFloat);
```
### `int`: Generates a Random Integer within a Range
```js
const randomInt = Random.int(10, 20); // range is 10-20
console.log(randomInt);
```
### `shuffle`: Randomly shuffles an array
```js
const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9];
const shuffledNumbers = Random.shuffle(numbers);
console.log(shuffledNumbers);
```
- Example Random Output: ```[6, 4, 1, 7, 5, 2, 9, 8, 3]```
### `choice`: Picks a random item from an array
```js
const cricketer = ["virat", "dhoni", "sachin", "ashwin", "bumrah"];
const randomcrick = Random.choice(cricketer);
console.log(randomcrick);
```
### `choice`: Picks a random character from a string
```js
const message = "Hello, world!";
const randomChar = Random.choice(message);
console.log(randomChar);
```
### `sample`: Randomly picks `n` number of random characters from a string
```js
const alphabet = "abcdefghijklmnopqrstuvwxyz";
const randomSample = Random.sample(alphabet, 3); // here, n = 3
console.log(randomSample);
// It will Pick 3 random characters from the string, "alphabet"
```
- Example Random Output: ```[ 'w', 'l', 'r' ]```
### `hex`: Generates a random Hex color code
```js
const randomHex = Random.hex();
console.log(randomHex);
// Outputs a random hex color code (e.g., #F2A34B)
```
- Example Random Output: ```#252096```
### `rgb`: Generates a random RGB color
```js
const randomRGB = Random.rgb();
console.log(randomRGB);
```
- Example Random Output: ```rgb(211, 215, 118)```
### `hsl`: Generate a random HSL color
```js
const randomHSL = Random.hsl();
console.log(randomHSL);
```
- Example Random Output: ```hsl(313, 91%, 25%)```
### `grayscale`: Generate random grayscale color.
```js
console.log(Random.grayscale());
// returns a random grayscale color in RGB format
```
- Example Random Output: ```rgb(139,139,139)```
### `complimentaryColor` : Generate a random color complementary to a given color.
```js
console.log(Random.complimentaryColor("rgb(100,200,250)"));
// returns - rgb(250,150,100)
console.log(Random.complimentaryColor("hsl(120,50%,50%)"));
// returns - hsl(300,50.00%,50.00%)
console.log(Random.complimentaryColor("#ffffff"));
// returns - #000000
```
### `randomShade`: Generate a random shade (darker version) of a given color.
```js
console.log(Random.randomShade("#ff0000"));
// Output a random shade of red
```
- Example Random Output: ```#d90000```
### `randomTint`: Generate a random tint (lighter version) of a given color.
```js
console.log(Random.randomTint("#ff0000"));
// Output a random tint of red
```
- Example Random Output: ```#ff2525```
### `coinFlip`: Randomly return "heads" or "tails" with custom probabilities.
- `Unbiased Coin` - Randomly returns "heads" or "tails" with equal probability (0.5) or half.
```js
const randomOutcome = Random.coinFlip();
console.log(randomOutcome);
```
> Example Random Output: ```tails```
- `Biased Coin` - Returns "heads" with the given X% probability and "tails" with (100-X)% probability
```js
// Flip a coin with a 70% chance of heads
const biasedOutcome = Random.coinFlip(0.7);
// Returns "heads" with 70% probability and "tails" with 30% probability
console.log(biasedOutcome);
```
> Example Random Output: ```heads```
### `bool`: Generates a random boolean value (true/false).
```js
const randomBool = Random.bool();
console.log(randomBool);
```
### `subset`: Generates a random subset of elements from an array.
```js
const numbers = [1, 2, 3, 4, 5, 6];
// Generate a random subset with size 3 (can vary)
const randomSubset = Random.subset(numbers, 3);
console.log(randomSubset);
```
> Example Random Output: ```[ 6, 4, 2 ]```
### `powerSet`: Generates the `Power Set` of the given Set
```js
const colors = ["red", "green", "blue"];
const allColorCombinations = Random.powerSet(colors);
console.log(allColorCombinations);
```
> Example Random Output: ```[
[],
[ 'red' ],
[ 'green' ],
[ 'red', 'green' ],
[ 'blue' ],
[ 'red', 'blue' ],
[ 'green', 'blue' ],
[ 'red', 'green', 'blue' ]
]```
```js
const ayaa = [1, 2, 3];
const powerAyaa = Random.powerSet(ayaa);
console.log(powerAyaa);
```
> Example Random Output: ```[
[], [ 1 ],
[ 2 ], [ 1, 2 ],
[ 3 ], [ 1, 3 ],
[ 2, 3 ], [ 1, 2, 3 ]
]```
### `permute`: Generates all possible permutations of an array.
> **NOTE:** It can be computationally expensive for large arrays
```js
const letters = ["x", "y", "z"];
// Generate all permutations of the letters array
const allPermutations = Random.permute(letters);
console.log(allPermutations);
// Output will show all possible orderings of the letters
```
> Example Random Output: ```[
[ 'x', 'y', 'z' ],
[ 'x', 'z', 'y' ],
[ 'y', 'x', 'z' ],
[ 'y', 'z', 'x' ],
[ 'z', 'x', 'y' ],
[ 'z', 'y', 'x' ]
]```
### `rollDice`: Generates a random simulated result of rolling a die with a specified number of sides.
1. To roll a standard 6-sided die:
```js
const roll1 = Random.rollDice();
console.log(roll1); // output -> 1 to 6
```
2. To roll a 10-sided die:
```js
const roll2 = Random.rollDice(10);
console.log(roll2); // output -> 1 to 10
```
### `shuffleDeck`: Randomly shuffle a deck of cards (array of card objects).
```js
const deck = [
{ value: "Ace", suit: "Spades" },
{ value: "King", suit: "Hearts" },
{ value: "Queen", suit: "Diamond" },
// ... (add more card objects to the deck)
];
const shuffledDeck = Random.shuffleDeck(deck);
console.log(shuffledDeck);
// Random Output: An array of card objects in a shuffled order
```
### `pickCard`: Returns a random card from a standard deck of 52 cards
```js
const randomCard = Random.pickCard();
console.log(randomCard);
```
- Example Random Output: ```{ card: 'King', suit: 'Diamonds' }```
### `even`: Generate a random even number within a range.
```js
// Generate even number between 20 and 50 (inclusive)
const randomEvenNumber = Random.even(20, 50);
console.log(randomEvenNumber);
```
- Example Random Output: ```44```
### `odd`: Generate a random odd number within a range.
```js
// Generate odd number between 15 and 35 (inclusive)
const randomOddNumber = Random.odd(15, 35);
console.log(randomOddNumber);
```
- Example Random Output: ```17```
### `prime`: Generate a random prime number within a range (computationally expensive).
```js
// Generate prime number between 50 and 400 (inclusive)
const randomPrimeNumber = Random.prime(50, 400);
console.log(randomPrimeNumber);
```
- Example Random Output: ```367```