bcrypt Python 库教程

1. 项目目录结构及介绍

在 pyca/bcrypt 开源项目中，目录结构主要如下：

bcrypt/
├── CHANGES.txt           # 更新日志
├── COPYING                # 许可证文件
├── README.rst             # 项目简介
├── benchmarks/            # 性能基准测试
│   └── ...
├── docs/                  # 文档目录
│   ├── conf.py            # Sphinx 配置
│   ├── index.rst          # 主要文档索引
│   └── ...
├── examples/              # 示例代码
│   └── ...
├── tests/                 # 测试套件
│   ├── test_bcrypt.py     # 测试脚本
│   └── ...
└── bcrypt.py              # 核心模块
└── setup.py               # 安装脚本

• CHANGES.txt: 包含项目的版本更新记录。
• README.rst: 提供项目的简要说明和安装指南。
• docs/: 存放项目的文档，包括使用方法和API参考。
• examples/: 提供如何使用库的示例代码。
• tests/: 包含单元测试代码以验证库的功能正确性。
• bcrypt.py: 实现 bcrypt 算法的核心Python模块。
• setup.py: 使用setuptools进行项目安装的脚本。

2. 项目的启动文件介绍

在bcrypt库中，没有传统的"启动文件"，因为这是一个用于加密和验证密码的库。通常，您将在自己的Python应用中导入bcrypt模块来使用其功能。例如，以下是导入并使用bcrypt的基本方式：

import bcrypt

password = "my_password".encode('utf-8')
hashed_password = bcrypt.hashpw(password, bcrypt.gensalt())

if bcrypt.checkpw(password, hashed_password):
    print("Password verified")
else:
    print("Incorrect password")

这里，bcrypt.hashpw() 用于哈希未加密的密码，而 bcrypt.checkpw() 则用来验证密码是否匹配已存储的哈希值。

3. 项目的配置文件介绍

bcrypt库本身并不使用外部配置文件。它的设置主要是通过函数参数完成的。例如，当使用bcrypt.gensalt()创建盐时，可以传递一个工作因子（rounds）来控制哈希的复杂度。更高的rounds值会使哈希过程更慢但更安全。

import bcrypt

# 默认工作因子是12
salt = bcrypt.gensalt()
hashed_password = bcrypt.hashpw(password, salt)

# 自定义工作因子
custom_rounds = 14
custom_salt = bcrypt.gensalt(rounds=custom_rounds)
custom_hashed_password = bcrypt.hashpw(password, custom_salt)

在实际应用中，可能需要将工作因子或其他相关配置参数存储在应用的配置文件或环境变量中，以便根据需要调整安全策略。但这些不是bcrypt库本身提供的功能，而是由使用库的应用程序管理的。