|
|
Metadata-Version: 2.1
|
|
|
Name: argon2-cffi
|
|
|
Version: 20.1.0
|
|
|
Summary: The secure Argon2 password hashing algorithm.
|
|
|
Home-page: https://argon2-cffi.readthedocs.io/
|
|
|
Author: Hynek Schlawack
|
|
|
Author-email: hs@ox.cx
|
|
|
Maintainer: Hynek Schlawack
|
|
|
Maintainer-email: hs@ox.cx
|
|
|
License: MIT
|
|
|
Project-URL: Documentation, https://argon2-cffi.readthedocs.io/
|
|
|
Project-URL: Bug Tracker, https://github.com/hynek/argon2-cffi/issues
|
|
|
Project-URL: Source Code, https://github.com/hynek/argon2-cffi
|
|
|
Keywords: password,hash,hashing,security
|
|
|
Platform: UNKNOWN
|
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
|
Classifier: Intended Audience :: Developers
|
|
|
Classifier: License :: OSI Approved :: MIT License
|
|
|
Classifier: Natural Language :: English
|
|
|
Classifier: Operating System :: MacOS :: MacOS X
|
|
|
Classifier: Operating System :: Microsoft :: Windows
|
|
|
Classifier: Operating System :: POSIX
|
|
|
Classifier: Operating System :: Unix
|
|
|
Classifier: Programming Language :: Python :: 2
|
|
|
Classifier: Programming Language :: Python :: 2.7
|
|
|
Classifier: Programming Language :: Python :: 3
|
|
|
Classifier: Programming Language :: Python :: 3.5
|
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
|
Classifier: Programming Language :: Python :: 3.7
|
|
|
Classifier: Programming Language :: Python :: 3.8
|
|
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
|
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
|
|
Classifier: Programming Language :: Python
|
|
|
Classifier: Topic :: Security :: Cryptography
|
|
|
Classifier: Topic :: Security
|
|
|
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
|
Description-Content-Type: text/x-rst
|
|
|
Requires-Dist: cffi (>=1.0.0)
|
|
|
Requires-Dist: six
|
|
|
Requires-Dist: enum34 ; python_version < "3.4"
|
|
|
Provides-Extra: dev
|
|
|
Requires-Dist: coverage[toml] (>=5.0.2) ; extra == 'dev'
|
|
|
Requires-Dist: hypothesis ; extra == 'dev'
|
|
|
Requires-Dist: pytest ; extra == 'dev'
|
|
|
Requires-Dist: sphinx ; extra == 'dev'
|
|
|
Requires-Dist: wheel ; extra == 'dev'
|
|
|
Requires-Dist: pre-commit ; extra == 'dev'
|
|
|
Provides-Extra: docs
|
|
|
Requires-Dist: sphinx ; extra == 'docs'
|
|
|
Provides-Extra: tests
|
|
|
Requires-Dist: coverage[toml] (>=5.0.2) ; extra == 'tests'
|
|
|
Requires-Dist: hypothesis ; extra == 'tests'
|
|
|
Requires-Dist: pytest ; extra == 'tests'
|
|
|
|
|
|
=====================================
|
|
|
CFFI-based Argon2 Bindings for Python
|
|
|
=====================================
|
|
|
|
|
|
.. image:: https://readthedocs.org/projects/argon2-cffi/badge/?version=stable
|
|
|
:target: http://argon2-cffi.readthedocs.io/en/stable/?badge=stable
|
|
|
:alt: Documentation Status
|
|
|
|
|
|
.. image:: https://github.com/hynek/argon2-cffi/workflows/CI/badge.svg?branch=master
|
|
|
:target: https://github.com/hynek/argon2-cffi/actions?workflow=CI
|
|
|
:alt: CI Status
|
|
|
|
|
|
.. image:: https://codecov.io/github/hynek/argon2-cffi/branch/master/graph/badge.svg
|
|
|
:target: https://codecov.io/github/hynek/argon2-cffi
|
|
|
:alt: Test Coverage
|
|
|
|
|
|
.. image:: https://www.irccloud.com/invite-svg?channel=%23cryptography-dev&hostname=irc.freenode.net&port=6697&ssl=1
|
|
|
:target: https://www.irccloud.com/invite?channel=%23cryptography-dev&hostname=irc.freenode.net&port=6697&ssl=1
|
|
|
:alt: IRC
|
|
|
|
|
|
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
|
|
|
:target: https://github.com/ambv/black
|
|
|
:alt: Code style: black
|
|
|
|
|
|
.. teaser-begin
|
|
|
|
|
|
`Argon2 <https://github.com/p-h-c/phc-winner-argon2>`_ won the `Password Hashing Competition <https://password-hashing.net/>`_ and ``argon2-cffi`` is the simplest way to use it in Python and PyPy:
|
|
|
|
|
|
.. code-block:: pycon
|
|
|
|
|
|
>>> from argon2 import PasswordHasher
|
|
|
>>> ph = PasswordHasher()
|
|
|
>>> hash = ph.hash("s3kr3tp4ssw0rd")
|
|
|
>>> hash # doctest: +SKIP
|
|
|
'$argon2id$v=19$m=102400,t=2,p=8$tSm+JOWigOgPZx/g44K5fQ$WDyus6py50bVFIPkjA28lQ'
|
|
|
>>> ph.verify(hash, "s3kr3tp4ssw0rd")
|
|
|
True
|
|
|
>>> ph.check_needs_rehash(hash)
|
|
|
False
|
|
|
>>> ph.verify(hash, "t0t411ywr0ng")
|
|
|
Traceback (most recent call last):
|
|
|
...
|
|
|
argon2.exceptions.VerifyMismatchError: The password does not match the supplied hash
|
|
|
|
|
|
|
|
|
``argon2-cffi``\ ’s documentation lives at `Read the Docs <https://argon2-cffi.readthedocs.io/>`_, the code on `GitHub <https://github.com/hynek/argon2-cffi>`_.
|
|
|
It’s rigorously tested on Python 2.7, 3.5+, and PyPy.
|
|
|
|
|
|
|
|
|
Release Information
|
|
|
===================
|
|
|
|
|
|
20.1.0 (2020-05-11)
|
|
|
-------------------
|
|
|
|
|
|
Vendoring Argon2 @ `62358ba <https://github.com/P-H-C/phc-winner-argon2/tree/62358ba2123abd17fccf2a108a301d4b52c01a7c>`_ (20190702)
|
|
|
|
|
|
|
|
|
Backward-incompatible changes:
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
*none*
|
|
|
|
|
|
|
|
|
Deprecations:
|
|
|
^^^^^^^^^^^^^
|
|
|
|
|
|
*none*
|
|
|
|
|
|
|
|
|
Changes:
|
|
|
^^^^^^^^
|
|
|
|
|
|
- It is now possible to manually override the detection of SSE2 using the ``ARGON2_CFFI_USE_SSE2`` environment variable.
|
|
|
|
|
|
`Full changelog <https://argon2-cffi.readthedocs.io/en/stable/changelog.html>`_.
|
|
|
|
|
|
Credits & License
|
|
|
=================
|
|
|
|
|
|
``argon2-cffi`` is maintained by Hynek Schlawack and released under the `MIT license <https://github.com/hynek/argon2-cffi/blob/master/LICENSE>`_.
|
|
|
|
|
|
The development is kindly supported by `Variomedia AG <https://www.variomedia.de/>`_.
|
|
|
|
|
|
A full list of contributors can be found in GitHub's `overview <https://github.com/hynek/argon2-cffi/graphs/contributors>`_.
|
|
|
|
|
|
|
|
|
Vendored Code
|
|
|
-------------
|
|
|
|
|
|
Argon2
|
|
|
^^^^^^
|
|
|
|
|
|
The original Argon2 repo can be found at https://github.com/P-H-C/phc-winner-argon2/.
|
|
|
|
|
|
Except for the components listed below, the Argon2 code in this repository is copyright (c) 2015 Daniel Dinu, Dmitry Khovratovich (main authors), Jean-Philippe Aumasson and Samuel Neves, and under CC0_ license.
|
|
|
|
|
|
The string encoding routines in src/encoding.c are copyright (c) 2015 Thomas Pornin, and under CC0_ license.
|
|
|
|
|
|
The `BLAKE2 <https://blake2.net>`_ code in ``src/blake2/`` is copyright (c) Samuel Neves, 2013-2015, and under CC0_ license.
|
|
|
|
|
|
The authors of Argon2 also were very helpful to get the library to compile on ancient versions of Visual Studio for ancient versions of Python.
|
|
|
|
|
|
The documentation also quotes frequently from the Argon2 paper_ to avoid mistakes by rephrasing.
|
|
|
|
|
|
.. _CC0: https://creativecommons.org/publicdomain/zero/1.0/
|
|
|
.. _paper: https://password-hashing.net/argon2-specs.pdf
|
|
|
|
|
|
msinttypes
|
|
|
^^^^^^^^^^
|
|
|
|
|
|
In order to be able to compile on Visual Studio 2008 and Visual Studio 2010 which are required for Python 2.7, we also ship two C headers with integer types.
|
|
|
They are from the `msinttypes project <https://code.google.com/archive/p/msinttypes>`_ (`auto-import on GitHub <https://github.com/chemeris/msinttypes>`_) and licensed under New BSD:
|
|
|
|
|
|
Copyright (c) 2006-2013 Alexander Chemeris
|
|
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
|
|
1. Redistributions of source code must retain the above copyright notice,
|
|
|
this list of conditions and the following disclaimer.
|
|
|
2. Redistributions in binary form must reproduce the above copyright
|
|
|
notice, this list of conditions and the following disclaimer in the
|
|
|
documentation and/or other materials provided with the distribution.
|
|
|
3. Neither the name of the product nor the names of its contributors may
|
|
|
be used to endorse or promote products derived from this software
|
|
|
without specific prior written permission.
|
|
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
|
|
|
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
|
EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
|
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
|
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
|
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
|
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
|
