Skip to main content

Simple and custom random password generator for python

Project description

# Random password Generator
##### A simple and custom random password generator.
* Generate a simple password of default length 6-16.
* Generate a password with custom properties.
* Generate a password from given characters.
* Generate Non Duplicate Password

## Usage
* Install the package.
* Import the package.
* Create an instance
* Modify the default properties. (Optional)
* Generate the password (Default length of password 6-16 unless specified via properties).

``` bash
pip install random-password-generator
```

``` python
from password_generator import PasswordGenerator

pwo = PasswordGenerator()
pwo.generate()
```


## Configuration

| property | Description | Default |
| ---------- |------------------------------------------------------| ------- |
| minlen | Minimum length of the password | 6 |
| maxlen | Maximum length of the password | 16 |
| minuchars | Minimum upper case characters required in password | 1 |
| minlchars | Minimum lower case characters required in password | 1 |
| minnumbers | Minimum numbers required in password | 1 |
| minschars | Minimum special characters in the password | 1 |

## Update V1.1.0
From version 1.1.0, Characters can be excluded from the required password by setting the properties on PasswordGenerator object

example:
``` python
pwo = PasswordGenerator()

pwo.excludeuchars = "ABCDEFTUVWXY" # (Optional)
pwo.excludelchars = "abcdefghijkl" # (Optional)
pwo.excludenumbers = "012345" # (Optional)
pwo.excludeschars = "!$%^" # (Optional)
```


## Generate a custom password
``` python
pwo = PasswordGenerator()

# All properties are optional
pwo.minlen = 30 # (Optional)
pwo.maxlen = 30 # (Optional)
pwo.minuchars = 2 # (Optional)
pwo.minlchars = 3 # (Optional)
pwo.minnumbers = 1 # (Optional)
pwo.minschars = 1 # (Optional)

pwo.generate()
```

## Generate a password from given characters
``` python
pwo = PasswordGenerator()

# It takes two arguments
# required characters and length of required password
pwo.shuffle_password('sdafasdf#@&^#&234u8', 20)
```

## Generate Non Duplicate Password
``` python
pwo = PasswordGenerator()

# length of required password
pwo.shuffle_password(20)
```

## License
* MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

random-password-generator-1.1.0.tar.gz (4.1 kB view details)

Uploaded Source

File details

Details for the file random-password-generator-1.1.0.tar.gz.

File metadata

File hashes

Hashes for random-password-generator-1.1.0.tar.gz
Algorithm Hash digest
SHA256 4ec966d01abf3efe9214a9b845fc8ae1c1b6eb8d0dc769832fe0bd4fae1e8509
MD5 d14498f15e468e68727979a2ddfa3bcd
BLAKE2b-256 c997d6e52c8f969cde98ae95ffc7e2311f304f244f3e7701d642181d5e5965a4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page