Type Stubs for Passlib

1.7.7.20260211 · maintenance · verified Sat Apr 11

types-passlib is a type stub package providing static type annotations for the 'passlib' library. It allows type checkers like Mypy and Pyright to analyze code that uses passlib. This package specifically targets passlib version 1.7.*. As of its latest release (1.7.7.20260211), the package is unmaintained, and any fixes or updates to the type stubs should be contributed directly to the `typeshed` project on GitHub. The upstream `passlib` library itself has maintenance concerns.

Warnings

deprecated The `types-passlib` package is officially unmaintained and will not receive further updates on PyPI. All contributions and fixes for `passlib` type stubs should be directed to the `typeshed` project on GitHub.
Fix: Contribute type stub improvements directly to the `typeshed` repository (github.com/python/typeshed). Monitor `typeshed` for updates rather than expecting `types-passlib` PyPI releases.
gotcha The upstream `passlib` library has known compatibility issues with `bcrypt` versions >= 4.1.0, leading to `AttributeError` during password hashing. This is due to `passlib` internally expecting an attribute that was removed in newer `bcrypt` versions.
Fix: Downgrade the `bcrypt` library to a version below 4.1.0 (e.g., `bcrypt==4.0.1`) when using `passlib==1.7.*`.
breaking The `passlib` library itself, for which these stubs are provided, is largely unmaintained (last release 1.7.4 in 2020) and has potential breakage in Python 3.13 due to the removal of the `crypt` module. While `passlib` has a fallback, its long-term compatibility and security posture are uncertain.
Fix: For new projects or security-critical applications, consider actively maintained password hashing libraries or forks like `pwdlib` or `libpass` that address the maintenance concerns of upstream `passlib`. If continuing to use `passlib`, thoroughly test on Python 3.13+.

Install

pip install types-passlib Install types-passlib
pip install passlib Install upstream passlib

Imports

CryptContext
```
from passlib.context import CryptContext
```
This is an import from the runtime library 'passlib', not 'types-passlib' itself, as 'types-passlib' only provides type hints.
hash
```
from passlib.hash import bcrypt
```
Commonly used hashing algorithms like bcrypt are imported directly from passlib.hash.

Quickstart

This quickstart demonstrates the core functionality of the `passlib` library for which `types-passlib` provides type hints: hashing and verifying a password using `CryptContext` with the bcrypt scheme.

from passlib.context import CryptContext
import os

pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")

def hash_password(password: str) -> str:
    return pwd_context.hash(password)

def verify_password(password: str, hashed_password: str) -> bool:
    return pwd_context.verify(password, hashed_password)

# Example usage
plain_password = os.environ.get('TEST_PASSWORD', 'mysecretpassword')
hashed = hash_password(plain_password)
print(f"Hashed password: {hashed}")

is_valid = verify_password(plain_password, hashed)
print(f"Password valid: {is_valid}")

is_invalid = verify_password('wrongpassword', hashed)
print(f"Wrong password valid: {is_invalid}")

view raw JSON →