Argon2的Python CFFI低级绑定

argon2-cffi-bindings 提供了对 CFFI 的低级绑定，以及对 Argon2 密码散列算法的绑定，包括它们的一个供应商版本。

目前供应商的 Argon2 提交ID是 f57e61e。

如果您想在应用程序中散列密码，此包不适合您。请查看argon2-cffi，它具有高级抽象！

这些绑定是从 argon2-cffi 中提取的，它仍然是其主要消费者。然而，它们也可能被其他想要使用 Argon2 库而无需处理与 C 相关的复杂性的软件包使用。

使用方法

argon2-cffi-bindings 可在 PyPI 上找到。提供的 CFFI 绑定以 API 模式编译。

尽量为尽可能多的平台提供二进制轮。

禁用供应商代码

默认情况下，会包含并使用 Argon2 的副本，但如果使用以下方式安装 argon2-cffi-bindings，则可以禁用：

$ env ARGON2_CFFI_USE_SYSTEM=1 \
  python -m pip install --no-binary=argon2-cffi-bindings argon2-cffi-bindings

覆盖自动 SSE2 检测

通常，构建过程会尝试猜测是否应该使用SSE2优化的代码（有关详细信息，请参阅_ffi_build.py）。这可能会出错，并且对交叉编译来说是个问题。

因此，您可以使用 ARGON2_CFFI_USE_SSE2 环境变量来控制此过程

• 如果将其设置为 1，argon2-cffi-bindings 将会构建带有 SSE2 支持的版本。
• 如果将其设置为 0，argon2-cffi-bindings 将会构建不带 SSE2 支持的版本。
• 如果您将其设置为其他任何内容，它将被忽略，并且 argon2-cffi-bindings 将尝试猜测。

然而，如果我们的启发式方法失败，我们将欢迎收到一个错误报告。

Python API

由于此包旨在作为实现细节，它使用私有模块名称以防止您的用户意外使用它。

因此，您必须从 _argon2_cffi_bindings 导入符号。

from _argon2_cffi_bindings import ffi, lib

请参阅 cffi 文档 了解如何使用 ffi 和 lib 对象。

提供的符号列表可以在_ffi_build.py 文件中找到。

项目信息

argon2-cffi-bindings 在 PyPI 上可用，受 MIT 许可证保护，源代码和文档可在 GitHub 上找到。

argon2-cffi-bindings 面向 Python 3.6 及以上版本，包括 PyPy3。

致谢与许可证

argon2-cffi-bindings 由 Hynek Schlawack 编写和维护。它根据 MIT 许可证 发布。

开发得到了 Variomedia AG 的慷慨支持。

Argon2 的作者在使库在旧版本的 Visual Studio 上编译以及旧版本的 Python 上非常有帮助。

文档经常直接引用 Argon2 的 论文，以避免在改写时出错。

供应商代码

原始 Argon2 存储库可在 https://github.com/P-H-C/phc-winner-argon2/ 找到。

除下述组件外，此存储库中的 Argon2 代码版权所有（c）2015 Daniel Dinu，Dmitry Khovratovich（主要作者），Jean-Philippe Aumasson 和 Samuel Neves，并受 CC0 许可证保护。

src/encoding.c 中的字符串编码例程版权所有（c）2015 Thomas Pornin，并受 CC0 许可证保护。

src/blake2/ 中的 BLAKE2 代码版权所有（c）Samuel Neves，2013-2015，并受 CC0 许可证保护。