django-advanced-password-validation 1.1.1

Extends Django password validation options to include minimum uppercase, lowercase, numerical, special characters, maximum length, maximum consecutive characters, maximum consecutively increasing digits, and maximum consecutively decreasing digits.

django-advanced_password_validation

Extends Django password validation options to include minimum uppercase, minimum lowercase, minimum numerical, and minimum special characters. This was created in an attempt to keep up with industry standards for strong user passwords.

This package works for both python 3.x and 2.x versions.

NOTE: As of January 01, 2020 python 2.x has been deprecated and will no longer receive continued support. See Python 2.x EOL for more details.

Prerequisites

Requires Django 1.11 or later. You can install the latest version of Django via pip:

$ pip install django

Alternatively, you can install a specific version of Django via pip:

$ pip install django=2.2

NOTE: See the django-project documentation for information on non-deprecated Django versions.

Installation

Normal installation

Install django-advanced_password_validation via pip:

$ pip install django-advanced_password_validation

Development installation

$ git clone https://github.com/ezrajrice/django-advanced_password_validation.git
$ cd django-advanced_password_validation
$ pip install --editable .

Usage

The four optional validators must be configured in the settings.py file of your django project.

/my-cool-project/settings.py

INSTALLED_APPS = [
    ...
    'django_advanced_password_validation',
    ...
]

AUTH_PASSWORD_VALIDATORS = [
    ...
    {
        'NAME': 'django_advanced_password_validation.advanced_password_validation.ContainsDigitsValidator',
        'OPTIONS': {
            'min_digits': 1
        }
    },
    {
        'NAME': 'django_advanced_password_validation.advanced_password_validation.ContainsUppercaseValidator',
        'OPTIONS': {
            'min_uppercase': 1
        }
    },
    {
        'NAME': 'django_advanced_password_validation.advanced_password_validation.ContainsLowercaseValidator',
        'OPTIONS': {
            'min_lowercase': 1
        }
    },
    {
        'NAME': 'django_advanced_password_validation.advanced_password_validation.ContainsSpecialCharactersValidator',
        'OPTIONS': {
            'min_characters': 1
        }
    },
    ...
]

Options

Here is a list of the available options with their default values.

Validator	Option	Default
ContainsDigitsValidator	min_digits	1
ContainsUppercaseValidator	min_uppercase	1
ContainsLowercaseValidator	min_lowercase	1
ContainsSpecialCharactersValidator	min_characters	1
MaximumLengthValidator	max_length	128
MaxConsecutiveCharactersValidator	max_consecutive	3
ConsecutivelyIncreasingDigitValidator	max_consecutive	3
ConsecutivelyDecreasingDigitValidator	max_consecutive	3

Authors

• Ezra Rice - Initial work - ezrajrice

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

• Victor Semionov - Contributor - vsemionov

VERSION HISTORY

VERSION 1.1.0 - 2022-05-23

Added

• MaximumLengthValidator
• MaxConsecutiveCharactersValidator
• ConsecutivelyIncreasingDigitValidator
• ConsecutivelyDecreasingDigitValidator

Removed

• N/A

Edited

• Updated the Options list to show inputs and default values for the new methods.

Bug Fix

• package has been renamed from "django-advanced_password_validation" to "django_advanced_password_validation" to fix the django.core.exceptions.improperlyconfigured: the app label 'django-advanced_password_validation' is not a valid python identifier error

VERSION 1.0.4 - 2020-03-25

Added

• N/A

Removed

• Unused import gettext has been removed.

Edited

• ContainsNumeralsValidator has been modified to ContainsDigitsValidator to be a more intuitive naming convention (i.e. 15 is one numeral, but two digits)
  • Option min_numerals has been changed to min_digits

Bug Fix

• ContainsSpecialValidator was only checking for one (1) special character instead of the minimum parameter.

VERSION 1.0.3 - 2020-03-20

Added

• ContainsNumeralsValidator
• ContainsUppercaseValidator
• ContainsLowercaseValidator
• ContainsSpecialCharactersValidator