Pywayne Crypto
加密解密工具集，支持对称加密、自定义密码和代码混淆保护。
Quick Start
from pywayne.crypto import encrypt, decrypt
# 基础加密/解密
encrypted = encrypt("Hello World")
decrypted = decrypt(encrypted)
print(decrypted) # 输出: Hello World
# 使用自定义密码加密
encrypted = encrypt("Secret message", "my_password")
decrypted = decrypt(encrypted, "my_password")
print(decrypted) # 输出: Secret message
encrypt - 加密函数
加密字符串或字节数据。
# 文本加密
encrypted = encrypt("机密信息", "password")
# 字节加密
byte_data = b"binary data"
encrypted = encrypt(byte_data, "password")
参数：
| 参数 | 类型 | 说明 |
|---|---|---|
text | str or bytes | 要加密的文本数据或字节数据 |
password | str | 可选，自定义密码。不提供时使用默认密钥 |
返回值：str - base64 编码的加密字符串
参数类型错误处理：
- 当输入不是
str或bytes时抛出ValueError
decrypt - 解密函数
解密之前加密的字符串。
# 解密（使用默认密钥）
decrypted = decrypt(encrypted_text)
# 解密（使用自定义密码）
decrypted = decrypt(encrypted_text, "my_password")
参数：
| 参数 | 类型 | 说明 |
|---|---|---|
encrypted_text | str | 要解密的 base64 编码字符串 |
password | str | 可选，解密密码。必须与加密时使用的密码相同 |
返回值：str - 解密后的原始字符串
批量操作
支持批量加密和解密操作。
from pywayne.crypto import encrypt, decrypt
data = ["数据1", "数据2", "数据3"]
password = "batch_password"
# 批量加密
encrypted_list = encrypt_batch(data, password)
# 批量解密
decrypted_list = decrypt_batch(encrypted_list, password)
参数：
| 函数 | 参数 | 说明 |
|---|---|---|
encrypt_batch(data_list, password) | data_list: 数据列表 | password: 密码 |
decrypt_batch(encrypted_list, password) | encrypted_list: 加密数据列表 | password: 密码 |
返回值：list[str] - 解密结果列表（失败项目为 None）
配置文件管理
保存和加载加密配置文件（JSON 格式）。
from pywayne.crypto import encrypt, decrypt
# 保存配置
config = {"database": {"host": "localhost", "username": "admin", "password": "secret"}}
save_config(config, "master_password", "config.enc")
# 加载配置
loaded_config = load_config("master_password", "config.enc")
print(loaded_config) # 输出: {'database': {...}}
参数：
| 函数 | 参数 | 说明 |
|---|---|---|
save_config(config_dict, password, filename) | config_dict: 配置字典 | password: 加密密码 |
load_config(password, filename) | password: 解密密码 | filename: 配置文件名 |
异常：
ValueError：配置文件解密失败（密码错误或数据损坏）
加密策略
模块采用分层加密策略，优先使用 Fernet，回退到 XOR。
| 策略 | 说明 | |------|------|------| | Fernet 加密（推荐） | AES-128 对称加密，带消息完整性验证 | | XOR 加密（回退） | 简单异或加密，无依赖，基本功能 | | 代码混淆保护 | Base64 编码隐藏、动态函数生成、命名空间清理 |
错误处理
完善的异常处理机制，支持密码错误、数据格式错误、解密失败等情况。
# 密码错误
try:
decrypted = decrypt(encrypted_text, "wrong_password")
except ValueError:
print("错误: 解密失败，密码不正确")
# 数据格式错误
try:
encrypted = encrypt(123)
except ValueError:
print("错误: 输入类型必须是字符串或字节")
最佳实践
- 密码妥善保管，避免硬编码在源码中
- 高安全性要求的应用使用专业加密库
- 密钥通过环境变量传递，避免写入日志