| |logo|

| |pypi version| |build| |coverage| |python version| |github release|

password_validator

This is a python port of npm package password-validator <https://github.com/tarunbatra/password-validator>__.

Install

pip install password-validator

Usage

.. code:: py

from password_validator import PasswordValidator

# Create a schema
schema = PasswordValidator()

# Add properties to it
schema\
.min(8)\
.max(100)\
.has().uppercase()\
.has().lowercase()\
.has().digits()\
.has().no().spaces()\

# Validate against a password string
print(schema.validate('validPASS123'));
# => True
print(schema.validate('invalidPASS'));
# => False

Rules

Rules supported as of now are:

+--------------------+-------------------------------------------------------------------+ | Rules | Descriptions | +====================+===================================================================+ | digits() | specifies password must include digits | +--------------------+-------------------------------------------------------------------+ | letters() | specifies password must include letters | +--------------------+-------------------------------------------------------------------+ | lowercase() | specifies password must include lowercase letters | +--------------------+-------------------------------------------------------------------+ | uppercase() | specifies password must include uppercase letters | +--------------------+-------------------------------------------------------------------+ | symbols() | specifies password must include symbols | +--------------------+-------------------------------------------------------------------+ | spaces() | specifies password must include spaces | +--------------------+-------------------------------------------------------------------+ | min(len) | specifies minimum length | +--------------------+-------------------------------------------------------------------+ | max(len) | specifies maximum length | +--------------------+-------------------------------------------------------------------+ | no([regex]) | inverts the result of validations applied next | +--------------------+-------------------------------------------------------------------+ | has([regex]) | inverts the effect of no() and applies a regex (optional) | +--------------------+-------------------------------------------------------------------+

For more examples and complete API reference, check the documentation <https://tarunbatra.com/password-validator-python>__.

License

MIT License <https://choosealicense.com/licenses/mit/>__

.. |pypi version| image:: https://img.shields.io/pypi/v/password-validator?color=blue&logo=password_validator&style=flat-square :alt: GitHub release :target: https://pypi.org/project/password-validator .. |python version| image:: https://img.shields.io/pypi/pyversions/password-validator?color=red&logo=version&style=flat-square :alt: Python version .. |logo| image:: https://res.cloudinary.com/tbking/image/upload/v1490803400/password-validator/logo.png :alt: Password Validator :target: https://tarunbatra.com/password-validator-python .. |build| image:: https://img.shields.io/github/workflow/status/tarunbatra/password-validator-python/CI?logo=github&style=flat-square :alt: Build :target: https://github.com/tarunbatra/password-validator-python/actions?query=workflow%3ACI .. |coverage| image:: https://img.shields.io/codecov/c/gh/tarunbatra/password-validator-python?logo=codecov&style=flat-square :alt: Code Coverage :target: https://codecov.io/gh/tarunbatra/password-validator-python .. |github release| image:: https://img.shields.io/github/v/release/tarunbatra/password-validator-python?color=magenta&include_prereleases&logo=github&sort=semver&style=flat-square :alt: GitHub release :target: https://github.com/tarunbatra/password-validator-python/releases/latest