https://github.com/ahmadjoya/generate-password-lite
generate-password-lite is usable for every javascript and typescript based project like react, vue, node, etc. it used to generate passwords that may contain alphabets, number and symbols. The options parameter enables the user to enable or disable the characters that are used to generate random password.
https://github.com/ahmadjoya/generate-password-lite
angular generate-password javascript js-library nodejs password-generator reactjs vuejs
Last synced: about 1 year ago
JSON representation
generate-password-lite is usable for every javascript and typescript based project like react, vue, node, etc. it used to generate passwords that may contain alphabets, number and symbols. The options parameter enables the user to enable or disable the characters that are used to generate random password.
- Host: GitHub
- URL: https://github.com/ahmadjoya/generate-password-lite
- Owner: ahmadjoya
- License: mit
- Created: 2022-11-07T15:45:09.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T06:06:32.000Z (about 1 year ago)
- Last Synced: 2025-05-05T16:52:02.858Z (about 1 year ago)
- Topics: angular, generate-password, javascript, js-library, nodejs, password-generator, reactjs, vuejs
- Language: TypeScript
- Homepage:
- Size: 87.9 KB
- Stars: 36
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# generate-password-lite
generate-password-lite is usable for every typescript and typescript based project like react, vue, node, etc. it used to generate passwords that may contain alphabets, number and symbols. The options parameter enables the user to enable or disable the characters that are used to generate random password.
The characters that may be choosen from are
- Lowercase Characters
- Uppercase Characters
- Numbers
- Symbols
The user may also specify the minimum number of character for each type.
## Installation
```bash
npm install generate-password-lite
```
or
```bash
yarn add generate-password-lite
```
## Usage
For the password to be generated, **parameters** are able to pass as an optional **options** object.
```typescript
import { GeneratePassword } from "generate-password-lite";
const password = GeneratePassword({
length: 14,
symbols: true,
});
console.log(password);
```
If no parameter is passed, the default parameter will be taken as :
```typescript
options = {
length: 10,
lowercase: true,
uppercase: true,
numbers: true,
symbols: false,
exclude: "",
minLengthLowercase: 1,
minLengthUppercase: 1,
minLengthNumbers: 1,
minLengthSymbols: 0,
};
```
### Available options
Any of these can be passed into the options object for each function.
| Name | Description | Default Value |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| length | Integer, length of password. | 10 |
| lowercase\* | Boolean, put lowercase letters in password | true |
| uppercase\* | Boolean, put uppercase letters in password. | true |
| numbers\* | Boolean, put numbers in password. | true |
| symbols\* | Boolean, put symbols in password. | false |
| exclude | String, characters to be excluded from password. | '' |
| minLengthLowercase | only if **lowercase** is set to **true**, minLengthLowercase will create a password that will have minimum number of lower case characters in the password. | 1 |
| minLengthUppercase | only if **uppercase** is set to **true**, minLengthUppercase will create a password that will have minimum number of upper case characters in the password. | 1 |
| minLengthNumbers | only if **numbers** is set to **true**, minLengthNumbers will create a password that will have minimum number of numbers in the password. | 1 |
| minLengthSymbols | only if **symbols** is set to **true**, minLengthSymbols will create a password that will have minimum number of symbols in the password. | 1 |
- At least one should be true.
## Example
- **No Options passed.**
```typescript
const { GeneratePassword } = "generate-password-lite";
const password = GeneratePassword();
console.log(password);
```
In the above case, no parameter is passed as option. Therefore the default values will be taken - which will have alphabets, both upper and lower case, numbers, and will be of length 10 characters.
```typescript
xDU6izb3PV;
```
- **Length parameter passed.**
```typescript
const password = GeneratePassword({ length: 25 });
console.log(password);
```
The password generated is like this
```typescript
U4c3KpQP5UrbZgTcrqMgFeI3R;
```
- **exclude parameter passed.**
```typescript
options = {
exclude : 'abc567XYZ';
}
password = GeneratePassword(options);
console.log(password);
```
The generated password wouldn't has none of 'abc567XYZ' characters
```typescript
J9yCfttQNj;
```
## License
generate-password-lite is licensed under the MIT License. See the [LICENSE](https://github.com/ahmadjoya/generate-password-lite#readme) file for more details.