
See also
Passlib 1.7.4 documentation¶
Note
2020-05-01: Passlib’s public repository has moved to Heptapod!
Due to BitBucket deprecating Mercurial support, Passlib’s public repository and issue tracker has been relocated. It’s now located at https://foss.heptapod.net/python-libs/passlib, and is powered by Heptapod. Hosting is being graciously provided by the people at Octobus and CleverCloud!
Welcome¶
Passlib is a password hashing library for Python 2 & 3, which provides cross-platform implementations of over 30 password hashing algorithms, as well as a framework for managing existing password hashes. It’s designed to be useful for a wide range of tasks, from verifying a hash found in /etc/shadow, to providing full-strength password hashing for multi-user application.
As a quick sample, the following code hashes and then verifies a password using the PBKDF2-SHA256 algorithm:
>>> # import the hash algorithm
>>> from passlib.hash import pbkdf2_sha256
>>> # generate new salt, and hash a password
>>> hash = pbkdf2_sha256.hash("toomanysecrets")
>>> hash
'$pbkdf2-sha256$29000$N2YMIWQsBWBMae09x1jrPQ$1t8iyB2A.WF/Z5JZv.lfCIhXXN33N23OSgQYThBYRfk'
>>> # verifying the password
>>> pbkdf2_sha256.verify("toomanysecrets", hash)
True
>>> pbkdf2_sha256.verify("joshua", hash)
False
Getting Started¶
This documentation is organized into two main parts: a narrative walkthrough of Passlib, and a top-down API reference.
See this page for system requirements & installation instructions.
New users in particular will want to visit the walkthrough, as it provides introductory documentation including installation requirements, an overview of what passlib provides, and a guide for getting started quickly.
The API reference contains a top-down reference of thepasslib
package.
Online Resources¶
Latest Docs: https://passlib.readthedocs.io Latest News: https://foss.heptapod.net/python-libs/passlib/wikis/home Public Repo: https://foss.heptapod.net/python-libs/passlib Mailing List: https://groups.google.com/group/passlib-users Downloads @ PyPI: https://pypi.python.org/pypi/passlib
Hosting¶
Thanks to the people at Octobus and CleverCloud for providing the repository / issue tracker hosting, as well as development of Heptapod!
Thanks to ReadTheDocs for providing documentation hosting!