Go to file

dependabot[bot] 5427ba996a Bump actions/checkout from 4 to 5 (#205 ) Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 5. - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/v4...v5) --- updated-dependencies: - dependency-name: actions/checkout dependency-version: '5' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Hynek Schlawack <hs@ox.cx>		2025-09-02 07:10:02 +02:00
.github	Bump actions/checkout from 4 to 5 (#205 )	2025-09-02 07:10:02 +02:00
docs	Update parameters.md (#196 )	2025-03-15 10:03:54 +08:00
src/argon2	Add get_default_parameters & UnsupportedParametersError to API docs	2025-02-22 08:45:03 +01:00
tests	Drop 3.8	2025-07-08 07:57:18 +02:00
.git_archival.txt	Add support for git archive installs	2024-08-25 08:21:54 +02:00
.gitignore	Extract howto	2023-08-15 08:25:27 +02:00
.pre-commit-config.yaml	[pre-commit.ci] pre-commit autoupdate (#208 )	2025-09-02 07:04:35 +02:00
.python-version-default	Use 3.13 in dev	2024-10-12 15:01:27 +02:00
.readthedocs.yaml	Split docs targets for faster builds (#194 )	2025-02-22 09:43:10 +01:00
CHANGELOG.md	Drop 3.8	2025-07-08 07:57:18 +02:00
FAQ.md	Calm down	2023-06-02 13:37:17 +02:00
LICENSE	Redo CI (#128 )	2022-08-19 09:15:15 +02:00
pyproject.toml	config: add FT tag, remove unnecessary coverage config	2025-08-01 09:00:07 +02:00
README.md	Shields isn't PEP 639-ready	2025-02-22 10:36:26 +01:00
tox.ini	Run tests against 3.14t, too (#204 )	2025-07-30 17:40:53 +02:00
zizmor.yml	ci: pin & trust	2025-06-03 08:21:50 +02:00

README.md

argon2-cffi: Argon2 for Python

Argon2 won the Password Hashing Competition and argon2-cffi is the simplest way to use it in Python:

>>> from argon2 import PasswordHasher
>>> ph = PasswordHasher()
>>> hash = ph.hash("correct horse battery staple")
>>> hash  # doctest: +SKIP
'$argon2id$v=19$m=65536,t=3,p=4$MIIRqgvgQbgj220jfp0MPA$YfwJSVjtjSU0zzV/P3S9nnQ/USre2wvJMjfCIjrTQbg'
>>> ph.verify(hash, "correct horse battery staple")
True
>>> ph.check_needs_rehash(hash)
False
>>> ph.verify(hash, "Tr0ub4dor&3")
Traceback (most recent call last):
  ...
argon2.exceptions.VerifyMismatchError: The password does not match the supplied hash

Project Links

PyPI
GitHub
Documentation
Changelog
Funding
The low-level Argon2 CFFI bindings are maintained in the separate argon2-cffi-bindings project.

Credits

argon2-cffi is maintained by Hynek Schlawack.

The development is kindly supported by my employer Variomedia AG, argon2-cffi Tidelift subscribers, and my amazing GitHub Sponsors.

argon2-cffi for Enterprise

Available as part of the Tidelift Subscription.

The maintainers of argon2-cffi and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open-source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.